在存储过程执行的过程中,经常因为数据或者其他问题产生异常(condition)。根据业务逻辑,存储过程应该对异常进行相应处理或直接返回给调用者。此处暂且将condition译为异常以方便读者理解。实际上有些异常(condition)并非是由于错误引起的,下面将详细讲述。
当存储过程中的语句返回的SQLSTATE值超过00000的时候,就表明在存储过程中产生了一个异常(condition),它表示出现了错误、数据没有找到或者出现了警告。为了响应和处理存储过程中出现的异常,我们必须在存储过程体中声明异常处理器(condition handler),它可以决定存储过程怎样响应一个或者多个已定义的异常或者预定义异常组。声明条件处理器的语法如下,它会位于变量声明和游标声明之后:
DECLARE handler-type HANDLER FOR condition handler-action
异常处理器类型(handler-type)有以下几种:
CONTINUE 在处理器操作完成之后,会继续执行产生这个异常语句之后的下一条语句。
EXIT 在处理器操作完成之后,存储过程会终止,并将控制返回给调用者。
UNDO 在处理器操作执行之前,DB2会回滚存储过程中执行的SQL操作。在处理器操作完成之后,存储过程会终止,并将控制返回给调用者。
异常处理器可以处理基于特定SQLSTATE值的定制异常,或者处理预定义异常的类。预定义的3种异常如下所示:
NOT FOUND 标识导致SQLCODE值为+100或者SQLSATE值为02000的异常。这个异常通常在SELECT没有返回行的时候出现。
SQLEXCEPTIOIN 标识导致SQLCODE值为负的异常。
SQLWARNING 标识导致警告异常或者导致+100以外的SQLCODE正值的异常。
如果产生了NOT FOUND 或者SQLWARNING异常,并且没有为这个异常定义异常处理器,那么就会忽略这个异常,并且将控制流转向下一个语句。如果产生了SQLEXCEPTION异常,并且没有为这个异常定义异常处理器,那么存储过程就会失败,并且会将控制流返回调用者。
以下示例声明了两个异常处理器。 EXIT处理器会在出现SQLEXCEPTION 或者SQLWARNING异常的时候被调用。EXIT处理器会在终止SQL程序之前,将名为stmt的变量设为"ABORTED",并且将控制流返回给调用者。UNDO处理器会将控制流返回给调用者之前,回滚存储过程体中已经完成的SQL操作。
DECLARE EXIT HANDLER FOR SQLEXCEPTION, SQLWARNING SET stmt = 'ABORTED'; |
DECLARE UNDO HANDLER FOR NOT FOUND; |
如果预定义异常集不能满足需求,就可以为特定的SQLSTATE值声明定制异常,然后再为这个定制异常声明处理器。语法如下:
DECLARE unique-name CONDITION FOR SQLSATE 'sqlstate' |
处理器可以由单独的存储过程语句定义,也可以使用由BEGIN…END块界定的复合语句定义。注意在执行符合语句的时候,SQLSATE和SQLCODE的值会被改变,如果需要保留异常前的SQLSATE和SQLCODE,就需要在执行复合语句的第一个语句把SQLSATE和SQLCODE赋予本地变量或参数。
通常,我们会为存储过程定义一个执行状态的输出参数(例如:poGenStatus)。
根据这个输出状态,可以表明存储过程是否正确执行完毕。我们需要定义一些异常处理器为这个输出参数赋值。
异常处理例子:
create table test(id int, num int)
insert into test values(1,30),(2,40),(3,50)
没有定义异常处理的时候:
create procedure Test(
OUT sum int
)
LANGUAGE SQL
BEGIN
declare v_num int;
select id into v_num from test where id > 1;
set sum = v_num;
END@
调用时出现这样的结果
call Test(?)
SQL0811N 标量全查询、SELECT INTO 语句或 VALUES INTO 语句的结果有多行。
SQLSTATE=21000
Statement processed with ERROR.
有异常处理的时候:
create procedure Test(
OUT sum int
)
LANGUAGE SQL
BEGIN
DECLARE SQLCODE INT;
DECLARE v_errCode INT DEFAULT 0;
DECLARE v_num int;
--------------------------------------------------------
--定义异常处理
--------------------------------------------------------
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION
BEGIN
SET v_errCode = SQLCODE;
END;
select id into v_num from test where id > 1;
set sum = v_num;
RETURN v_errCode;
END@
调用时的结果:
call Test(?)
completed successfully.
输出参数的值
--------------------------
参数名: SUM
参数值: -
返回状态 = -811
Statement processed successfully in 0.23 secs.
可以看到,没有异常处理的时候,程序出现错误就崩溃了,并不能继续正常运行。而有异常处理的时候,出现错误程序会继续正常运行,并返回错误代码。