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 で選ぶと 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 エクスポートプラグイン はテーブルごとに一つの Parquet ファイルを出力します。ファイルをデータベースとして扱う方法も参照してください。
iPhone と iPad
iPhone と iPad アプリで接続を作成するときに DuckDB を選べ、アプリから直接接続できます。
iPhone と iPad では DuckDB がアプリに組み込まれています。ファイル App で選んだファイルはコピーではなく元の場所で開きます。作業用データベースには In-Memory を選べます。カードでテーブルを閲覧し、Query タブで SQL を実行します。Remote (Quack) 接続は Mac 専用です。
制限
- 接続が開いている間、DuckDB ファイルへの書き込みは同時に 1 プロセスのみです。
- ドライバはコア機能、JSON、Parquet、ICU、自動補完の拡張機能を含みます。httpfs などのその他の拡張機能は、クエリで初めて必要になったときに DuckDB からダウンロードします。
- Quack 経由のリモート接続は実験的な機能です。
DuckDB に関する質問
どの DuckDB バージョンを使いますか?
ドライバーにコンパイルした DuckDB 1.5.2 です。自分でインストールした DuckDB には依存しません。
CSV は DuckDB と Data Files ウィンドウのどちらで開くべきですか?
閲覧、整理して書き戻すには Data Files ウィンドウ で開いてください。SQL で他のファイルやテーブルと JOIN するには DuckDB として開きます。その場合ファイルは読み取り専用です。
TablePro を入手
macOS 13 Ventura 以降 が必要です