Mac, iPhone 및 iPad용 DuckDB 클라이언트
DuckDB 데이터베이스 파일을 열거나 Parquet, CSV, JSON 파일을 지정해 그대로 SQL로 쿼리합니다. DuckDB는 드라이버 안에서 실행되므로 서버에 연결하지 않는 한 서버는 실행되지 않습니다.
Mac, iPhone 및 iPad에서 사용 가능처음 DuckDB을 선택하면 드라이버 다운로드


한눈에 보기
- 쿼리 언어
- SQL
- 드라이버
- 처음 사용할 때 다운로드
- 연결 방식
- 파일
- 내장 엔진
- DuckDB 1.5.2
- iPhone과 iPad
- 열림
파일 열기
.duckdb나 .ddb 파일을 선택하거나 아직 없는 경로를 입력해 만듭니다. :memory:를 입력하면 세션 동안만 유지되는 데이터베이스가 됩니다. DuckDB는 첫 바이트에 파일을 표시하므로 파일 이름과 관계없이 DuckDB로 열립니다.
.parquet, .csv, .tsv, .json 또는 .ndjson 파일을 선택하면 메모리 데이터베이스의 읽기 전용 뷰로 열립니다. 하나는 file, 다른 하나는 파일 이름으로 지정됩니다. 디스크 파일은 바이트 단위까지 그대로 유지됩니다. 내용을 바꾸려면 .duckdb 데이터베이스에 파일로부터 테이블을 만드세요.
Finder에서 .duckdb 파일을 더블 클릭하면 여기서 열립니다. Parquet 파일의 다음으로 열기에 TablePro가 표시되며 File > Open File로 선택한 Parquet는 Data Files 창이 아니라 DuckDB 연결로 열립니다.
Remote (Quack, experimental)은 quack_serve로 시작한 DuckDB 서버에 연결해 remotedb 같은 별칭으로 연결하며 그 별칭을 통해 테이블 이름으로 접근합니다. 첫 원격 연결은 DuckDB에서 quack 확장을 다운로드합니다.
쿼리 및 편집
모든 연결에서 SELECT * FROM 'data.csv'나 read_parquet('events.parquet')처럼 SQL로 파일을 직접 읽을 수 있습니다. 다른 DuckDB 파일을 ATTACH하면 사이드바에 두 번째 데이터베이스로 나타나고 Cmd+K로 재연결 없이 전환합니다. 재연결 후에는 연결한 데이터베이스가 유지되지 않습니다.
EXPLAIN은 계획 다이어그램으로 표시됩니다. 테이블 행을 편집할 때 Preview SQL이 각 구문을 먼저 보여 주며 데이터 파일의 뷰는 읽기 전용입니다.
구조
Structure 탭은 테이블을 편집하고 실행 전에 DDL을 보여 줍니다. 여기서 데이터베이스는 파일이므로 앱에서 생성·삭제하지 않으며 두 번째 파일에 접근하려면 ATTACH를 사용합니다.
파일 공유 및 백업
TablePro가 파일을 잡고 있으면 duckdb CLI, 노트북이나 dbt 실행이 열 수 없습니다. Release the File Lock After로 몇 분간 유휴 상태 후 파일을 반환하고 다음 쿼리에서 다시 잡거나 Open the File Read-Only로 여러 읽기 프로세스가 공유하게 합니다. Database > Release File Lock는 탭을 유지하며 즉시 반환합니다. 열린 트랜잭션, 임시 테이블, 연결된 데이터베이스 또는 변경 설정을 세션이 보유하면 이유를 표시하며 해제를 거부합니다.
Server Dashboard는 데이터베이스 크기, 블록 크기, 총 블록 수, 메모리 제한과 스레드를 보여 줍니다.
Backup Dump는 DuckDB이 열린 연결로 기록하므로 설치가 필요 없습니다. 나중에 TablePro에서 복원할 .duckdb 파일이나 schema.sql, load.sql과 테이블별 Parquet 파일 폴더를 선택하며 pandas, Spark와 BigQuery가 직접 읽습니다. Restore Dump는 이름이 이미 사용 중인 첫 객체에서 중단합니다.
데이터 이동
가져오기는 CSV, TSV, JSON, JSONL, XLSX 및 SQL 파일을 지원하며 테이블과 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보냅니다. Settings > Plugins에서 설치하는 Parquet 내보내기 플러그인은 테이블당 파일 하나를 기록합니다. 파일을 데이터베이스로 다루는 방법도 참고하세요.
iPhone과 iPad
iPhone과 iPad 앱에서 연결을 만들 때 DuckDB을 선택할 수 있으며 앱이 직접 연결합니다.
iPhone과 iPad 앱에 DuckDB가 포함됩니다. 파일 앱에서 선택한 파일은 복사본이 아니라 원래 위치에서 열리며 작업용 데이터베이스는 In-Memory를 선택합니다. 테이블을 카드로 탐색하고 Query 탭에서 SQL을 실행합니다. Remote (Quack) 연결은 Mac 전용입니다.
제한 사항
- 연결이 열린 동안 DuckDB 파일에는 한 번에 하나의 프로세스만 쓸 수 있습니다.
- 드라이버에는 핵심 함수, JSON, Parquet, ICU 및 자동 완성 확장이 포함됩니다. httpfs 같은 나머지 확장은 쿼리에서 처음 필요할 때 DuckDB에서 다운로드합니다.
- Quack을 통한 원격 연결은 실험적입니다.
DuckDB 관련 질문
어떤 DuckDB 버전을 사용하나요?
드라이버에 컴파일된 DuckDB 1.5.2입니다. 따로 설치한 DuckDB에 의존하지 않습니다.
CSV는 DuckDB와 Data Files 창 중 어디서 열어야 하나요?
살펴보고 정리하고 다시 저장하려면 Data Files 창에서 여세요. SQL로 다른 파일이나 테이블과 조인하려면 DuckDB로 열며 이때 파일은 읽기 전용입니다.
TablePro 다운로드
macOS 13 Ventura 이상 필요