The compound statement is used in a routine or trigger to create an environment within which variables, cursors, exception condition names and exception handlers can be declared.
The procedural SQL statements in a compound statement are executed in sequence whenever the compound statement is executed.
The compound statement may be used wherever a single procedural SQL statement is permitted. Thus, it provides a mechanism for executing a sequence of statements in places where the syntax rules permit only a single statement to be specified.
Compound statements can be nested and the optional label value can be used to qualify the names of objects declared within the compound statement. The label value can also be used in conjunction with the
LEAVEstatement to control the execution flow by exiting from the compound statement.
A compound statement can be defined as atomic by specifying
ATOMICnext to the
When a compound statement is defined as atomic, an `atomic execution context' becomes active while it, or any invoked routine, is executing. While an atomic execution context is active it is not possible to explicitly terminate a transaction, i.e. the statements
ROLLBACKare not allowed. Within an atomic compound statement it is possible to declare an undo handler for exception handling. If an undo handler is activated due to an exception, the handler will undo any insert, delete or update operations done within the atomic execution context. If there is no appropriate undo handler found the exception handling will be the same as in a non-atomic context, only the operations performed by the statement causing the exception will be undone.
ATOMICis specified, the
COMMITstatements must not be used in the compound statement.
A compound statement which contains a declaration of an
UNDOexception handler must be
A compound statement without an
NOT ATOMICspecification is assumed to be
The value of label must be the same at both ends of the compound statement.
If label is specified at the end of the compound statement it must also be specified at the beginning.
LEAVEstatement is to be used to exit the compound statement, the label at the beginning must be specified.
ExampleCREATE PROCEDURE exproc(IN P_SIRE VARCHAR(30)) MODIFIES SQL DATA S0: BEGIN ... S1: BEGIN DECLARE EOF BOOLEAN DEFAULT FALSE; DECLARE CONTINUE HANDLER FOR NOT FOUND SET EOF = TRUE; DECLARE HORSES CURSOR FOR SELECT * FROM HORSES WHERE SIRE = P_SIRE; DECLARE HORSE AS (HORSES); L1: LOOP FETCH FROM HORSES INTO HORSE; IF EOF THEN LEAVLE L1; END IF; -- -- atomic compound to ensure that both or none of the DML operations are done -- BEGIN ATOMIC DECLARE UNDO HANDLER FOR SQLEXCEPTION BEGIN END; UPDATE HORSE_PEOPLE ...; UPDATE HORSE_EVENTS ...; END; END LOOP; END S1; END S0;
Mimer Information Technology AB
Voice: +46 18 780 92 00
Fax: +46 18 780 92 40