ERROR_STACK_TRACE( )

LONG VARCHAR-Wert, der das Stack-Trace für den Fehler darstellt, der durch den die Fehlerbehandlungsroutine aufgerufen wurde. Wenn die zusammengesetzte Anweisung nicht Teil einer Prozedur, einer Funktion, eines Triggers oder eines Ereignisses ist, wird statt des Prozedurnamens der Batch-Typ (watcom_batch oder tsql_batch) zurückgegeben.

Jede Zeile des zurückgegebenen Werts enthält den qualifizierten Prozedurnamen oder Batch-Typ (falls vorhanden) für die Anweisung auf dem Stack, gefolgt von der Zeilennummer der Anweisung. Die letzte Zeile des zurückgegebenen Werts endet nicht mit einer Zeilenendmarke. Wenn eine Prozedur ausgeblendet ist, gibt der Datenbankserver nicht den Namen der Prozedur aus, durch die der Fehler aufgerufen wurde.

Diese Funktion gibt dieselben Informationen zurück wie die sa_error_stack_trace-Systemprozedur.

• TRY-Anweisung
• BEGIN-Anweisung
• ERROR_LINE-Funktion [Verschiedene]
• ERROR_MESSAGE-Funktion [Verschiedene]
• ERROR_PROCEDURE-Funktion [Funktionstyp]
• ERROR_SQLCODE-Funktion [Verschiedene]
• ERROR_SQLSTATE-Funktion [Verschiedene]
• STACK_TRACE-Funktion [Verschiedene]
• sa_error_stack_trace-Systemprozedur
• sa_stack_trace-Systemprozedur
• Verschachtelte zusammengesetzte Anweisungen und Ausnahmeroutinen
• Beispiel: Fehlerprotokollierungsprozedur erstellen, sodass sie von einer Ausnahmeroutine aufgerufen werden kann

Die folgende Gruppe von Prozeduren (mit hinzugefügten Zeilennummern) kann verwendet werden, um den Fehler-Stack abzurufen:

1 CREATE PROCEDURE proc1()
2 BEGIN TRY
3    CALL proc2();
4 END TRY
5 BEGIN CATCH
6    SELECT ERROR_STACK_TRACE();
7 END CATCH;

1CREATE PROCEDURE proc2()
2 BEGIN
3    CALL proc3();
4 END;

1CREATE PROCEDURE proc3()
2 BEGIN
3    DECLARE v INTEGER = 0;
4    SET v = 1 / v;
5 END;

CALL proc1();

Dieser Abruf gibt die folgende Ergebniszeichenfolge zurück:

'"DBA"."proc1" : 3
"DBA"."proc2" : 3
"DBA"."proc3" : 4

Wenn in der Fehlerbehandlungsroutine RESIGNAL verwendet wird und der erneut signalisierte Fehler behandelt wird, enthält der im zweiten Handler gemeldete Fehler-Stack das Stack-Trace des ursprünglichen Fehlers, den Datensatz für das RESIGNAL und den Stack der erneut signalisierten Ausnahmebedingung. Beispiel:

CREATE PROCEDURE proc1()
BEGIN TRY
    BEGIN TRY
        DECLARE v INTEGER = 0;
        SET v = 1 / v;
    END TRY
    BEGIN CATCH
        CALL proc2();
    END CATCH
END TRY
BEGIN CATCH
    SELECT ERROR_STACK_TRACE();
END CATCH;

CREATE PROCEDURE proc2()
BEGIN
    CALL proc3();
END;

CREATE PROCEDURE proc3()
BEGIN
    RESIGNAL;
END;

CALL proc1();

Dieser Abruf gibt die folgende Ergebniszeichenfolge zurück:

'"DBA"."proc1" : 8
"DBA"."proc2" : 3
RESIGNAL: "DBA"."proc3" : 3
"DBA"."proc1" : 5