# SQL-Editor

> Abfrage-Tabs, Formatierung, Autovervollständigung, Explain-Pläne, Profiling pro Operator und Tastenkürzel im SQL-Editor von DuckLocal.

Source: https://ducklocal.app/docs/de/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

| Steuerelement | Funktion |
| --- | --- |
| `+` oder **⌘T** | Hängt einen neuen Abfrage-Tab an und fokussiert ihn |
| Klick auf einen Tab | Wechselt zu ihm |
| **Ctrl+Tab** / **Ctrl+Shift+Tab** | Der nächste / vorherige Tab |
| **⌘1** … **⌘8**, **⌘9** | Der erste bis achte Tab; ⌘9 ist der letzte Tab |
| Einen Tab ziehen | Verschiebt ihn in der Leiste |
| `×`, **⌘W** oder Mittelklick | Schließ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 Tab | **Tab 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 Tab | Bearbeitet 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äche | Funktion |
| --- | --- |
| **Ausführen** | Führt das SQL im Editor aus — siehe [SQL ausführen](#running-sql) |
| **Stopp** | Erscheint, sobald ein Lauf einen Moment dauert; unterbricht ihn |
| **Formatieren** | Formatiert das SQL neu — siehe [Formatieren](#format) |
| **Explain** | Zeigt den Plan, den DuckDB verwenden würde, ohne die Anweisung auszuführen |
| **Profile** | Führt die Abfrage aus und zeigt, was jeder Operator gekostet hat |

**Explain** und **Profile** sind in
[Explain und Profile](#explain-and-profile) beschrieben.

## SQL ausführen {#running-sql}

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](results-and-charts.md#row-limits) 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:

| Befehl | Zeigt |
| --- | --- |
| `.tables ?PATTERN?` | Tabellen und Views, optional gefiltert durch ein `ILIKE`-Muster wie `stat%` |
| `.schema ?PATTERN?` | Die `CREATE`-Anweisungen von Tabellen und Views, optional gefiltert |
| `.databases` | Die angehängten Datenbanken |
| `.help` | Diese 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](schema-and-history.md) 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 {#format}

**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 {#explain-and-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](schema-and-history.md#query-history) 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](results-and-charts.md#explain-and-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ürzel | Aktion |
| --- | --- |
| ⌘↵ | Die Abfrage ausführen |
| ⌘. | Die laufende Abfrage stoppen |
| ⌘T | Neuer Abfrage-Tab |
| ⌘W | Den Tab schließen |
| Ctrl+Tab / Ctrl+Shift+Tab | Nächster / vorheriger Tab (auch auf einem Mac Ctrl) |
| ⌘1 … ⌘9 | Zum Tab an dieser Stelle; ⌘9 ist der letzte |
| ⌘O | Daten öffnen |
| ⌘S | Die Quelle eines Dashboards speichern, in seiner Quellansicht |
| ⌘B | Die Seitenleiste ein- oder ausblenden |
| ⌘+ / ⌘− / ⌘0 | Die Oberfläche größer / kleiner / auf Standardgröße — siehe [Größe der Oberfläche](settings-and-data.md#interface-size) |
| ⌘Q | Beenden |

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

| Tastenkürzel | Aktion |
| --- | --- |
| ⌘F / ⇧⌘F | Im Editor suchen / ersetzen |
| ⌘Z / ⇧⌘Z | Rückgängig / Wiederholen |
| ⌘A | Alles auswählen |
| ⌘C / ⌘X / ⌘V | Kopieren / 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 |

## Menüs

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

| Menü | Befehle |
| --- | --- |
| DuckLocal | Kommandozeile & KI, Nach Updates suchen…, Beim Start nach Updates suchen, Den Leitfaden anzeigen, Log-Ordner öffnen, DuckLocal beenden |
| Datei | Neue Abfrage, Daten öffnen, Speichern, Tab schließen, Nächster Tab, Vorheriger Tab |
| Bearbeiten | Rückgängig, Wiederholen, Ausschneiden, Kopieren, Einfügen, Alles auswählen |
| Abfrage | Ausführen, Stopp |
| Darstellung | Seitenleiste 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](results-and-charts.md#charts). Zeilen in der Schema-Seitenleiste haben ebenfalls
ein Rechtsklickmenü; siehe
[Schema und Verlauf](schema-and-history.md#right-click-menu). Eine Befehlspalette gibt es
nicht.
