Neu: Jede Funktion mit Schritt-für-Schritt-Anleitung und Screenshots.
SQL

Ausführen

Ausführungsarten, Prüfen, Abbrechen, Zeilenlimit, Statements trennen, Skripte, Bind-Parameter und Schutz vor destruktiven Abfragen.

Ausführungsarten

Ausführen-Menü mit Optionen

AktionKürzelFührt aus
HauptknopfMod+Enter, alternativ F5je nach Standard für Ausführen
Statement unter CursorMod+Shift+Enter, alternativ F9das Statement, in dem der Cursor steht
Auswahl ausführenMod+Alt+Enternur die Markierung
Skript mit Einzelergebnissen–alle Statements einzeln, siehe unten

Standard für Ausführen (unter Anpassen) bestimmt den Hauptknopf und seine Beschriftung:

EinstellungMit MarkierungOhne Markierung
Auswahl, sonst alles (Standard)Auswahl ausführenAusführen – ganzer Editor
Auswahl, sonst StatementAuswahl ausführenStatement ausführen
Immer gesamter EditorAlles ausführenAlles ausführen

Findet l8db an der Cursorposition kein Statement: Kein ausführbares Statement an der Cursorposition. Ist es mehrdeutig: Statement unter dem Cursor konnte nicht eindeutig bestimmt werden. Bitte den gewünschten Bereich markieren.

Das ausgeführte Statement wird im Editor hervorgehoben. Jede Ausführung landet im Verlauf.

Mehrere Statements

Wird mehr als ein Statement auf einmal ausgeführt (ganzer Editor oder Markierung), schickt l8db den Text in einem Aufruf an die Datenbank.

  • PostgreSQL führt alle Statements aus und zeigt die Zeilen aller Ergebnismengen zusammen.
  • SQL Server und MySQL zeigen nur die erste Ergebnismenge.
  • Für ein Ergebnis pro Statement: Skript mit Einzelergebnissen.

Statements trennen

Für Statement unter Cursor, Skripte, die Statement-Gliederung und den SQL-Import zerlegt l8db den Text selbst:

  • Trennzeichen ist ;.
  • Zeichenketten, Bezeichner in Anführungszeichen, Zeilen- und Blockkommentare sowie PostgreSQL-Dollar-Quoting ($$ … $$, $tag$ … $tag$) werden respektiert.
  • Oracle: PL/SQL-Blöcke (BEGIN … END;, CREATE PROCEDURE … usw.) bleiben zusammen; eine Zeile mit nur / beendet einen Block.
  • Nicht unterstützt: GO (SQL Server) und DELIMITER (MySQL). Prozeduren mit ; im Rumpf müssen bei MySQL einzeln markiert und ausgeführt werden.

Prüfen

Erfolgreiche Prüfung

Prüfen (Mod+Shift+K) – Tooltip Nur prüfen — Änderungen werden zurückgerollt, nichts wird übernommen – führt das SQL aus und verwirft das Ergebnis.

EngineVerfahren
PostgreSQLAusführung in einer Transaktion, danach ROLLBACK. Funktioniert auch für DDL
OracleSyntaxprüfung mit DBMS_SQL.PARSE; DDL wird an temporären Objekten geprüft
anderePrüfen ohne Speichern (kein transaktionales DDL) wird von diesem Datenbanktyp nicht unterstützt.

Erfolg: Fehlerfrei geprüft — nichts wurde übernommen.

Abbrechen

Abbrechen-Knopf während Ausführung

Abbrechen (Mod+Shift+Backspace) erscheint während einer Ausführung. Danach zeigt der Knopf Abbruch angefordert…

EngineAbbruch
PostgreSQLüber pg_cancel_backend auf dem Server
SQLiteüber einen Interrupt der Verbindung
andereKnopf deaktiviert: Dieser Treiber unterstützt keinen direkten Abfrageabbruch. Das konfigurierte Timeout bleibt wirksam.

Das Query-Timeout (Standard 30 Sekunden, 5 bis 300) und das Verbindungs-Timeout stellt man in den Einstellungen ein.

Zeilenlimit

Der Editor liefert höchstens 1000 Zeilen. Wird die Grenze erreicht, zeigt die Statuszeile auf 1000 begrenzt. Das Standard-Zeilenlimit der Einstellungen gilt hier nicht; es betrifft nur Tabellenansichten. Für mehr Zeilen: LIMIT/OFFSET im SQL oder den Export einer Tabelle.

