본문으로 건너뛰기

DuckDB 클라이언트

DuckDB 데이터베이스를 열거나 Parquet, CSV, JSON 파일을 SQL로 조회하세요. 실행할 데이터베이스 서버가 필요 없습니다.

한눈에 보기

쿼리 언어
SQL
드라이버
처음 사용할 때 다운로드
연결 방식
파일
내장 엔진
DuckDB 1.5.2
DuckDB 데이터베이스를 연 Mac의 TablePro. SQL로 Parquet 파일을 조회합니다.

파일 열기

Finder에서도 .duckdb 또는 .ddb 파일을 열 수 있습니다. 새 경로를 입력해 파일을 만들거나, 임시 데이터베이스에는 :memory:를 사용하세요. 파일은 확장자가 아닌 헤더로 식별됩니다.

Parquet, CSV, TSV, JSON, NDJSON은 파일 > 파일 열기 (File > Open File)로 file과 파일 이름으로 된 읽기 전용 뷰로 열리며, 원본 파일은 바뀌지 않습니다. 원격(Quack, 실험적) (Remote (Quack, experimental))은 별칭으로 quack_serve 서버에 연결하며, 첫 연결에서 DuckDB의 quack 확장을 다운로드합니다.

쿼리 및 편집

SELECT * FROM 'data.csv'처럼 파일을 직접 조회하세요. ATTACH는 다른 DuckDB 파일을 사이드바에 추가하며, 다음 재연결 전까지 ⌘K로 전환할 수 있습니다. EXPLAIN은 계획 다이어그램으로 그려집니다.

테이블 행은 편집할 수 있지만 데이터 파일의 뷰는 읽기 전용입니다. 데이터를 편집하려면 DuckDB 데이터베이스에 테이블을 만드세요. 데이터베이스 생성이나 삭제 기능은 없으며, 파일을 만들려면 연결할 때 새 경로를 입력하세요.

파일 공유 및 백업

TablePro가 파일을 잡고 있는 동안에는 duckdb CLI, 노트북, dbt 실행이 파일을 열 수 없습니다. Release the File Lock After는 몇 분간 유휴 상태가 되면 파일을 반환하고 다음 쿼리에서 다시 잡으며, Open the File Read-Only는 여러 읽기 프로세스가 파일을 공유하게 하고, 데이터베이스 > Release File Lock (Database > Release File Lock)은 즉시 반환합니다. 세션이 트랜잭션, 임시 테이블, 연결된 데이터베이스, 변경된 설정을 보유하고 있으면 이유를 표시하며 해제를 거부합니다.

Backup Dump는 DuckDB이 열린 연결로 기록하므로 설치가 필요 없습니다. 나중에 복원할 .duckdb 파일이나, schema.sql, load.sql과 테이블별 Parquet 파일이 담긴 폴더를 작성하며, pandas, Spark, BigQuery가 이 폴더를 직접 읽습니다.

이 페이지는 DuckDB에만 해당하는 내용을 다룹니다. Safe Mode, AI 도우미, MCP 서버 등 TablePro의 나머지 기능은 기능 페이지에서 볼 수 있습니다.

그 밖에

  • 데이터 이동

    CSV, TSV, JSON, JSONL, XLSX 및 SQL 파일을 가져오고 테이블과 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보내세요. Settings > Plugins에서 설치하는 Parquet 내보내기 플러그인은 테이블당 파일 하나로 Parquet 출력을 추가합니다.

  • iPhone과 iPad

    iPhone과 iPad 앱은 DuckDB에 연결합니다.

    DuckDB가 앱에 포함되어 있습니다. 파일 앱에서 선택한 파일은 복사본이 아니라 원래 위치에서 열리며, In-Memory는 작업용 데이터베이스를 제공합니다. 테이블을 카드로 탐색하고 Query 탭에서 SQL을 실행합니다.

    iPhone 및 iPad용 TablePro

  • 제한 사항

    • 연결이 열린 동안 DuckDB 파일에는 한 번에 하나의 프로세스만 쓸 수 있습니다.
    • 드라이버에는 핵심 함수, JSON, Parquet, ICU 및 자동 완성 확장이 포함됩니다. httpfs 같은 나머지 확장은 쿼리에서 처음 필요할 때 DuckDB에서 다운로드합니다.
    • Quack을 통한 원격 연결은 실험적입니다.
  • 어떤 DuckDB 버전을 사용하나요?

    드라이버에 컴파일된 DuckDB 1.5.2입니다. 따로 설치한 DuckDB에 의존하지 않습니다.

  • CSV 파일은 DuckDB와 Data Files 창 중 어디서 열어야 하나요?

    파일을 살펴보고 정리한 뒤 다시 저장하려면 Data Files 창을 사용하세요. SQL로 다른 파일이나 테이블과 조인하려면 DuckDB로 여세요. 이때 파일은 읽기 전용입니다.

TablePro 받기

이 페이지의 모든 기능은 무료입니다.