(DB2)Handler基本语义与定义

冰镇可乐

　　DB2 条件处理器定义（Condition Handler Declarations）
　　
可以在SQL procedure中定义一个条件处理器（Handler）来处理特殊的行为。下面是一个通用的处理器（Handler）定义格式：
　　
DECLARE handler-type HANDLER FOR conditionSQL-procedure-statement
　　
当DB2触发一个满足定义的条件时，就会将控制权交给条件处理器(Condition handler)，条件处理器根据指定的处理类型（Handle Type）来执行指定的SQL-Procedure-Statement。
　　
处理类型(Handler-types)
　　
CONTINUE 执行SQL-procedure-statement的过程中如果出现错误，则跳到引起错误sql statement后的语句继续执行。
　　
EXIT 执行SQL-procedure-statement的过程中如果出现错误，直接跳到定义该condition的语句块(compound statement,类似oracle PL/SQL block)之后的语句。
　　
UNDO 在执行SQL-procedure-statement之前定义，如果在定义该handler的语句块（compound statement）内发生错误，DB2将rollback所有执行的SQL statement.
　　
Note: UNDO处理器(handler)只能定义在ATOMIC的语句块（compound statements）中。ATOMIC的含义：如果在语句块(compound statement)中一条语句出现了错误，该语句块（compound statement)中所有的语句将被rollback.NOT ATOMIC含义相反。
　　
处理条件（Conditions）
　　
DB2预定义了3中处理条件（Condition）：NOT FOUND SQLCODE等于于正100（+100）或者SQLSTATE以‘02’开头的所有错误（Condition）。
　　
SQLEXCEPTION SQLCODE为负数的所有错误(Condition)。
　　
SQLWARNING 所有的警告类型的错误(Condition)(SQLWARNO等于‘W’)，或者一个正SQL(positiveSQL)的SQLCODE不同于正100（+100）（这句话翻译有点confused，引用原文：or that results in a positive SQL return code other than +100）.这种类型的SQLSTATE都以’01’开头。
　　DB2支持通过DECLARE为一个特定的SQLSTATE定义自定义的条件(condition)。
　　
SQL-procedure-statement
　　
条件处理器（condition handler）的行为语句可以是单SQL(Single SQL)的SQL Statement，也可以是用BEGIN..END来定义一个语句块(compound statement).如果你是通过语句块来定义条件处理器(condition hander)的行为时，那么你必须首先定义2个本地变量(local variable)或者参数来接收SQLCODE和SQLSTATE。如果你没有将SQLSTATE或SQLCODE指定给本地的变量或者参数的话，调用该条件处理器的SQLCODE和SQLSTATE值将丢失。
　　
以下是一些条件处理器的Samples:
　　
CONTINUE handler 当DB2触发一个NOT FOUND错误(condition)时，以下的处理器(handler)将1赋给本地变量at_end.并且将控制权交给引起NOT FOUND错误语句的下一条语句，继续执行。
　　
DECLARE CONTINUE HANDLER FOR NOT FOUND SET at_end = 1;
　　
EXIT handler 在这个例子中，退出处理器(Exit Handler)的生效范围被限制在Label A限定的语句块(compound statement)中。如果表JAVELIN不存在，“DROP TABLE JAVELIN”将触发NO_TABLE错误(Condition), 退出处理器(Exit Handler)被激活，变量OUT_BUFFER被置值为“Table does not exist”，程序跳到C处的insert statement继续执行，忽略Label A限定的语句块(compound statement)中的其他语句。如果DROP statement能都执行成功，退出处理器(Exit Handler)将不被激活，执行将逐句执行下去，包括Label B限定的语句。
　　CREATE PROCEDURE EXIT_TEST ()
LANGUAGE SQL
BEGIN
   DECLARE OUT_BUFFER VARCHAR(80);
   DECLARE NO_TABLE CONDITION FOR SQLSTATE '42704';
   A: BEGIN
      DECLARE EXIT HANDLER FOR NO_TABLE
      BEGIN
        SET OUT_BUFFER='Table does not exist';
      END;
　　-- Drop potentially nonexistent table:
   DROP TABLE JAVELIN;
   B: SET OUT_BUFFER='Table dropped successfully'; END;
　　-- Copy OUT_BUFFER to some message table:
   C: INSERT INTO MESSAGES VALUES OUT_BUFFER;
END
　　UNDO handler 本例中，撤销处理器(undo handler)的生效范围被限定在Label A限定的语句块(compound statement)中。如果表JAVELIN不存在，DROP语句将触发NO_TABLE错误（condition），撤销处理器(undo handler)被激活，DROP语句之前的insert将被回滚，同时OUT_BUFFER被置值为“Table does not exist”，执行调转到Label C限定的insert语句，Label A限定的其他语句将被忽略。如果DROP语句能够执行成功，撤销处理器(undo handler)不会被激活，执行将逐句执行下去，包括B限定的语句。
　　
CREATE PROCEDURE UNDO_TEST () LANGUAGE SQL BEGIN DECLARE OUT_BUFFER VARCHAR(80); DECLARE NO_TABLE CONDITION FOR SQLSTATE '42704';
　　
A: BEGIN ATOMIC DECLARE UNDO HANDLER FOR NO_TABLE BEGIN SET OUT_BUFFER='Table does not exist'; END;
　　
INSERT INTO MESSAGES VALUES 'This message will be removed by a rollback.';
　　
-- Drop potentially nonexistent table: DROP TABLE JAVELIN;
　　B: SET OUT_BUFFER='Table dropped successfully'; END;
　　-- Copy OUT_BUFFER to some message table: C: INSERT INTO MESSAGES VALUES OUT_BUFFER; END
　　
Note:
撤销处理器(undo handler)只能被定义在ATOMIC语句块中。ATOMIC的含义：如果在语句块(compound statement)中一条语句出现了错误，该语句块（compound statement)中所有的语句将被rollback.NOT ATOMIC含义相反。
　　
说明：本文是根据IBM DB2 Application Development Guide翻译而来。