SQL-Dashboards, die man lesen, diffen und prüfen kann

Ein DuckLocal-Dashboard ist eine reine Textdatei .dash: Datenquellen, DuckDB-SQL-Abfragen und die Diagramme, die sie darstellen. Es läuft auf Ihrem Rechner mit Ihren lokalen Dateien, liegt wie Code in git und kann von Ihnen oder einem KI-Agenten geschrieben werden.

Kein BI-Server, kein Konto, kein Daten-Upload. Kostenlos und Open Source für macOS, Windows und Linux.

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.

Alle Blöcke und Attribute

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

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

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.

Ein Dashboard validieren

  • 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: source nennt Datendateien, query enthält eine DuckDB-SQL-Anweisung, plot zeichnet ein Ergebnis, und filter sorgt 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 check aus, um sicherzustellen, dass jede Abfrage läuft und die Spalten jedes Diagramms existieren, und beantwortet Review-Kommentare mit ducklocal 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.

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.