neilotoole/sq

어떤 프로젝트인가요?

핵심 기능

• 01jq 스타일 문법이나 네이티브 SQL로 데이터 소스를 조회합니다.
• 02CSV와 Postgres처럼 서로 다른 소스의 테이블을 조인합니다.
• 03결과를 JSON, CSV, XLSX, HTML, Markdown, XML 등으로 내보냅니다.
• 04소스 메타데이터를 확인하고 스키마나 행 데이터를 비교합니다.
• 05SQL 데이터베이스 소스의 테이블을 복사하거나 비우거나 삭제합니다.

활용 사례

• 임시 분석을 위해 Excel 시트나 CSV 내보내기 파일을 프로덕션 데이터베이스 테이블과 조인합니다.
• 터미널에서 낯선 SQLite 또는 Postgres 데이터베이스를 살펴봅니다.
• 셸 파이프라인에서 스프레드시트나 CSV를 JSON 또는 다른 형식으로 변환합니다.
• 두 데이터베이스 환경의 스키마나 데이터를 비교합니다.

빠른 시작

1. 1

   Homebrew로 macOS에 설치

   brew install sq
2. 2

   Scoop으로 Windows에 설치 (먼저 bucket을 추가하세요)

   scoop bucket add sq https://github.com/neilotoole/sq
3. 3

   Go로 설치 (SQLite build tags가 필요합니다)

   go install -tags "sqlite_vtable sqlite_stat4 sqlite_fts5 sqlite_introspect sqlite_json sqlite_math_functions" github.com/neilotoole/sq@latest
4. 4

   README에 있는 Linux용 공식 설치 스크립트 실행

사용 전 알아둘 점

• !Linux 설치는 다운로드한 셸 스크립트를 사용합니다. 또한 Go로 설치하면 clone한 저장소에서 make install로 빌드하지 않는 한 버전이 v0.0.0-dev로 표시됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

sq은(는) 무엇인가요?

CSV, Excel, JSON 같은 파일과 SQL 데이터베이스를 jq 스타일 또는 SQL 문법으로 조회하고 조인하는 CLI 도구입니다. sq는 SQL 데이터베이스와 CSV, TSV, JSON, Excel XLSX 같은 문서 파일을 조회 가능한 데이터 소스로 다루는 CLI 도구입니다. 각 소스에 핸들을 지정해 추가한 뒤, jq 스타일 쿼리 언어나 네이티브 SQL로 명령을 실행합니다.

sq은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

sq은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

sq은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. sq의 마지막 커밋은 2026년 10월 21일입니다.

sq은(는) 어디에 사용할 수 있나요?

임시 분석을 위해 Excel 시트나 CSV 내보내기 파일을 프로덕션 데이터베이스 테이블과 조인합니다. 터미널에서 낯선 SQLite 또는 Postgres 데이터베이스를 살펴봅니다. 셸 파이프라인에서 스프레드시트나 CSV를 JSON 또는 다른 형식으로 변환합니다. 두 데이터베이스 환경의 스키마나 데이터를 비교합니다.

sq는 어떻게 설치하나요?

Homebrew로 macOS에 설치: brew install sq Scoop으로 Windows에 설치 (먼저 bucket을 추가하세요): scoop bucket add sq https://github.com/neilotoole/sq Go로 설치 (SQLite build tags가 필요합니다): go install -tags "sqlite_vtable sqlite_stat4 sqlite_fts5 sqlite_introspect sqlite_json sqlite_math_functions" github.com/neilotoole/sq@latest README에 있는 Linux용 공식 설치 스크립트 실행

sq은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/neilotoole/sq