DuckDB クライアント
DuckDB データベースを開くか、Parquet、CSV、JSON ファイルを SQL でクエリできます。データベースサーバーを動かす必要はありません。
概要
- クエリ言語
- SQL
- ドライバー
- 初回使用時にダウンロード
- 接続方法
- ファイル
- 組み込みエンジン
- DuckDB 1.5.2


ファイルを開く
.duckdb または .ddb ファイルを開くか(Finder からも開けます)、新しいパスを入力して作成します。:memory: は一時データベースです。ファイルは拡張子ではなくヘッダーで識別します。
Parquet、CSV、TSV、JSON、NDJSON は File > Open File で、file とファイル名に基づく名前の読み取り専用ビューとして開きます。元のファイルは変更しません。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 なら複数の読み取り側で共有でき、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 に接続できます。
iPhone と iPad では DuckDB がアプリに組み込まれています。ファイル App で選んだファイルはコピーではなく元の場所で開き、In-Memory で作業用データベースを使えます。テーブルはカードで閲覧し、Query タブで SQL を実行します。
制限
- 接続が開いている間、DuckDB ファイルへの書き込みは同時に 1 プロセスのみです。
- ドライバーはコア機能、JSON、Parquet、ICU、自動補完の拡張機能を含みます。httpfs などのその他の拡張機能は、クエリで初めて必要になったときに DuckDB からダウンロードします。
- Quack 経由のリモート接続は実験的な機能です。
どの DuckDB バージョンを使いますか?
ドライバーにコンパイルした DuckDB 1.5.2 です。自分でインストールした DuckDB には依存しません。
CSV ファイルは DuckDB と Data Files ウィンドウのどちらで開くべきですか?
ファイルを閲覧し、整理して保存し直すには Data Files ウィンドウを使います。SQL で他のファイルやテーブルと結合するには DuckDB として開きます。その場合ファイルは読み取り専用です。