# Ergebnisse und Diagramme

> Abfrageergebnisse filtern und kopieren, jede Spalte profilen, Diagramme zeichnen und Ergebnisse als CSV oder Parquet exportieren.

Source: https://ducklocal.app/docs/de/results-and-charts

Der Bereich unter dem Editor hat drei Tabs: **Ergebnisse**, **Diagramm** und
**Übersicht**. Rechts neben den Tabs stehen die Größe des Ergebnisses
(`N rows · M columns`) und die Schaltflächen **CSV exportieren** und
**Parquet exportieren**.

Der Tab **Ergebnisse** zeigt auch, was die Schaltflächen **Explain** und
**Profile** des Editors erzeugen — siehe
[Explain- und Profile-Ausgabe](#explain-and-profile).

## Das Ergebnisraster

Das Raster beginnt mit einer Spalte `#` für die Zeilennummer, gefolgt von den Spalten des Abfrageergebnisses. Zahlenspalten sind rechtsbündig. Die Anfangsspaltenbreiten werden aus den Überschriften und den ersten 200 Zeilen berechnet, wobei chinesische oder japanische Zeichen als zwei Zeichen breit zählen. Die Breiten liegen bei der Standard-[Schnittstellengröße](settings-and-data.md#interface-size) zwischen 80 und 360 Pixeln und skalieren bei anderen Größen proportional. Ziehen Sie an Spaltengrenzen, um die Breiten anzupassen; die Spalte `#` lässt sich nicht in der Breite ändern.
Sind die Spalten breiter als der Bereich, bleibt eine horizontale Bildlaufleiste
unter ihnen sichtbar.

Klicken Sie auf die Pfeile in der Kopfzeile einer Spalte, um die geladenen Zeilen
danach zu sortieren: absteigend, dann aufsteigend, dann zurück in die Reihenfolge
der Abfrage. Zahlenspalten sortieren als Zahlen, alles andere als Text (was
ISO-Datums- und Zeitangaben in die richtige Reihenfolge bringt), `NULL` sortiert
zuletzt, und Zeilen mit gleichen Werten behalten die Reihenfolge der Abfrage. Ein
[Filter](#filtering) behält die Sortierung, und das nächste Ergebnis startet
unsortiert. Die Sortierung geschieht clientseitig, wie der Filter: Um mehr Zeilen
zu sortieren, als geladen wurden, verwenden Sie `ORDER BY`.

### Zellendarstellung

| Wert | Angezeigt als |
| --- | --- |
| `NULL` | das Literal `NULL`, in gedämpfter Farbe |
| BLOB | `<blob N bytes>` |
| GEOMETRY | `<geometry N bytes>` |
| Fließkommazahl mit ganzzahligem Wert | `3.0` |
| Zeitstempel | `2026-09-17 04:21:09.5` — **in UTC, nicht in Ortszeit**; der Bruchteil hat so viele Stellen wie der Wert (neun bei TIMESTAMP_NS) |
| Intervall | DuckDB-Notation, etwa `1 day 02:00:00` |
| Liste / Struct / Map | hübsch formatiert |

Die UTC-Darstellung sollten Sie im Kopf behalten, wenn Sie Zeitstempel mit dem
Auge prüfen statt sie in SQL zu vergleichen.

### Filterung {#filtering}

Das Filterfeld führt eine Teilzeichenketten-Suche ohne Unterscheidung von Groß- und
Kleinschreibung **über alle Zellen** der geladenen Zeilen aus. Sie arbeitet
clientseitig: Sie fragt nie die Datenbank ab, und sie erfasst nur die Zeilen, die
geladen wurden, nicht die tatsächliche Ergebnisgröße.

Der Filter wird angewendet, wenn Sie die Eingabetaste drücken oder das Feld leeren,
nicht bei jedem Tastendruck. Während ein Filter aktiv ist, meldet das Raster
daneben `visible / total rows`.

## Zeilenlimits {#row-limits}

Ergebnisse werden gekürzt, sobald eine dieser Grenzen zuerst greift:

- **100.000 Zeilen**
- **2.000.000 Zellen** — ein Ergebnis mit 400 Spalten liefert also nur etwa 5.000
  Zeilen

Das Zellenbudget gibt es, weil eine reine Zeilenobergrenze die Arbeit nicht
begrenzt: Ein `PIVOT` über eine Spalte mit hoher Kardinalität liefert eine Spalte
pro verschiedenem Wert, und das Formatieren von zig Millionen Zellen sähe aus wie
ein Hänger.

Die Kürzung wird in einem Banner gemeldet, das die tatsächliche Zahl der geladenen
Zeilen nennt. Es gibt **keine Paginierung und kein „Mehr laden“** — grenzen Sie
stattdessen die Abfrage ein.

## Kopieren

Fahren Sie über eine Zelle, erscheint eine Kopierschaltfläche, die den Text dieser
Zelle in die Zwischenablage legt. Klicken Sie mit der rechten Maustaste auf eine
Zelle für **Zelle kopieren**, **Zeile kopieren** (tabulatorgetrennt) oder
**Spalte kopieren** (ein Wert pro Zeile, in der angezeigten Reihenfolge). Klicken
Sie mit der rechten Maustaste auf eine Zeilennummer, um ihre Zeile zu kopieren.
Kopien folgen dem aktuellen Filter und der aktuellen Sortierung. Tabellen in
Dashboards bieten dieselben drei Kopieraktionen. Es gibt keine Bereichsauswahl und
kein „Als SQL kopieren“; für mehr als eine Zeile oder eine Spalte verwenden Sie
den [Export](#export).

## Export {#export}

`Export CSV` und `Export Parquet` öffnen einen kleinen Dialog mit einem Pfadfeld,
vorbelegt mit `~/Desktop/export.csv` bzw. `~/Desktop/export.parquet`.

Zwei Dinge sollten Sie wissen:

- Der Export **führt das SQL, das die aktuellen Zeilen erzeugt hat, erneut aus**,
  die Datei enthält also die vollständige Ergebnismenge der Abfrage — nicht die
  gefilterte Ansicht und nicht das gekürzte Raster.
- Es gibt keinen Dateiauswahldialog und keine Nachfrage zum Überschreiben. Geben
  Sie einen Pfad ein, und er wird geschrieben.

## Diagramme {#charts}

Bis Sie Spalten auswählen, wird ein Diagramm aus den Zeilen gezeichnet, die bereits
im Raster sind, in der Reihenfolge, in der die Abfrage sie geliefert hat, ohne
Aggregation. Die [Menüs **X**, **Y** und **Split**](#pick-columns) lassen DuckDB
stattdessen das ganze Ergebnis gruppieren.

Die Diagrammauswahl über dem Diagramm beginnt bei **Auto**, das aus den Spalten des
Ergebnisses wählt:

| Das Ergebnis hat | Auto zeichnet |
| --- | --- |
| Eine Breitengrad- und eine Längengradspalte | Eine Karte |
| Eine zeitliche erste Spalte (Datum / Zeitstempel) | Ein Flächendiagramm; x ist Spalte 0, eine Serie pro Zahlenspalte |
| Alles andere | Ein Balkendiagramm; Spalte 0 ist die Beschriftung, die erste Zahlenspalte der Wert |

„Zahlenspalte“ schließt die erste Spalte ein: Ist Spalte 0 eine Zahl — eine Stunde,
ein Jahr, eine ID —, wird sie der Wert des Balkendiagramms, nicht seine
Beschriftung. Wandeln Sie sie in Text um (`year::VARCHAR`, oder
`format('{:02d}:00', hour(ts))`), damit sie die Beschriftung wird.

**Balken**, **Linie**, **Fläche** und **Streuung** sind für jedes Ergebnis einen
Klick entfernt; **Kreis** für ein Ergebnis, dessen erste Spalte keine Zeit ist, und
**Karte** für eines mit Koordinaten. Die Auswahl bleibt über Läufe hinweg erhalten;
wenn ein neues Ergebnis sie nicht zeichnen kann — eine Karte ohne Koordinaten —,
fällt das Diagramm auf Autos Wahl zurück, ohne Ihre zu vergessen.

### Spalten auswählen {#pick-columns}

Die Menüs **X**, **Y** und **Split** über dem Diagramm wählen, was es zeichnet.
**Y** ist die Zeilenzahl oder die Summe, der Durchschnitt, das Minimum oder das
Maximum einer Zahl. DuckDB gruppiert dann das ganze Ergebnis statt der geladenen
Zeilen und behält die 200 größten Kategorien (oder die ersten 50.000 geordneten
Werte) und die 12 größten Serien. Ein Hinweis sagt, was weggelassen wurde.

- Mit gewähltem **Split** kommen **Gestapelt** und **Heatmap** zur Diagrammauswahl
  hinzu, und **Kreis** fällt weg.
- **Histogramm** wird angeboten, wenn es eine Zahl zum Einteilen gibt. DuckDB teilt
  das ganze Ergebnis ein.
- **Als .dash kopieren** kopiert Ihre Auswahl als `query`- und `plot`-Block, die
  dasselbe Diagramm in einem [Dashboard](dashboards.md) zeichnen.

Ohne Auswahl sagt ein Diagramm eines gekürzten Ergebnisses **Aus den ersten N
Zeilen gezeichnet, die das Raster geladen hat, nicht aus dem ganzen Ergebnis**. Eine
gekürzte Zeitreihe wird im Hintergrund erneut ausgeführt und über alle Zeilen
gemittelt.

### Diagrammtypen und Grenzen

Ein **Kreisdiagramm** zeichnet den Wert der ersten Zahlenspalte pro Beschriftung,
größte zuerst. Null-, negative und fehlende Werte werden nicht als Segmente
gezeichnet, und ein Hinweis zählt sie; ab 8 Segmenten behalten die 7 größten ihre
Segmente, und der Rest fällt in „Sonstige“.

Eine **Karte** wird über Spaltennamen gewählt:

- **Breitengrad:** `lat`, `latitude`, oder jeder Name, der sie enthält (`geo_lat`,
  `start_lat`) — `纬度` funktioniert auch.
- **Längengrad:** `lng`, `lon`, `long`, `longitude`, ebenso — `经度` funktioniert
  auch.

Jede Zeile ist ein Punkt auf einer Web-Mercator-Projektion, die an die Punkte
angepasst ist, über einem Breiten-/Längengrad-Raster, das in Grad beschriftet ist;
eine Textspalte mit nur wenigen verschiedenen Werten färbt sie ein. Fahren Sie über
einen Punkt, um seine Zeile zu sehen.

Unter den Punkten kann eine OpenStreetMap-Grundkarte gezeichnet werden: Schalten
Sie sie mit **Ansicht → Online-Grundkarte (OpenStreetMap)** ein. Sie ist
standardmäßig aus, weil das Laden der Kacheln das Netzwerk braucht — die Anfragen
verraten ungefähr den betrachteten Bereich, nie Ihre Zeilen. Kacheln werden eine
Woche lang zwischengespeichert; offline zeichnet die Karte nur über dem
Breiten-/Längengrad-Raster.

Zeilen, deren Wertzellen nicht numerisch sind — etwa `NULL` —, werden vor dem
Zeichnen verworfen.

Grenzen, alle in einer Hinweiszeile unter dem Diagrammtitel angekündigt:

| Grenze | Verhalten |
| --- | --- |
| 12 Serien | Zusätzliche Zahlenspalten werden verworfen |
| 1.500 Punkte | Die Serie wird in Buckets aufgeteilt und innerhalb jedes Buckets **gemittelt** |
| 200 Balken | Überzählige Balken werden abgeschnitten, nicht zusammengeführt |
| 8 Kreissegmente | Die kleinsten fallen in „Sonstige“ |
| 20.000 Kartenpunkte | Überzählige Punkte entfallen |

Der Titel meldet immer, wie viele Punkte gezeichnet wurden, prüfen Sie ihn also,
bevor Sie der Form einer Kurve trauen.

## Spaltenübersicht {#overview}

Der Tab **Übersicht** beschreibt jede Spalte des aktuellen Ergebnisses auf einmal:
wie voll sie ist, wie viele Werte sie annimmt, ihren Bereich und wie ihre Werte
aussehen.

Die Überschriftenzeile lautet `Current result · N rows · M columns · took …`. Danach
bekommt jede Spalte eine Zeile:

| Teil | Was es zeigt |
| --- | --- |
| Name und Typ | Der Spaltenname und ihr DuckDB-Typ |
| NULLs | Der Anteil der Zeilen, die `NULL` sind, mit einem kleinen Balken; hervorgehoben, wenn über 0 % |
| Verschiedene | `~N distinct` — DuckDBs Schätzung der Zahl verschiedener Werte |
| Bereich | Minimum – Maximum, oder der einzelne Wert, wenn sie gleich sind |
| Median | Für Zahlen, Daten und Zeitstempel |
| Verteilung | Ein kleines Diagramm, unten beschrieben |

Die Verteilung hängt vom Typ der Spalte ab:

- **Zahlen, Daten und Zeitstempel** bekommen ein Histogramm aus etwa 12 gleich
  breiten Balken. Eine Spalte mit einem einzigen Wert listet stattdessen diesen Wert.
- **Text und boolesche Werte** listen ihre 5 häufigsten Werte, jeden mit seinem
  Anteil an den Zeilen; fahren Sie über einen Wert für seine genaue Anzahl. Ab etwa
  10.000 verschiedenen Werten werden die Werte geschätzt und unter *Häufige Werte
  (geschätzt)* ohne Anteile gelistet.
- **Listen, Structs, Maps und Unions** bekommen kein Diagramm.

Wie es funktioniert:

- **Die Übersicht führt die Abfrage erneut aus**, vollständig, in zwei Durchläufen:
  `SUMMARIZE` für die Statistiken, dann ein `SELECT` für die Verteilung jeder
  Spalte. So erfasst sie das ganze Ergebnis, nicht nur die Zeilen, die das Raster
  unter seinen [Zeilenlimits](#row-limits) behalten hat — und eine langsame Abfrage
  ist wieder langsam. Eine Abfrage, die nicht deterministisch ist (`random()`,
  `USING SAMPLE`), wird so beschrieben, wie sie im zweiten Lauf herauskam.
- Sie wird berechnet, wenn Sie den Tab öffnen, und erneut für jedes neue Ergebnis,
  solange der Tab offen ist.
- **Nur eine Abfrage, die in `FROM ( … )` hineinpasst, kann zusammengefasst
  werden**: eine, die mit `SELECT`, `WITH`, `FROM`, `VALUES`, `TABLE`, `PIVOT` oder
  `UNPIVOT` beginnt (führende `--`-Kommentare werden übersprungen). Alles andere —
  `SHOW`, `DESCRIBE`, `PRAGMA`, `CALL`, `SUMMARIZE` — bekommt *Nur das Ergebnis
  einer Abfrage (SELECT, WITH, FROM…) kann zusammengefasst werden: Die Übersicht
  führt sie erneut aus.*

Um eine ganze Tabelle, View oder registrierte Datei zusammenzufassen, ohne eine
Abfrage zu schreiben, klicken Sie sie in der Seitenleiste mit der rechten Maustaste
an und wählen **Spaltenübersicht**. Das setzt `FROM <name>;` in den Editor, führt es
aus und öffnet diesen Tab. Siehe
[Rechtsklickmenü](schema-and-history.md#right-click-menu).

## Explain- und Profile-Ausgabe {#explain-and-profile}

Die [Schaltflächen **Explain** und **Profile**](sql-editor.md#explain-and-profile)
in der Editor-Werkzeugleiste zeigen ihre Ausgabe im Tab **Ergebnisse** und wechseln
dorthin, wenn ein anderer Tab offen war. Beide ersetzen das Raster; führen Sie die
Abfrage erneut aus, um ihre Zeilen zurückzubekommen.

**Explain** zeigt DuckDBs Plan als reinen Monospace-Text unter einer Zeile
`EXPLAIN · took …`.

**Profile** zeigt den Plan, der tatsächlich lief, als Baum, eine Zeile pro Operator,
jeder unter dem Operator eingerückt, den er speist:

- einen Balken für den Anteil des Operators an der Zeit, die alle Operatoren
  verbraucht haben;
- die eigene Zeit des Operators, seine Kinder ausgeschlossen;
- seinen Namen, etwa `TABLE_SCAN`, `FILTER` oder `HASH_GROUP_BY`;
- `N rows` — die Zeilen, die er erzeugt hat;
- `est. N` — die Schätzung des Optimierers für diese Zeilen, wo der Plan eine hat.
  Sie wird hervorgehoben, wenn sie in eine der beiden Richtungen um mehr als das
  10-Fache danebenliegt (fahren Sie darüber für *Schätzung um mehr als das 10-Fache
  daneben*): ein Fehlschlag dieser Größe ist ein häufiger Grund für einen langsamen
  Join;
- darunter, womit der Operator gearbeitet hat: Filter, Join-Schlüssel,
  Projektionen.

Die Überschriftenzeile lautet `Profile · took … · operators …`: die Wall-Clock-Zeit,
dann die Summe der Eigenzeiten der Operatoren. Die beiden unterscheiden sich, weil
Operatoren einer Pipeline verschachtelt laufen; die Balken sind Anteile der zweiten.
Daneben nennt `Hottest: NAME (time)` den Operator, der allein am meisten gekostet
hat, und seine Zeile wird rot gezeichnet.
