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 UIDuckLocal
何であるか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 インスタンスの上で動きます:

  1. DuckLocal のサイドバーで 拡張機能 タブを開きます。
  2. ui の行の インストール をクリックし、次に 読み込み をクリックします。DuckLocal が勝手に拡張機能をインストールすることはないので、この手順は意図して行うものです。
  3. クエリタブで次を実行します:
CALL start_ui();

ブラウザーで http://localhost:4213 の DuckDB UI が開きます。DuckLocal が動かしている DuckDB インスタンスに接続されるので、DuckLocal で開いたファイルをノートブックからそのまま使えます。

読み込み済みと表示された ui 拡張機能がある DuckLocal の拡張機能タブ。隣には「データをドロップ」のスタート画面
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 はあなたのマシン上でクエリを実行します。

関連リンク

← すべての記事