在程序的运行过程中可能会遇到问题,此时我们可以通过定义条件和处理程序来事先定义这些问题。
定义条件是指事先定义程序执行过程中遇到的问题,处理程序定义了在遇到这些问题时应当采取的处理方式和解决办法,保证存储过程和函数在遇到警告或错误时能继续执行,从而增强程序处理问题的能力,避免程序出现异常被停止执行。
下面将详细讲解如何定义条件和处理程序。
1. 定义条件
MySQL 中可以使用 DECLARE 关键字来定义条件。其基本语法如下:
DECLARE condition_name CONDITION FOR condition_value
condition_value: { mysql_error_code | SQLSTATE [VALUE] sqlstate_value
}
其中:
- condition_name 参数表示条件的名称;
- condition_value 参数表示条件的类型;
- sqlstate_value 参数和 mysql_error_code 参数都可以表示 MySQL 的错误。sqlstate_value 表示长度为 5 的字符串类型错误代码,mysql_error_code 表示数值类型错误代码。例如 ERROR 1146(42S02) 中,sqlstate_value 值是 42S02,mysql_error_code 值是 1146。
例 1
下面定义“ERROR 1146 (42S02)”这个错误,名称为 can_not_find。 可以用两种不同的方法来定义,代码如下:
//方法一:使用sqlstate_value DECLARE can_not_find CONDITION FOR SQLSTATE VALUE ‘42S02‘; //方法二:使用 mysql_error_code DECLARE can_not_find CONDITION FOR 1146;
2. 定义处理程序
MySQL 中可以使用 DECLARE 关键字来定义处理程序。其基本语法如下:
DECLARE handler_action HANDLER FOR condition_value [, condition_value] ... statement handler_action: { CONTINUE | EXIT | UNDO } condition_value: { mysql_error_code | SQLSTATE [VALUE] sqlstate_value | condition_name | SQLWARNING | NOT FOUND | SQLEXCEPTION }
其中,handler_action 参数指明错误的处理方式,该参数有 3 个取值。这 3 个取值分别是 CONTINUE、EXIT 和 UNDO。
- CONTINUE 表示遇到错误不进行处理,继续向下执行;
- EXIT 表示遇到错误后马上退出;
- UNDO 表示遇到错误后撤回之前的操作,MySQL 中暂时还不支持这种处理方式。
注意:通常情况下,执行过程中遇到错误应该立刻停止执行下面的语句,并且撤回前面的操作。但是,MySQL 中现在还不能支持 UNDO 操作。因此,遇到错误时最好执行 EXIT 操作。如果事先能够预测错误类型,并且进行相应的处理,那么可以执行 CONTINUE 操作。
condition_value 参数指明错误类型,该参数有 6 个取值:
- sqlstate_value:包含 5 个字符的字符串错误值;
- condition_name:表示 DECLARE 定义的错误条件名称;
- SQLWARNING:匹配所有以 01 开头的 sqlstate_value 值;
- NOT FOUND:匹配所有以 02 开头的 sqlstate_value 值;
- SQLEXCEPTION:匹配所有没有被 SQLWARNING 或 NOT FOUND 捕获的 sqlstate_value 值;
- mysql_error_code:匹配数值类型错误代码。
statement参数为程序语句段,表示在遇到定义的错误时,需要执行的一些存储过程或函数。
例 2
下面是定义处理程序的几种方式,代码如下:
//方法一:捕获 sqlstate_value DECLARE CONTINUE HANDLER FOR SQLSTATE ‘42S02‘ SET @info=‘CAN NOT FOUND‘; //方法二:捕获 mysql_error_code DECLARE CONTINUE HANDLER FOR 1146 SET @info=‘CAN NOT FIND‘; //方法三:先定义条件,然后调用 DECLARE can_not_find CONDITION FOR 1146; DECLARE CONTINUE HANDLER FOR can_not_find SET @info=‘CAN NOT FIND‘; //方法四:使用 SQLWARNING DECLARE EXIT HANDLER FOR SQLWARNING SET @info=‘ERROR‘; //方法五:使用 NOT FOUND DECLARE EXIT HANDLER FOR NOT FOUNDSET @info=‘CAN NOT FIND‘; //方法六:使用 SQLEXCEPTION DECLARE EXIT HANDLER FOR SQLEXCEPTION @info=‘ERROR‘;
上述代码是 6 种定义处理程序的方法。
- 捕获 sqlstate_value 值。如果遇到 sqlstate_value 值为 42S02,执行 CONTINUE 操作,并且输出“CAN NOT FIND”信息。
- 捕获 mysql_error_code 值。如果遇到 mysql_error_code 值为 1146, 执行 CONTINUE 操作,并且输出“CAN NOT FIND”信息。
- 先定义条件,然后再调用条件。这里先定义 can_not_find 条件,遇到 1146 错误就执行 CONTINUE 操作。
- 使用 SQLWARNING。SQLWARNING 捕获所有以 01 开头的 sqlstate_value 值,然后执行 EXIT 操作,并且输出“ERROR"信息。
- 使用 NOT FOUND。NOT FOUND 捕获所有以 02 开头的 sqlstate_value 值,然后执行 EXIT 操作,并且输出“CAN NOT FIND”信息。
- 使用 SQLEXCEPTION。 SQLEXCEPTION 捕获所有没有被 SQLWARNING 或 NOT FOUND 捕获的 sqlstate_value 值,然后执行 EXIT 操作,并且输出“ERROR”信息。
例 3
定义条件和处理顺序,具体的执行过程如下:
创建表t8, 如下
mysql> create table if not exists t8 -> ( -> id int (4) primary key -> ); Query OK, 0 rows affected, 1 warning (1.11 sec)
接着定义存储过程handlerdemo1, 无参
mysql> create procedure handlerdemo1() -> begin -> declare continue handler for sqlstate ‘23000‘ set @X2=1; -> set @X=1; -> insert into t8 values (1); -> set @X=2; -> insert into t8 values (1); -> set @X=3; -> insert into t8 values (1); -> end// Query OK, 0 rows affected (0.55 sec)
mysql> delimiter
调用存储过程, 然后输出参数@X的值
mysql> call handlerdemo1(); Query OK, 0 rows affected (0.44 sec)
mysql> select @X; +------+ | @X | +------+ | 3 | +------+ 1 row in set (0.06 sec)
上述代码中,@X 是一个用户变量,执行结果 @X 等于 3,这表明 MySQL 执行到程序的末尾。
如果DECLARE CONTINUE HANDLER FOR SQLSTATE ‘23000‘ SET @X2=1;
这一行不存在,第二个 INSERT 因 PRIMARY KEY 约束而失败之后,MySQL 已经采取 EXIT 策略,且 SELECT @X 已经返回 2。如下:
mysql> delimiter // mysql> create procedure handlerdemo2() -> begin -> set @X1=1; -> insert into t8 values(2); -> set @X1=2; -> insert into t8 values(2); -> set @X1=3; -> insert into t8 values(2); -> end// Query OK, 0 rows affected (0.26 sec) mysql> delimiter ; mysql> call handlerdemo2(); ERROR 1062 (23000): Duplicate entry ‘2‘ for key ‘PRIMARY‘ mysql> select @X1; +------+ | @X1 | +------+ | 2 | +------+ 1 row in set (0.00 sec)
可以看出, 去掉了定义的处理程序, 所以报出第二次insert t8操作的时候就会报出错误"ERROR 1062 (23000): Duplicate entry ‘1‘ for key ‘PRIMARY‘", 所以@X1的值就执行到此处的2
注意:@X和@X1 都是表示用户变量,使用 SET 语句为其赋值,用户变量与连接有关,一个客户端定义的变量不能被其他客户端所使用,当客户端退出时,该客户端连接的所有变量将自动释放。