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

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

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

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

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

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

すべてのブロックと属性

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実際の時間間隔でレーンに並ぶイベント
  • card1 つの数値と、その良し悪しがわかる変化
  • table · text並べ替えできる行、見出し、メモ

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

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

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

コメントでレビュー · Claude Dashboards から DuckLocal について学んだこと

Terminal
$ 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 ジョブが使える終了コードを返します。

ダッシュボードを検証

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

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

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

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 ファイルに保存されるので、バージョン管理から外しておけます。

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

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