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

Debugger

PL/pgSQL- und PL/SQL-Routinen schrittweise ausführen, mit Breakpoints, Call Stack, Variablen und Watches.

Voraussetzungen

EngineSchnittstelleVoraussetzung
PostgreSQL · PL/pgSQLpldbgapiDie Server-Erweiterung pldbgapi muss installiert sein. Sonst: Die Server-Erweiterung pldbgapi wird benötigt.
Oracle · PL/SQLDBMS_DEBUGRecht DEBUG CONNECT SESSION. Sonst: DEBUG CONNECT SESSION fehlt.

Andere Engines haben keinen Debugger; der Dialog nennt jeweils den Grund, z. B. bei MySQL MySQL stellt keine native Schnittstelle für schrittweises Routine-Debugging bereit.

Oracle markiert DBMS_DEBUG als veraltet. l8db kompiliert das gewählte Objekt beim Start mit Debug-Informationen und arbeitet mit zwei SQL-Verbindungen, ohne JDWP-Rückkanal.

Starten

Debugger – Start und Dialog

Debuggen steht in der Ansicht einer Funktion, Prozedur oder eines Package-Bodys (dort für das gewählte Mitglied), siehe Routinen. Deaktiviert ist er bei Verbindungen im Lesemodus.

Der Dialog Debugger prüft zuerst die Unterstützung (Debug-Unterstützung wird geprüft …) und zeigt dann drei Schritte:

  1. Aufruf vorbereiten – Parameter, Überladung und Rückgabetyp im Editor anpassen. l8db legt ein Aufrufskript mit dem Aufruf der Routine an.
  2. Sitzung starten – mit F5. Der Debugger hält am Einstieg an.
  3. Schrittweise prüfen – Breakpoints am Zeilenrand setzen und Variablen beobachten.

Start führt echten Datenbankcode aus. COMMIT, DDL und autonome Transaktionen können Änderungen dauerhaft speichern.

Steuerung

KnopfKürzelWirkung
Starten / WeiterF5Sitzung starten bzw. bis zum nächsten Breakpoint laufen
DarüberF10nächste Zeile, ohne in Aufrufe zu springen
HineinF11in den Aufruf springen
HerausShift+F11bis zum Rücksprung laufen, wenn die Engine das kann
StoppenShift+F5Sitzung beenden

Status der Sitzung: Bereit, Verbindung wird aufgebaut, Läuft, Angehalten, Beendet, Abgebrochen oder Fehler. Bei einem Halt: Ausführung angehalten. Breakpoints am linken Editorrand setzen.

Debugger angehalten mit Variablen

Breakpoints setzt und entfernt ein Klick auf den linken Rand des Quelltexts (Breakpoint entfernen).

Inspektion

  • Call Stack – Aufrufpfad, sobald die Ausführung anhält. Ein Klick wählt den Frame; die Variablen folgen dem Aktueller Frame.
  • Variablen und Parameter – Name und Wert, filterbar (Variablen filtern …). Leer: In diesem Frame sind keine Variablen verfügbar.
  • Watches – Variable beobachten … und Watch hinzufügen. Werte erscheinen beim nächsten Halt: Lokale Werte werden beim nächsten Halt angezeigt.

Grenzen

  • Höchstens 16 Debug-Sitzungen gleichzeitig: Maximal 16 Debug-Sitzungen. Beenden Sie eine bestehende Sitzung.
  • Eine Sitzung ohne Aktivität wird nach 4 Minuten beendet.
  • Ein einzelner Debug-Befehl darf höchstens 5 Minuten dauern: Debug-Befehl hat das Zeitlimit überschritten.
  • Die Sitzung bleibt mit der Datenbank verbunden, bis sie beendet wird.