Zum Inhalt springen

Ergebnisse und Diagramme ​

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.

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

WertAngezeigt als
NULLdas Literal NULL, in gedämpfter Farbe
BLOB<blob N bytes>
GEOMETRY<geometry N bytes>
Fließkommazahl mit ganzzahligem Wert3.0
Zeitstempel2026-09-17 04:21:09.5 — in UTC, nicht in Ortszeit; der Bruchteil hat so viele Stellen wie der Wert (neun bei TIMESTAMP_NS)
IntervallDuckDB-Notation, etwa 1 day 02:00:00
Liste / Struct / Maphü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 ​

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 ​

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

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 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 hatAuto zeichnet
Eine Breitengrad- und eine LängengradspalteEine Karte
Eine zeitliche erste Spalte (Datum / Zeitstempel)Ein Flächendiagramm; x ist Spalte 0, eine Serie pro Zahlenspalte
Alles andereEin 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 ​

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

GrenzeVerhalten
12 SerienZusätzliche Zahlenspalten werden verworfen
1.500 PunkteDie Serie wird in Buckets aufgeteilt und innerhalb jedes Buckets gemittelt
200 BalkenÜberzählige Balken werden abgeschnitten, nicht zusammengeführt
8 KreissegmenteDie 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 ​

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:

TeilWas es zeigt
Name und TypDer Spaltenname und ihr DuckDB-Typ
NULLsDer Anteil der Zeilen, die NULL sind, mit einem kleinen Balken; hervorgehoben, wenn über 0 %
Verschiedene~N distinct — DuckDBs Schätzung der Zahl verschiedener Werte
BereichMinimum – Maximum, oder der einzelne Wert, wenn sie gleich sind
MedianFür Zahlen, Daten und Zeitstempel
VerteilungEin 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 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ü.

Explain- und Profile-Ausgabe ​

Die Schaltflächen Explain und 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.

Veröffentlicht unter der Apache-2.0-Lizenz.