Innerhalb einer offenen Transaktion kürzt l8db Ergebnisse nicht.

Skript mit Einzelergebnissen

Skript-Dialog und Ergebnisse

Skript mit Einzelergebnissen öffnet Skript ausführen: Die Statements werden einzeln in der Reihenfolge des Editors ausgeführt.

Transaktion:

ModusVerhalten
Neue Transaktion, danach prüfenDas Skript startet eine verwaltete Transaktion. Nichts wird automatisch committet; Commit oder Rollback erfolgt danach über das Transaktionspanel. Nur bei Engines mit Transaktionen
AutocommitJedes Statement wird sofort und endgültig ausgeführt. Ein Rollback ist nicht möglich
Offene Transaktion verwendenEinzige Wahl, wenn schon eine Transaktion offen ist; kein Autocommit

Bei Fehler stoppen: In einer Transaktion stoppt der Ablauf immer beim ersten Fehler. Bei Autocommit lässt sich das Fortsetzen ausdrücklich wählen.

Abgelehnt werden:

  • offene Literale oder Kommentare: Das Skript enthält ein nicht abgeschlossenes Literal oder einen offenen Kommentar.
  • COMMIT, ROLLBACK, ABORT, START TRANSACTION, BEGIN (außer Oracle-Blöcken) und bei PostgreSQL END: Transaktionsbefehle im Skript bitte entfernen und die Transaktionswahl des Dialogs verwenden.
  • in einem Transaktionsmodus bei MySQL, Oracle, ClickHouse und Cassandra CREATE, ALTER, DROP, TRUNCATE, GRANT, REVOKE: Dieses Skript enthält DDL mit implizitem Commit. Bitte vorhandene Transaktionen abschließen und Autocommit wählen.

Die Liste Skriptausführung unter dem Editor zeigt pro Statement Status, Laufzeit und Zeilen. Nicht erreichte Statements heißen nicht ausgeführt. Ein Klick zeigt das Ergebnis des Statements. Skriptergebnisse schließen blendet die Liste aus.

Skript-Ergebnisse

Bind-Parameter

Bind-Parameter-Dialog

Enthält das SQL Platzhalter, fragt Bind-Parameter vor der Ausführung nach Werten.

  • Erkannt werden $1, $2 … und :name. Ignoriert werden :new und :old (Trigger), ::-Casts sowie alles in Zeichenketten, Bezeichnern in Anführungszeichen, Dollar-Quoting und Kommentaren.
  • Pro Parameter: Wert und Typ Text, Ganzzahl, Dezimalzahl, Boolean, Zeitstempel oder NULL.
EngineÜbergabe
PostgreSQL, Oracleechte Bindung: Werte werden gebunden und nicht in den SQL-Text eingesetzt. Der Verlauf speichert nur die Abfrage mit Platzhaltern.
andereWerte werden als Literale in den SQL-Text eingesetzt.

Bestätigung destruktiver Abfragen

Bestätigung vor destruktiver Abfrage

Mit Destruktive Abfragen absichern (Einstellungen, Daten & Abfragen, Standard an) fragt Destruktive Abfrage ausführen? vor:

  • DROP TABLE – Tabelle löschen
  • TRUNCATE – Tabelle leeren
  • DELETE ohne WHERE – DELETE ohne WHERE

Der Dialog nennt Verbindung und Datenbank und zeigt jedes betroffene Statement. Abfrage ausführen fährt fort, Abbrechen bricht mit Ausführung vom Benutzer abgebrochen. ab.

Bestätigung in Produktion

UPDATE ohne WHERE, DROP anderer Objekte (Views, Schemas, Datenbanken) und ALTER lösen keine Rückfrage aus. Bei MongoDB und Redis gibt es die Prüfung nicht.

Die Prüfung gilt überall, wo l8db SQL ausführt: Editor, Skripte, SQL-Import.

EXPLAIN ANALYZE auf ändernde Statements fragt ebenfalls nach, siehe Ausführungsplan.

Lesemodus

Eine PostgreSQL-Verbindung lässt sich in den Verbindungseinstellungen als schreibgeschützt anlegen. l8db setzt dann default_transaction_read_only; jeder Schreibversuch scheitert mit Lesemodus: Diese Verbindung ist schreibgeschützt. Modus in den Verbindungseinstellungen ändern und neu verbinden. Bei anderen Engines gibt es diesen Modus nicht.