这段时间正在做些和DB2相关的东西，发现DB2的资料不是很好找，所以看Application development guide的时候，顺便翻译了这段。希望对大家有所帮组。
DB2 条件处理器定义（Condition Handler Declarations）
可以在SQL procedure中定义一个条件处理器（Handler）来处理特殊的行为。下面是一个通用的处理器（Handler）定义格式：
DECLARE handler-type HANDLER FOR condition
SQL-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翻译而来。
2005-9-8 15:12:11
|
资料下载 关于本站