本文へスキップ

DuckDB クライアント

DuckDB データベースを開くか、Parquet、CSV、JSON ファイルを SQL でクエリできます。データベースサーバーを動かす必要はありません。

概要

クエリ言語
SQL
ドライバー
初回使用時にダウンロード
接続方法
ファイル
組み込みエンジン
DuckDB 1.5.2
DuckDB データベースを開いた Mac 上の TablePro。Parquet ファイルを SQL でクエリしています。

ファイルを開く

.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 を実行します。

    iPhone・iPad 版 TablePro

  • 制限

    • 接続が開いている間、DuckDB ファイルへの書き込みは同時に 1 プロセスのみです。
    • ドライバーはコア機能、JSON、Parquet、ICU、自動補完の拡張機能を含みます。httpfs などのその他の拡張機能は、クエリで初めて必要になったときに DuckDB からダウンロードします。
    • Quack 経由のリモート接続は実験的な機能です。
  • どの DuckDB バージョンを使いますか?

    ドライバーにコンパイルした DuckDB 1.5.2 です。自分でインストールした DuckDB には依存しません。

  • CSV ファイルは DuckDB と Data Files ウィンドウのどちらで開くべきですか?

    ファイルを閲覧し、整理して保存し直すには Data Files ウィンドウを使います。SQL で他のファイルやテーブルと結合するには DuckDB として開きます。その場合ファイルは読み取り専用です。

TablePro を入手

このページの機能はすべて無料です。