---
title: "プレーンテキストファイルで作るローカル SQL ダッシュボード | DuckLocal"
description: "DuckDB のダッシュボードをプレーンテキストの .dash ファイルで作れます。SQL クエリ、グラフ、カード、地図、クロスフィルターが手元のコンピューターで動き、git でレビューでき、AI エージェントが編集と検証を行えます。"
image: https://ducklocal.app/og-image.jpg?v=2
language: ja
---

# 読めて、差分が取れて、レビューできる SQL ダッシュボード

DuckLocal のダッシュボードはプレーンテキストの `.dash` ファイルです。データソース、DuckDB SQL のクエリ、その結果を描くプロットで構成されます。手元のコンピューターでローカルファイルに対して動き、コードと同じように git に置け、あなたが書くことも AI エージェントが書くこともできます。

BI サーバーもアカウントもデータのアップロードも不要。macOS、Windows、Linux 向けの無料オープンソース。

- プレーンテキストの .dash ファイル
- グラフ、カード、地図、表
- クリックでプロットをまたいで絞り込み
- ducklocal check で検証

## ダッシュボードは短いファイル

`source` ブロックがデータファイルを指定し、`query` ブロックが SQL を持ち、`plot` ブロックが各結果の描き方を決めます。`filter` ブロックを使うと、1 つのプロットのクリックでほかのプロットを絞り込めます。覚える関数やテンプレートはなく、SQL といくつかの属性だけです。

パスは `.dash` ファイルからの相対パスなので、仕様とデータをまとめたフォルダーはどこにコピーしても動きます。

[すべてのブロックと属性](https://ducklocal.app/docs/ja/dashboards#blocks)

```hcl
source "orders" {
  path = "orders.csv"
}

query "revenue" {
  sql = <<SQL
    SELECT channel, sum(amount) AS total
    FROM orders
    GROUP BY channel
    ORDER BY total DESC
  SQL
}

plot "revenue" {
  type  = "bar"
  query = query.revenue
  x     = channel
  y     = total
}
```

## ダッシュボードに必要なプロット

定番のグラフ、数値、地図を 12 列のグリッドに配置します。

- **line · area**時系列。1 つのプロットに最大 12 系列
- **bar · stacked_bar**ランキングと内訳、合計付き
- **scatter · histogram**相関と分布
- **heatmap**曜日 × 時間、地域 × 月
- **map**緯度経度の点。サイズと色を指定可能
- **timeline**実際の時間間隔でレーンに並ぶイベント
- **card**1 つの数値と、その良し悪しがわかる変化
- **table · text**並べ替えできる行、見出し、メモ
[プロットの種類とオプション →](https://ducklocal.app/docs/ja/dashboards#plot-types)

## ドキュメントのようにダッシュボードをレビュー

プロットにカーソルを合わせて吹き出しをクリックし、変えてほしい点を書きます。たとえば*「大きいチャネル順に並べて」*。スレッドには返信でき、解決済みにでき、未解決のスレッドがあるプロットには件数が表示されます。

AI エージェントは `ducklocal comments` で同じスレッドを読みます。各スレッドには対象のプロットと、ファイル内のブロックの行番号が書かれています。エージェントは仕様を編集し、検証して返信します。開いているウィンドウは 1 秒以内に再描画され、**Agent** と表示された返信が現れます。

[コメントでレビュー](https://ducklocal.app/docs/ja/dashboards#review-with-comments) · [Claude Dashboards から DuckLocal について学んだこと](https://ducklocal.app/ja/blog/claude-dashboards-ducklocal/)

```bash
ducklocal comments sales.dash
{"open":1, "threads":[{"id":"c1",
  "plot":"revenue_by_channel",
  "plot_lines":[68,75], ...}]}

ducklocal check sales.dash
ducklocal comments sales.dash --reply c1 \
  --text "Sorted by revenue, descending" --resolve
```

## 誰かが開く前に検証

`ducklocal check` はファイルを解析し、すべての参照を解決し、すべてのクエリを読み取り専用で実行します。さらに各プロットの列が実際の結果に存在するかを確かめるので、タイプミス、失敗するキャスト、何にも一致しない glob は会議ではなくターミナルで見つかります。

問題は一度にすべて、1 件ずつ `file:line: message` の形式で表示され、スクリプトや CI ジョブが使える終了コードを返します。

[ダッシュボードを検証](https://ducklocal.app/docs/ja/dashboards#validate-a-dashboard)

- 構文、名前、参照をチェック
- 各クエリの SQL を DuckDB で実行
- プロットの列を実際の結果と照合
- 値を選んだ状態でフィルターをチェック
- 行を返さないクエリを指摘

## データはローカルに、ファイルは持ち運べる

クエリは DuckLocal に内蔵された DuckDB エンジンで、ディスク上のファイルや DuckDB データベースに対して実行されます。フォルダーを送れば、相手は自分のデータのコピーで同じダッシュボードを見られます。公開も、ワークスペースの共有も不要です。

> **1 つのクエリから始めますか？** SQL エディタの結果はその場でグラフにできます。残しておきたいグラフがそろったら、`.dash` ファイルを書きましょう。 [結果とグラフ →](https://ducklocal.app/docs/ja/results-and-charts)

## SQL ダッシュボードについての質問

**.dash ファイルとは何ですか？** ダッシュボードをブロックで宣言するプレーンテキストファイルです。`source` がデータファイルを指定し、`query` が DuckDB SQL の文を 1 つ持ち、`plot` が結果を描き、`filter` が 1 つのプロットのクリックでほかを絞り込みます。コードを書く必要はありません。

**ダッシュボードにサーバーや BI のアカウントは必要ですか？** いいえ。DuckLocal がファイルを開き、アプリ内の DuckDB エンジンで手元のコンピューター上でクエリを実行します。データファイルは元の場所のままです。

**どんなグラフが使えますか？** 折れ線、棒、積み上げ棒、面、散布図、円、ヒートマップ、ヒストグラム、地図、タイムラインに加え、表、変化表示付きの数値カード、テキストパネルがあり、12 列のグリッドに配置できます。

**AI エージェントはダッシュボードを作ったり変えたりできますか？** できます。エージェントが .dash ファイルを書いたり編集したりし、`ducklocal check` ですべてのクエリが動きすべてのプロットの列があることを確かめ、`ducklocal comments` でレビューコメントに返信します。開いているウィンドウは 1 秒以内に再描画されます。

**ダッシュボードを git で管理できますか？** できます。.dash ファイルは短いプレーンテキストなので、コードと同じように差分を取ってレビューできます。レビューコメントは別の `NAME.dash.comments.json` ファイルに保存されるので、バージョン管理から外しておけます。

関連：[AI エージェントのための SQL](https://ducklocal.app/ja/use-cases/ai-agent-sql/) · [ローカルデータ分析](https://ducklocal.app/ja/use-cases/local-data-analysis/) · [DuckDB GUI](https://ducklocal.app/ja/use-cases/duckdb-gui/) · [SQL で CSV をクエリ](https://ducklocal.app/ja/use-cases/query-csv-with-sql/)

## サンプルのダッシュボードを開く

DuckLocal をダウンロードし、チュートリアルの `sales.csv` と `sales.dash` を同じフォルダーに保存して、ダッシュボードをウィンドウにドロップしてください。

## リンク

- [DuckLocal をダウンロード](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [ダッシュボードガイドを読む](https://ducklocal.app/docs/ja/dashboards)
- [完全な例を見る](https://ducklocal.app/docs/ja/dashboards#a-complete-example)

Source: https://ducklocal.app/ja/use-cases/sql-dashboards/
