2025 年 3 月、DuckDB 1.2.1 が DuckDB UI とともにリリースされました。duckdb -ui を実行すると、手元のマシン上の DuckDB プロセスをバックエンドにして、ブラウザーでノートブックが開きます。それ以来、DuckLocal について最もよく受ける質問は、多かれ少なかれ「なぜ DuckDB UI をそのまま使わないのか」というものです。
もっともな疑問です。どちらのツールも DuckDB をローカルで動かし、自分で管理するサーバーも要らず、クエリもデータも手元のコンピューターに置かれます。ただ、出発点が違っていて、その違いがどの作業にどちらが合うかを決めます。この記事は、その違いを正直に書き出そうとする私なりの試みです。私自身が DuckDB UI を選ぶ場面も含めて。
1. まず結論から
| こんなときは… | 使うもの |
|---|---|
| DuckDB CLI や Python ですでに作業していて、そのセッションを視覚的に眺めたい | DuckDB UI |
| SQL セルのノートブックという形で考える | DuckDB UI |
| MotherDuck を使っている、または MotherDuck 経由で結果を共有したい | DuckDB UI |
| CSV、Parquet、JSON、Excel のファイルやフォルダーが山ほどあるところから始めたい | DuckLocal |
| オフラインで作業したい、あるいはツールのすべてがインストールされレビュー可能であってほしい | DuckLocal |
| グラフやダッシュボードをファイルとして保存し、git で管理したい | DuckLocal |
| ターミナルから AI エージェントに同じデータをクエリさせたい | DuckLocal |
| 両方を同じデータで使いたい | DuckLocal、そして CALL start_ui(); |
2. DuckDB UI とは
DuckDB UI は MotherDuck が開発・保守しているもので、ui という DuckDB 拡張機能として提供されます。ターミナルから duckdb -ui で起動するか、任意の DuckDB クライアント(CLI、Python、Java など)から CALL start_ui(); を呼び出して起動します。
この拡張機能は、呼び出した DuckDB プロセスの内部で localhost(既定ではポート 4213)に HTTP サーバーを立て、ブラウザーを開きます。UI はそのプロセスと直接やり取りするため、プロセスに見えているものはすべて見えます。アタッチされたデータベース、メモリ、そしてローカルのファイルです。
ブラウザーで使えるもの:
- ノートブック — 名前を付けて保存できる SQL セルの集まりで、シンタックスハイライトと自動補完があります。1 つのセルに複数のステートメントを書けます。
- アタッチされたデータベースのブラウザーとテーブルのサマリー。行数、列、型、そして列ごとのプロファイルが見られます。
- Column Explorer — 結果を要約し、各列を掘り下げて見られる機能です。
- 任意の MotherDuck サインイン — テーブルを MotherDuck のクラウドウェアハウスに保存して共有できます。オプトイン方式で、既定では何もマシンの外に出ません。
比較のために押さえておきたい点が 2 つあります。ひとつは、拡張機能のローカルサーバーが UI 自身のフロントエンドファイルを https://ui.duckdb.org から取得することです。インターフェースを最新に保つためですが、クエリは引き続きローカルで実行されるものの、UI 自体はネットワークから読み込まれます。公開時点ではオフライン利用はサポートされていませんでした。もうひとつは、拡張機能は MIT ライセンスである一方、公開時点ではフロントエンドのソースは公開されていませんでした。
出典: DuckDB UI の発表 · UI 拡張機能のドキュメント · GitHub の duckdb/duckdb-ui。この記事の執筆後に加わった変更は、これらのリンクで確認してください。
3. 項目ごとの比較
| 項目 | DuckDB UI | DuckLocal |
|---|---|---|
| 何であるか | DuckDB の ui 拡張機能が提供するブラウザーノートブック | DuckDB を組み込んだネイティブのデスクトップアプリ |
| 起動方法 | 任意の DuckDB クライアントから duckdb -ui または CALL start_ui();(1.2.1 以降) | アプリを開く、または ducklocal ./data/ を実行する |
| クエリの実行場所 | 起動した DuckDB プロセス内、あなたのマシン上 | DuckLocal に組み込まれた DuckDB 内、あなたのマシン上 |
| インターフェースのファイル | ローカルサーバーが ui.duckdb.org から取得する | アプリに同梱されている |
| オフライン | UI のファイル取得にネットワークが必要 | オフラインで動作する。ネットワークを使うのは S3、地図タイル、拡張機能のインストール、そして有効にした場合の更新確認だけ |
| データの取り込み | SQL: read_csv、ATTACH、またはセッションがすでに持っているもの | ファイル、フォルダー、glob パターンをドラッグするだけ。ビューになり、次回起動時にも残る |
| 作業のしかた | SQL セルのノートブック | クエリタブ、スキーマのサイドバー、履歴、EXPLAIN、プロファイラー |
| 結果の探索 | テーブルのサマリーと Column Explorer | 結果グリッド、列ごとの概要タブ、組み込みのグラフ |
| 再利用と共有 | 保存したノートブック。任意で MotherDuck による共有 | レビューできて git で管理できるテキストの .dash ダッシュボード。プロットにコメントも付けられる |
| AI エージェント | 主眼ではない | 境界付き JSON を返す ducklocal CLI と公式のエージェントスキル |
| ソース | 拡張機能は MIT。フロントエンドは公開時点で未公開 | Apache-2.0。アプリとソースは GitHub に |
| 対応プラットフォーム | DuckDB が動くところ(windows_arm64 を除く) | Apple silicon の macOS、Windows x64、Linux x86_64 |
いちばん短く言うならこうです。DuckDB UI は、すでに持っている DuckDB セッションをのぞく窓です。DuckLocal はそのセッションそのもので、見たいファイルを中心に組み立てられています。
4. DuckDB UI を選ぶ場面
DuckDB がすでに作業の場になっている場合
作業が DuckDB CLI や Python スクリプトの中で起きているなら、UI はコマンド 1 つで開けて、新しいアプリも要りません。duckdb -ui my.duckdb を実行するか、すでにデータを読み込んで変換した Python プロセスから start_ui() を呼べば、その状態をそのまま見られます。DuckLocal は別のプロセスの内側を見ることはできませんが、UI はそのために設計されています。
ノートブックという形で考える場合
分析の中には、順番を保ちたい長い手順の連なりになるものがあります。読み込み、整形、結合、確認、集計。名前を付けて保存するセルを持つノートブックは、そういう作業によく合いますし、1 つのセルで複数のステートメントをまとめて実行できます。DuckLocal のクエリタブは、長い物語を保つことよりも、独立した多くの問いを投げかけるのに向いています。
MotherDuck を使っている場合
チームがすでに MotherDuck でデータを共有しているなら、UI は自然なフロントエンドです。サインインすれば、同じノートブックからローカルの DuckDB とクラウドのウェアハウスの両方に届きます。DuckLocal にはクラウドサービスはなく、作る予定もありません。
DuckLocal にお使いのマシン向けのビルドがない場合
DuckLocal は Apple silicon の macOS、Windows x64、Linux x86_64 向けに提供されています。たとえば Intel Mac では、DuckLocal をソースからビルドする必要があります。一方 DuckDB UI は、DuckDB が動く場所ならどこでも動きます(ARM 版 Windows を除く)。
5. DuckLocal を選ぶ場面
SQL ではなくファイルから始める場合
CSV、Parquet ファイルのフォルダー、あるいは ./logs/2026-*/*.json のようなパターンをドラッグすれば、それぞれがクエリできるビューになり、その列がサイドバーに並びます。Excel ブックの空でないシートは、それぞれテーブルになります。まず read_csv(…) と書く必要はなく、次にアプリを開いたときもファイルはそのまま残っています。
オフラインで動かしたい、あるいはすべてをレビュー可能にしたい場合
DuckLocal のインターフェースは、インストールしたアプリの一部です。実行時にインターフェースのコードを読み込むことも、勝手に拡張機能をダウンロードすることもなく、更新確認も有効にするまでオフです。対して DuckDB UI のフロントエンドは起動のたびに取得され、DuckDB に読み込まれたデータを読むことができます。DuckDB のドキュメント自身が、信頼できる URL にだけ向けるよう勧めています。ほとんどの人には問題ありません。セキュリティレビュー、監査、規制対象のデータ、エアギャップ環境では、「すべてがインストールされ、オープンソースである」ことのほうが強い保証になります。
グラフやダッシュボードをファイルとして持ちたい場合
結果はその場で棒グラフ、折れ線グラフ、散布図、円グラフ、地図のグラフに変わります。残しておく価値のあるビューは、.dash ファイルがそのクエリ、プロット、フィルターをテキストで記述します。diff も、プルリクエストでのレビューも、ducklocal check での検証もできます。
AI エージェントと一緒に作業する場合
ducklocal CLI は、スキーマを先に見る単一ステートメントの SQL ワークフローを、境界付きの JSON 出力でエージェントに与えます。ダッシュボードのコメントを使えば、特定のグラフについての質問をエージェントに渡せます。同じファイルがアプリでも開いているので、その仕事を自分で確認できます。
6. DuckLocal の中で DuckDB UI を動かす
どちらかを選ぶ必要はありません。DuckDB UI は拡張機能で、DuckLocal は DuckDB の拡張機能を読み込めます。つまり UI は、DuckLocal 自身の DuckDB インスタンスの上で動きます:
- DuckLocal のサイドバーで 拡張機能 タブを開きます。
uiの行の インストール をクリックし、次に 読み込み をクリックします。DuckLocal が勝手に拡張機能をインストールすることはないので、この手順は意図して行うものです。- クエリタブで次を実行します:
CALL start_ui();
ブラウザーで http://localhost:4213 の DuckDB UI が開きます。DuckLocal が動かしている DuckDB インスタンスに接続されるので、DuckLocal で開いたファイルをノートブックからそのまま使えます。
ui 拡張機能を読み込んだ状態。ここから CALL start_ui(); を実行すると、同じ DuckDB インスタンスで DuckDB UI が開きます。知っておくとよい点がいくつかあります:
- ネットワークが必要です:
uiのインストール時に 1 回、そして起動のたびに、ui.duckdb.orgから UI のファイルを取得するために必要です。 - DuckLocal とともに終わります。 DuckLocal を終了すると、その DuckDB インスタンスと UI サーバーも閉じます。
CALL stop_ui_server();で早めに止められ、CALL start_ui_server();ならブラウザーを開かずに起動できます。 - ノートブックは拡張機能に属します。 保存先は
~/.duckdb/extension_data/ui/です。DuckLocal のクエリ履歴には、UI で実行した内容は含まれません。 - 読み取り専用のデータベースでは直接動かせません。 そのデータベースは、ノートブックから
ATTACH '…' (READ_ONLY)でアタッチしてください。
私が両者を一緒に使うときはこうです。DuckLocal でデータを開き、列を眺め、明らかな疑問をグラフにします。ひとつの問いが、ノートブックとして残しておきたい長い調査に変わったら、DuckDB UI の出番です。
ドキュメント: DuckLocal から DuckDB UI を開く · 拡張機能タブ
7. よくある質問
DuckDB UI と DuckLocal の違いは何ですか?
DuckDB UI は、DuckDB の ui 拡張機能が、起動した DuckDB プロセスから提供するブラウザーノートブックです。DuckLocal は DuckDB を組み込んだネイティブのデスクトップアプリで、ファイルやフォルダーを開くこと、グラフ、テキストのダッシュボード、AI エージェント向けの CLI を中心に作られています。どちらもクエリをローカルで実行します。
DuckLocal は DuckDB UI の代わりになりますか?
いいえ。ローカルのデータに対して SQL を実行する点では重なりますが、UI は既存の DuckDB セッションをのぞく窓として、DuckLocal はファイルのためのワークスペースとして最適です。UI は DuckLocal の中で動くので、両方を使えます。
DuckDB UI はオフラインで動きますか?
クエリはローカルで実行されますが、UI のフロントエンドファイルは起動のたびに ui.duckdb.org から取得されるため、ネットワークアクセスが必要です。DuckLocal のインターフェースはアプリに同梱され、オフラインでも動きます。
クエリが MotherDuck に送られることはありますか?
UI で MotherDuck にサインインしない限りありません。既定では、DuckLocal と同じく、DuckDB UI はあなたのマシン上でクエリを実行します。