Zum Inhalt springen

SQL-Editor ​

Jeder Abfrage-Tab hat seinen eigenen Editor-Puffer. Der Editor hebt echtes SQL per tree-sitter hervor, rückt mit 2 Leerzeichen ein und zeigt Zeilennummern.

Tabs ​

SteuerelementFunktion
+ oder ⌘THängt einen neuen Abfrage-Tab an und fokussiert ihn
Klick auf einen TabWechselt zu ihm
Ctrl+Tab / Ctrl+Shift+TabDer nächste / vorherige Tab
⌘1 … ⌘8, ⌘9Der erste bis achte Tab; ⌘9 ist der letzte Tab
Einen Tab ziehenVerschiebt ihn in der Leiste
×, ⌘W oder MittelklickSchließt einen Tab. Der letzte Tab lässt sich nicht schließen: Sein × ist ausgeblendet und ⌘W tut nichts. Ein Dashboard mit ungespeicherten Änderungen fragt vorher nach
Rechtsklick auf einen TabTab schließen, Andere Tabs schließen, Tabs rechts schließen. Dashboards mit ungespeicherten Änderungen bleiben offen, und ein Hinweis nennt ihre Anzahl
Doppelklick auf einen TabBearbeitet seinen Titel direkt. Enter oder ein Klick daneben übernimmt den neuen Titel, Escape den alten; ein leerer Titel fällt auf Query N zurück

Offene Tabs kommen beim nächsten Start in ihrer Reihenfolge zurück: Abfrage-Tabs mit ihren Titeln und dem SQL in ihren Editoren, ob es lief oder nicht, und Dashboard-Tabs. Ergebnisse nicht — führen Sie die Abfrage erneut aus. Ein neu geöffneter Abfrage-Tab beginnt mit SELECT 'Hello, DuckLocal' AS greeting;.

Die Werkzeugleiste ​

Über dem Editor, von links:

SchaltflächeFunktion
AusführenFührt das SQL im Editor aus — siehe SQL ausführen
StoppErscheint, sobald ein Lauf einen Moment dauert; unterbricht ihn
FormatierenFormatiert das SQL neu — siehe Formatieren
ExplainZeigt den Plan, den DuckDB verwenden würde, ohne die Anweisung auszuführen
ProfileFührt die Abfrage aus und zeigt, was jeder Operator gekostet hat

Explain und Profile sind in Explain und Profile beschrieben.

SQL ausführen ​

Drücken Sie ⌘↵ (Cmd+Enter), während der Editor fokussiert ist, oder verwenden Sie die Schaltfläche Ausführen.

Während eine Abfrage läuft, bewirkt ein erneutes Ausführen nichts (ebenso wenig Explain und Profile), und eine Stopp-Schaltfläche erscheint neben Ausführen, sobald die Abfrage einen Moment läuft. Stopp oder ⌘. unterbricht die Abfrage; sie endet mit DuckDBs Fehler Interrupted, der wie jeder Fehlschlag im Verlauf aufgezeichnet wird. Es gibt kein Timeout: Ohne Stopp läuft eine Abfrage so lange, wie DuckDB braucht, und andere Datenbankarbeit wartet dahinter in der Warteschlange.

Ergebnisse werden von DuckDB gestreamt, sodass ein Scan endet, sobald das Zeilenlimit des Rasters erreicht ist, statt den Rest der Datei zu lesen. Eine Abfrage, die jede Zeile sehen muss, bevor sie die erste liefert — ORDER BY, GROUP BY, eine Aggregat- oder Fensterfunktion —, rechnet trotzdem vollständig.

Jeder Tab hat seine eigenen Ergebnisse. Ein Ergebnis, das eintrifft, nachdem Sie den Tab gewechselt haben, landet in dem Tab, der sie ausgeführt hat.

Wie eine Anweisung behandelt wird, hängt von ihrem führenden Schlüsselwort ab. SELECT, WITH, SHOW, DESCRIBE, EXPLAIN, PRAGMA, SUMMARIZE, VALUES, FROM, TABLE, PIVOT und CALL erzeugen eine Ergebnismenge. Alles andere — DDL-Anweisungen (Datendefinition) und DML-Anweisungen (Datenänderung) — meldet Done: N rows affected, took … statt eines Rasters. Führende ---Kommentare werden bei der Entscheidung übersprungen; Blockkommentare nicht.

Skripte ​

