TRY-Anweisung

Implementiert Fehlerbehandlung für zusammengesetzte Anweisungen. (Wenn im TRY-Block ein Fehler auftritt, übergibt er die Steuerung an eine andere Gruppe von Anweisungen in einem CATCH-Block.)

Syntax

[ statement-label : ]
BEGIN TRY
   [ local-declaration; ... ]
   [ statement-list ]
END TRY
BEGIN CATCH
   [ statement-list ]
END CATCH

local-declaration :
variable-declaration
| cursor-declaration
| exception-declaration
| temporary-table-declaration

variable-declaration und exception-declaration : Siehe DECLARE-Anweisung.

cursor-declaration : Siehe DECLARE CURSOR-Anweisung [ESQL] [SP].

temporary-table-declaration : Siehe DECLARE LOCAL TEMPORARY TABLE-Anweisung.

Parameter

statement-label Wenn am Ende ein statement-label angegeben wird, muss es mit dem statement-label am Anfang übereinstimmen. Die LEAVE-Anweisung kann verwendet werden, um die Ausführung bei der ersten Anweisung nach der zusammengesetzten Anweisung wieder aufzunehmen. Die zusammengesetzte Anweisung, die den Hauptteil einer Prozedur oder eines Triggers darstellt, hat ein implizites Label, das mit dem Namen der Prozedur oder des Triggers übereinstimmt.
local-declaration Unmittelbar nach BEGIN TRY können in einer zusammengesetzten Anweisung lokale Deklarationen für Objekte folgen, die nur innerhalb der zusammengesetzten Anweisung vorhanden sind. Eine zusammengesetzte Anweisung kann eine lokale Deklaration für eine Variable, einen Cursor, eine temporäre Tabelle oder eine Ausnahmebedingung enthalten. Lokale Deklarationen können von jeder beliebigen Anweisung in dieser zusammengesetzten Anweisung oder in jeder beliebigen darin verschachtelten zusammengesetzten Anweisung referenziert werden. Lokale Deklarationen der zusammengesetzten Anweisung sind für den Ausnahmeroutinen für die Anweisung sichtbar. Lokale Deklarationen sind für die anderen Prozeduren, die von innerhalb einer zusammengesetzten Anweisung aufgerufen werden, nicht sichtbar.

Bemerkungen

Der CATCH-Block ist die Fehlerbehandlungsroutine für die TRY-Anweisung.

TRY...CATCH-Anweisungen können verschachtelt werden und überall dort stehen, wo auch eine BEGIN...END-Anweisung verwendet werden kann. Anweisungen innerhalb des TRY-Blocks ignorieren die Datenbankoptionen on_tsql_error und continue_after_raiserror sowie die ON EXCEPTION RESUME-Klausel der CREATE PROCEDURE-Anweisung. TRY...CATCH-Anweisungen sind nicht atomar.

Wenn im TRY-Block keine Fehler auftreten, wird der CATCH-Block übersprungen und die Steuerung wird an die auf den CATCH-Block folgende Anweisung übergeben bzw. an den Aufrufer, falls keine solche Anweisung vorhanden ist. Wenn in einer der Anweisungen im TRY-Block ein Fehler auftritt, wird die Steuerung an die erste Anweisung im CATCH-Block übergeben. Nach Abschluss des CATCH-Blocks wird die Steuerung an die auf den CATCH-Block folgende Anweisung übergeben bzw. an den Aufrufer, falls keine solche Anweisung vorhanden ist. Die Auswirkungen von Anweisungen, die einer einen Fehler generierenden Anweisung vorangehen, werden nicht rückgängig gemacht, es sei denn, die Ausnahmeroutine generiert einen Fehler und ist innerhalb eines atomaren Blocks verschachtelt oder eine explizite ROLLBACK-Anweisung wird aufgerufen. In diesem Fall werden alle Anweisungen innerhalb des atomaren Transaktionsblocks zurückgesetzt.

Fehler im CATCH-Block werden entsprechend den Verbindungs- und Prozedureinstellungen behandelt, es sei denn, die Anweisungen, die sie generieren, sind von weiteren TRY...CATCH-Anweisungen umschlossen.

Privilegien

Nebenwirkungen

Siehe auch

Standards und Kompatibilität

Beispiel

In diesen Beispiele wird die folgende Tabelle verwendet:

CREATE TABLE t( col1 DOUBLE );

Durch Ausführen der folgenden zusammengesetzten Anweisung wird der Wert 6 in die Tabelle "t" eingefügt:

BEGIN TRY
    DECLARE val INT;

    SET val = 0;

    INSERT INTO t VALUES( 1 / val );
    -- This statement will not be executed
    INSERT INTO t VALUES( val );
END TRY
BEGIN CATCH
    SET val = 6;
    INSERT INTO t VALUES( val );
END CATCH;

Durch Ausführen der folgenden Prozedur mit CALL proc1(10); werden die folgenden Werte in die die Tabelle "t" eingefügt:

-10

CREATE PROCEDURE DBA.proc1( v INTEGER )
BEGIN TRY
    DECLARE local_val INTEGER = 0;

    INSERT INTO t VALUES(-v);

    SET local_val = v / local_val;
    -- This statement will not be executed
    MESSAGE 'The value is ', v;
END TRY
BEGIN CATCH
    INSERT INTO t VALUES(v);
END CATCH;

Kommentieren Sie diese Seite in DocCommentXchange.