---
title: "Lokale SQL-Dashboards als Textdateien | DuckLocal"
description: "DuckDB-Dashboards als reine Textdateien (.dash) bauen: SQL-Abfragen, Diagramme, Kennzahlen, Karten und Kreuzfilter, die auf Ihrem Rechner laufen, sich in git prüfen lassen und die ein KI-Agent bearbeiten und validieren kann."
image: https://ducklocal.app/og-image.jpg?v=2
language: de
---

# 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.

- Reine Textdateien (.dash)
- Diagramme, Kennzahlen, Karten, Tabellen
- Per Klick über Diagramme filtern
- Geprüft mit ducklocal check

## 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](https://ducklocal.app/docs/de/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
}
```

## Die Diagramme, die ein Dashboard braucht

Gängige Diagramme, Zahlen und Karten, angeordnet in einem Raster mit 12 Spalten.

- **line · area**Zeitreihen, bis zu 12 Reihen pro Diagramm
- **bar · stacked_bar**Ranglisten und Anteile am Ganzen, mit Summen
- **scatter · histogram**Zusammenhänge und Verteilungen
- **heatmap**Wochentag nach Stunde, Region nach Monat
- **map**Punkte nach Breiten- und Längengrad, mit Größe und Farbe
- **timeline**Ereignisse in ihrem echten zeitlichen Abstand, in Bahnen
- **card**Eine Zahl mit ihrer Veränderung, gut oder schlecht
- **table · text**Sortierbare Zeilen, Überschriften und Notizen
[Diagrammtypen und Optionen →](https://ducklocal.app/docs/de/dashboards#plot-types)

## 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](https://ducklocal.app/docs/de/dashboards#review-with-comments) · [Was Claude Dashboards mir über DuckLocal beigebracht hat](https://ducklocal.app/de/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
```

## 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](https://ducklocal.app/docs/de/dashboards#validate-a-dashboard)

- 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.

> **Mit einer einzelnen Abfrage beginnen?** Jedes Ergebnis im SQL-Editor lässt sich sofort als Diagramm darstellen. Schreiben Sie eine `.dash`-Datei, wenn sich eine Reihe von Diagrammen lohnt. [Ergebnisse und Diagramme →](https://ducklocal.app/docs/de/results-and-charts)

## 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.

Verwandt: [SQL für KI-Agenten](https://ducklocal.app/de/use-cases/ai-agent-sql/) · [Lokale Datenanalyse](https://ducklocal.app/de/use-cases/local-data-analysis/) · [DuckDB-GUI](https://ducklocal.app/de/use-cases/duckdb-gui/) · [CSV mit SQL abfragen](https://ducklocal.app/de/use-cases/query-csv-with-sql/)

## 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.

## Links

- [DuckLocal herunterladen](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Dashboard-Leitfaden lesen](https://ducklocal.app/docs/de/dashboards)
- [Das vollständige Beispiel ansehen](https://ducklocal.app/docs/de/dashboards#a-complete-example)

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