Der Editor kann mehrere Anweisungen enthalten. Ausführen führt alle nacheinander aus, so wie die DuckDB-Shell eine Datei liest, und hält beim ersten Fehlschlag an — ein SELECT nach einem fehlgeschlagenen ATTACH würde nur einen zweiten, irreführenden Fehler hinzufügen. Eine Leiste über den Ergebnissen listet die Anweisungen, jede mit ihrer Zeilenzahl und erledigt, fehlgeschlagen oder nicht ausgeführt markiert; klicken Sie eine an, um ihr Ergebnis zu sehen. Ein Fehler unterstreicht die Anweisung, die fehlgeschlagen ist, nicht das ganze Skript.

Einige Punktbefehle der Shell funktionieren ebenfalls, jeder in einer eigenen Zeile:

BefehlZeigt
.tables ?PATTERN?Tabellen und Views, optional gefiltert durch ein ILIKE-Muster wie stat%
.schema ?PATTERN?Die CREATE-Anweisungen von Tabellen und Views, optional gefiltert
.databasesDie angehängten Datenbanken
.helpDiese Liste

Jeder andere Punktbefehl (.mode, .read, …) ist ein Fehler, der die funktionierenden nennt.

Fehler ​

Eine fehlgeschlagene Anweisung zeigt einen Hinweis mit dem Titel Abfrage fehlgeschlagen und DuckDBs Meldung im Wortlaut. Die Meldung kommt von der Engine und ist immer auf Englisch, unabhängig von der Sprache der Oberfläche. Ins Raster wird nichts geschrieben, und der Versuch wird trotzdem mit einer Fehlermarkierung im Verlauf aufgezeichnet.

Wenn die Meldung auf eine Position zeigt — Parser- und Binder-Fehler tun das, mit einer LINE n:-Zeile und einem Caret —, unterstreicht der Editor diese Stelle mit einer roten Wellenlinie: das Token, das der Caret markiert, oder die Spanne, die eine Folge von Carets abdeckt. Die Markierung folgt Ihren Änderungen und verschwindet beim nächsten Ausführen. Laufzeitfehler tragen keine Position und erhalten keine Markierung.

Formatieren ​

Formatieren schickt den Puffer durch sqlformat mit einer Einrückung von 2 Leerzeichen und großgeschriebenen Schlüsselwörtern und ersetzt dann den gesamten Puffer. Bei einem leeren Puffer tut es nichts.

Explain und Profile ​

Beide Schaltflächen arbeiten auf dem gesamten Text des Editors, und beide erwarten genau eine Anweisung. Bei zwei oder mehr — oder bei einem Punktbefehl — lehnen sie ab mit Explain und Profile nehmen genau eine Anweisung: Legen Sie die zu betrachtende in einen eigenen Tab. Ein abschließendes ; und abschließende Kommentare sind in Ordnung.

Während eine der Aktionen Ausführen, Explain oder Profile läuft, tun die anderen beiden nichts. Weder Explain noch Profile werden im Verlauf aufgezeichnet. Ihre Ausgabe ersetzt das Raster im Tab Ergebnisse und wechselt dorthin, falls ein anderer Tab offen war; ein Fehlschlag zeigt den Hinweis Abfrage fehlgeschlagen, wie ein fehlgeschlagenes Ausführen.

Explain ​

Explain führt EXPLAIN <your statement> aus und zeigt DuckDBs Plan als einfachen Monospace-Text samt benötigter Zeit. Es plant nur: Die Anweisung wird nicht ausgeführt, daher lässt sich ein INSERT, UPDATE oder DELETE gefahrlos erklären.

Profile ​

Profile führt die Anweisung unter EXPLAIN (ANALYZE, FORMAT JSON) aus und zeigt den gelaufenen Plan als Baum: die eigene Zeit jedes Operators und seinen Anteil am Gesamten, die erzeugten Zeilen gegenüber der Schätzung des Optimierers (markiert, wenn sie um mehr als das 10-Fache abweicht), und was er gefiltert, worauf er gejoint oder was er projiziert hat. Der teuerste Operator wird oben genannt und rot gezeichnet. Wie man das liest: Ausgabe von Explain und Profile.

Profiling führt die Anweisung wirklich aus — so werden ihre Operatoren gemessen. Daher akzeptiert es nur eine einzelne schreibgeschützte Abfrage:

  • Akzeptiert: SELECT, WITH … SELECT, FROM …, VALUES, TABLE, SHOW, DESCRIBE, SUMMARIZE.
  • Abgelehnt: alles, was schreibt (INSERT, UPDATE, DELETE, CREATE, …), CALL, PRAGMA, COPY, EXPLAIN selbst, ein hinter einem WITH verstecktes Schreiben (WITH s AS (…) INSERT …) und ein PIVOT ohne explizite IN (…)-Liste.

