ダッシュボードは短いファイル
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 と表示された返信が現れます。
$ 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ファイルに保存されるので、バージョン管理から外しておけます。
関連:AI エージェントのための SQL · ローカルデータ分析 · DuckDB GUI · SQL で CSV をクエリ
サンプルのダッシュボードを開く
DuckLocal をダウンロードし、チュートリアルの sales.csv と sales.dash を同じフォルダーに保存して、ダッシュボードをウィンドウにドロップしてください。