---
title: "DuckDB UI と DuckLocal：ローカルの DuckDB インターフェースはどちらを使うべきか"
description: "DuckDB UI はブラウザーのノートブック、DuckLocal はデスクトップのワークスペースです。両者の違い、DuckDB UI を選ぶべき場面、そして DuckLocal の中で CALL start_ui() で開く方法を説明します。"
language: "ja"
---

# DuckDB UI と DuckLocal：どちらを使うべきか？

どちらも DuckDB にローカルのインターフェースを載せるツールです。ひとつはどの DuckDB プロセスからでも開けるブラウザーノートブック、もうひとつはあなたのファイルを中心に組み立てられたデスクトップワークスペースです。2 つは異なるニーズに応えるもので、片方をもう片方の中で動かすこともできます。

![DuckDB UI と DuckLocal。ノートパソコンの前にいる DuckLocal のアヒル](https://ducklocal.app/assets/blog/duckdb-ui-vs-ducklocal-cover.webp)

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 の発表](https://duckdb.org/2025/03/12/duckdb-ui) · [UI 拡張機能のドキュメント](https://duckdb.org/docs/current/core_extensions/ui.html) · [GitHub の duckdb/duckdb-ui](https://github.com/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` ファイル](https://ducklocal.app/docs/ja/dashboards)がそのクエリ、プロット、フィルターをテキストで記述します。diff も、プルリクエストでのレビューも、`ducklocal check` での検証もできます。

### AI エージェントと一緒に作業する場合

[`ducklocal` CLI](https://ducklocal.app/ja/use-cases/ai-agent-sql/) は、スキーマを先に見る単一ステートメントの SQL ワークフローを、境界付きの JSON 出力でエージェントに与えます。ダッシュボードのコメントを使えば、特定のグラフについての質問をエージェントに渡せます。同じファイルがアプリでも開いているので、その仕事を自分で確認できます。

## 6. DuckLocal の中で DuckDB UI を動かす

どちらかを選ぶ必要はありません。DuckDB UI は拡張機能で、DuckLocal は DuckDB の拡張機能を読み込めます。つまり UI は、DuckLocal 自身の DuckDB インスタンスの上で動きます:

- DuckLocal のサイドバーで **拡張機能** タブを開きます。

- `ui` の行の **インストール** をクリックし、次に **読み込み** をクリックします。DuckLocal が勝手に拡張機能をインストールすることはないので、この手順は意図して行うものです。

- クエリタブで次を実行します:

```text
CALL start_ui();
```

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

![読み込み済みと表示された ui 拡張機能がある DuckLocal の拡張機能タブ。隣には「データをドロップ」のスタート画面](https://ducklocal.app/assets/blog/ducklocal-extensions-ui.webp)

*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 を開く](https://ducklocal.app/docs/ja/schema-and-history#duckdb-ui) · [拡張機能タブ](https://ducklocal.app/docs/ja/schema-and-history#extensions)

## 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 はあなたのマシン上でクエリを実行します。

## 関連リンク

- [DuckDB のローカル UI（DuckDB ブログ）](https://duckdb.org/2025/03/12/duckdb-ui)

- [UI 拡張機能のドキュメント](https://duckdb.org/docs/current/core_extensions/ui.html)

- [DuckLocal でローカルデータを分析する](https://ducklocal.app/ja/use-cases/local-data-analysis/)

- [Claude Dashboards から学んだ DuckLocal のこと](https://ducklocal.app/ja/blog/claude-dashboards-ducklocal/)

[← すべての記事](https://ducklocal.app/ja/blog/)

Source: https://ducklocal.app/ja/blog/duckdb-ui-vs-ducklocal/