Eine abgelehnte Anweisung bekommt Nur lesende Anweisungen können profiliert werden (SELECT, WITH, FROM…): Profiling führt die Anweisung aus. DuckDBs eigener Parser entscheidet das, bevor etwas läuft, nicht das erste Schlüsselwort.

Ein Profiling dauert so lange wie die Abfrage, plus den Aufwand der Messung. Stopp (oder ⌘.) unterbricht es wie ein Ausführen.

Autovervollständigung ​

Das Vervollständigungsmenü kennt den Katalog. Die Kandidaten sind so geordnet:

  1. Tabellen und Spalten aus dem Schema (bis zu 35 Einträge)
  2. Namen von DuckDB-Funktionen
  3. SQL-Schlüsselwörter

Angeboten werden höchstens 50 Einträge. Der Abgleich ist ein Präfix-Abgleich ohne Unterscheidung von Groß- und Kleinschreibung auf den Bezeichner direkt links vom Cursor, sodass sel zu SELECT vervollständigt wird, elect aber zu nichts. Eine Funktion fügt ihren Namen und eine öffnende Klammer ein; Bezeichner mit Leerzeichen oder Sonderzeichen werden in doppelten Anführungszeichen eingefügt.

Die Listen der Schlüsselwörter und Funktionen sind eine kuratierte Teilmenge — nicht jede DuckDB-Funktion erscheint.

Tastenkürzel ​

Unter Windows und Linux lesen Sie durchgängig Ctrl statt ⌘.

DuckLocals eigene Tastenkürzel, alle in der Menüleiste aufgeführt:

TastenkürzelAktion
⌘↵Die Abfrage ausführen
⌘.Die laufende Abfrage stoppen
⌘TNeuer Abfrage-Tab
⌘WDen Tab schließen
Ctrl+Tab / Ctrl+Shift+TabNächster / vorheriger Tab (auch auf einem Mac Ctrl)
⌘1 … ⌘9Zum Tab an dieser Stelle; ⌘9 ist der letzte
⌘ODaten öffnen
⌘SDie Quelle eines Dashboards speichern, in seiner Quellansicht
⌘BDie Seitenleiste ein- oder ausblenden
⌘+ / ⌘− / ⌘0Die Oberfläche größer / kleiner / auf Standardgröße — siehe Größe der Oberfläche
⌘QBeenden

Die Tastenkürzel des Editors, die sich wie in jedem Textfeld verhalten:

TastenkürzelAktion
⌘F / ⇧⌘FIm Editor suchen / ersetzen
⌘Z / ⇧⌘ZRückgängig / Wiederholen
⌘AAlles auswählen
⌘C / ⌘X / ⌘VKopieren / Ausschneiden / Einfügen
⌥⌘↑ / ⌥⌘↓Einen Cursor darüber / darunter hinzufügen
⌘← / ⌘→ / ⌥← / ⌥→Zeilen- / wortweise bewegen
⌘↑ / ⌘↓Zum Anfang / Ende des Dokuments
⌘⌫ / ⌥⌫Bis zum Zeilenanfang / vorherigen Wort löschen

Die Menüleiste enthält jeden Fensterbefehl mit seinem Tastenkürzel:

MenüBefehle
DuckLocalKommandozeile & KI, Nach Updates suchen…, Beim Start nach Updates suchen, Den Leitfaden anzeigen, Log-Ordner öffnen, DuckLocal beenden
DateiNeue Abfrage, Daten öffnen, Speichern, Tab schließen, Nächster Tab, Vorheriger Tab
BearbeitenRückgängig, Wiederholen, Ausschneiden, Kopieren, Einfügen, Alles auswählen
AbfrageAusführen, Stopp
DarstellungSeitenleiste ein- oder ausblenden, Größere Oberfläche, Kleinere Oberfläche, Standardgröße, Online-Basiskarte (OpenStreetMap)

Unter Windows und Linux gibt es keine Menüleiste; dort finden sich Den Leitfaden anzeigen und Log-Ordner öffnen im Rechtsklickmenü der Version am rechten Ende der Statusleiste.

Online-Basiskarte (OpenStreetMap) ist ein Kontrollkästchen; siehe Diagramme. Zeilen in der Schema-Seitenleiste haben ebenfalls ein Rechtsklickmenü; siehe Schema und Verlauf. Eine Befehlspalette gibt es nicht.

Veröffentlicht unter der Apache-2.0-Lizenz.