Ein Dashboard ist eine kurze Datei
source-Blöcke nennen Datendateien, query-Blöcke enthalten SQL, und plot-Blöcke legen fest, wie jedes Ergebnis gezeichnet wird. Ein filter-Block sorgt dafür, dass ein Klick in ein Diagramm die anderen eingrenzt. Keine Funktionen oder Vorlagen zu lernen, nur SQL und ein paar Attribute.
Pfade sind relativ zur .dash-Datei, ein Ordner mit Spezifikation und Daten funktioniert also, wohin Sie ihn auch kopieren.
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 }
Die Diagramme, die ein Dashboard braucht
Gängige Diagramme, Zahlen und Karten, angeordnet in einem Raster mit 12 Spalten.
- line · areaZeitreihen, bis zu 12 Reihen pro Diagramm
- bar · stacked_barRanglisten und Anteile am Ganzen, mit Summen
- scatter · histogramZusammenhänge und Verteilungen
- heatmapWochentag nach Stunde, Region nach Monat
- mapPunkte nach Breiten- und Längengrad, mit Größe und Farbe
- timelineEreignisse in ihrem echten zeitlichen Abstand, in Bahnen
- cardEine Zahl mit ihrer Veränderung, gut oder schlecht
- table · textSortierbare Zeilen, Überschriften und Notizen
Ein Dashboard prüfen wie ein Dokument
Fahren Sie über ein Diagramm, klicken Sie auf die Sprechblase und schreiben Sie, was sich ändern soll, zum Beispiel „nach Größe sortieren, größter Kanal zuerst“. Threads haben Antworten und lassen sich als erledigt markieren, und ein Diagramm mit offenen Threads zeigt deren Anzahl.
Ein KI-Agent liest dieselben Threads mit ducklocal comments. Jeder Thread nennt sein Diagramm und die Zeilen seines Blocks in der Datei. Der Agent bearbeitet die Spezifikation, validiert sie und antwortet. Das geöffnete Fenster zeichnet sich innerhalb einer Sekunde neu und zeigt die Antwort, markiert als Agent.
Mit Kommentaren prüfen · Was Claude Dashboards mir über DuckLocal beigebracht hat
$ 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
Geprüft, bevor es jemand öffnet
ducklocal check parst die Datei, löst jeden Verweis auf und führt jede Abfrage schreibgeschützt aus. Dann bestätigt es, dass die Spalten jedes Diagramms im echten Ergebnis existieren – ein Tippfehler, eine fehlschlagende Umwandlung oder ein Glob ohne Treffer fällt so im Terminal auf, nicht im Meeting.
Alle Probleme werden auf einmal aufgelistet, je eins als file:line: message, mit Exit-Codes, auf die ein Skript oder CI-Job reagieren kann.
- Syntax, Namen und Verweise geprüft
- Das SQL jeder Abfrage durch DuckDB ausgeführt
- Diagrammspalten gegen echte Ergebnisse geprüft
- Filter mit gewähltem Wert geprüft
- Abfragen ohne Zeilen markiert
Ihre Daten bleiben lokal, die Datei reist
Abfragen laufen in der DuckDB-Engine in DuckLocal, auf Dateien auf Ihrer Festplatte oder einer DuckDB-Datenbank. Schicken Sie jemandem den Ordner, und er sieht dasselbe Dashboard über seiner Kopie der Daten – nichts zu veröffentlichen, kein Arbeitsbereich zu teilen.
Fragen zu SQL-Dashboards
- Was ist eine .dash-Datei?
- Eine reine Textdatei, die ein Dashboard als Blöcke beschreibt:
sourcenennt Datendateien,queryenthält eine DuckDB-SQL-Anweisung,plotzeichnet ein Ergebnis, undfiltersorgt dafür, dass ein Klick in ein Diagramm die anderen eingrenzt. Es gibt keinen Code zu schreiben. - Braucht ein Dashboard einen Server oder ein BI-Konto?
- Nein. DuckLocal öffnet die Datei und führt ihre Abfragen mit der DuckDB-Engine in der App aus, auf Ihrem Rechner. Die Datendateien bleiben, wo sie sind.
- Welche Diagramme gibt es?
- Linien-, Balken-, gestapelte Balken-, Flächen-, Streu-, Kreis-, Heatmap-, Histogramm-, Karten- und Zeitleistendiagramme, dazu Tabellen, Kennzahlenkarten mit Veränderungsanzeige und Textfelder, angeordnet in einem Raster mit 12 Spalten.
- Kann ein KI-Agent ein Dashboard erstellen oder ändern?
- Ja. Ein Agent schreibt oder bearbeitet die .dash-Datei, führt
ducklocal checkaus, um sicherzustellen, dass jede Abfrage läuft und die Spalten jedes Diagramms existieren, und beantwortet Review-Kommentare mitducklocal comments. Das geöffnete Fenster zeichnet sich innerhalb einer Sekunde neu. - Kann ich Dashboards in git verwalten?
- Ja. Eine .dash-Datei ist kurzer reiner Text, der sich wie Code diffen und prüfen lässt. Review-Kommentare liegen in einer separaten Datei
NAME.dash.comments.json, die Sie aus der Versionsverwaltung heraushalten können.
Verwandt: SQL für KI-Agenten · Lokale Datenanalyse · DuckDB-GUI · CSV mit SQL abfragen
Das Beispiel-Dashboard öffnen
Laden Sie DuckLocal herunter, speichern Sie sales.csv und sales.dash aus dem Tutorial nebeneinander und ziehen Sie das Dashboard ins Fenster.