本文へスキップ

毎日 TablePro をお使いですか?ライセンスで有料機能が使え、次のリリースを支えられます。 ライセンスを購入ライセンスで TablePro を支援

Mac、iPhoneとiPad 用 DuckDB クライアント

DuckDB データベースファイルを開くか、Parquet、CSV、JSON ファイルを指定して、その場で SQL クエリを実行できます。DuckDB はドライバー内で動き、サーバーに接続しない限りサーバープロセスは動きません。

Mac、iPhoneとiPad で使用可能初めて DuckDB を選ぶとドライバーをダウンロード

DuckDB で読み取り専用ビューとして開いた Parquet ファイルと、それに対する SQL クエリおよび結果。

概要

クエリ言語
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 専用です。

iPhone と iPad 用 TablePro

制限

  • 接続が開いている間、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 を入手

Mac アプリは無料でダウンロードして使えます。Starter や Team プランは任意の機能を追加します。 iPhone と iPad アプリは App Store で入手できます。
Mac 版をダウンロード

macOS 13 Ventura 以降 が必要です

App Store からダウンロード

無料、アプリ内課金なしiOSとiPadOS 18 以降 が必要です