MySQL存储过程的“异常处理”

MySQL存储过程的“异常处理”

阅读目录：存储过程的异常处理

• 定义异常处理
• 单一异常处理程序

　　　　continue

　　　　exit

• 多个异常处理程序

　　　　关于错误编号和SQLSTATE码

　　　　使用3个处理程序

　　　　忽略某一异常的处理

• 异常处理的命名
• 异常传播

Q：何为异常？

A：程序在执行过程中有可能出错，运行时错误叫做异常。

默认情况下，当存储过程运行出错时，过程会立即终止，并打印系统错误消息。

 

实验环境：

扫描二维码关注公众号，回复： 875650 查看本文章

mysql> use TENNIS
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Database changed
mysql> show tables;
+-------------------+
| Tables_in_TENNIS  |
+-------------------+
| COMMITTEE_MEMBERS |
| MATCHES           |
| PENALTIES         |
| PLAYERS           |
| TEAMS             |
+-------------------+
5 rows in set (0.00 sec)

因为前面的实验多数用此数据库，库表结构就不再赘述了。

 

例：创建过程，插入一个重复的2号球队

mysql> delimiter $$
mysql> create procedure duplicate_teams(
    -> 　　out p_processed smallint)
    -> begin
    -> 　　set p_processed=1;
    -> 　　insert into TEAMS values(2,27,'third');
    -> 　　set p_processed=2;
    -> end $$
mysql> delimiter ;
mysql> call duplicate_teams(@processed);
ERROR 1062 (23000): Duplicate entry '2' for key 'PRIMARY'
mysql> select @processed;
+------------+
| @processed |
+------------+
| NULL       |
+------------+

解析：客户端调用存储过程，运行出错，打印错误信息，过程被终止，没有输出。

 

一、定义异常处理：

DECLARE ... HANDLER语句：

　　通过条件的定义和处理，可以在定义过程中，针对可能遇到的问题，做出相应的处理步骤。（也就是定义一个异常处理程序，指定当过程某条语句出错时，相应的采取什么操作）

DECLARE handler_action HANDLER
    FOR condition_value [, condition_value] ...
    statement

handler_action:
    CONTINUE
    | EXIT

condition_value:
    mysql_error_code
    | SQLSTATE [VALUE] sqlstate_value
    | condition_name
    | SQLWARNING
    | NOT FOUND
    | SQLEXCEPTION

注意：declare……handler语句必须出现在变量或条件声明的后面。

　　当某个错误（condition_value）发生时--->执行指定的语句（statement--记录错误信息），执行完之后再决定如何操作（handler_action）。

　　1、handler_action

　　　　continue：继续执行当前的程序(接着执行出错的SQL的下一条语句)；

　　　　exit：当前程序终止(退出当前declare所在的begin end)；

　　目前还不支持undo功能。

　　2、statement

　　　　可以是单条语句或复合语句。

　　3、condition_value指明handler被何种条件触发；如果条件被触发，却没有handler被声明用于处理该条件，程序的进行将取决于条件类型。

【top】 

 

二、单个异常处理程序

　　在输出参数中包含出错消息的SQLSTATE码。

例1：创建过程，插入一个重复的2号球队；continue

mysql> DELIMITER $$
mysql> CREATE  PROCEDURE small_mistake1( 
    -> 　　OUT error VARCHAR(5))  
    -> BEGIN
    -> 　　DECLARE CONTINUE HANDLER FOR SQLSTATE '23000' 
    -> 　　SET error = '23000';    #用来记录错误发生时的一些信息
    ->          
    -> 　　select error;
    -> 　　SET error = '00000';
    -> 　　select error;
    ->    INSERT INTO TEAMS VALUES(2,27,'third');  #会出错的语句
    ->    SET error = '23001';     
    -> END$$
mysql> DELIMITER ;
mysql> call small_mistake1(@a);
+-------+
| error |
+-------+
| NULL  |
+-------+

+-------+
| error |
+-------+
| 00000 |
+-------+

mysql> select @a;
+-------+
| @a    |
+-------+
| 23001 |
+-------+

实验示例解析：

　　begin end块里，定义declare……handler语句用来捕获错误(待命ing)，select、set、select顺序执行，insert语句出错，SQLSTATE码23000，捕获，进行异常处理(赋值记录)，结束后会继续执行出错的insert语句的下一条语句……

 

例2：创建过程，插入一个重复的2号球队；exit

mysql> DELIMITER $$
mysql> CREATE  PROCEDURE small_mistake2( 
    -> 　　OUT error VARCHAR(5))  
    -> BEGIN
    -> 　　DECLARE EXIT HANDLER FOR SQLSTATE '23000' 
    -> 　　SET error = '23000';
    ->                 
    -> 　　select error;
    -> 　　SET error = '00000';
    -> 　　select error;
    -> 　　INSERT INTO TEAMS VALUES(2,27,'third');
    -> 　　SET error = '23001';     
    -> END$$
mysql> DELIMITER ;
mysql> call small_mistake2(@a);
+-------+
| error |
+-------+
| NULL  |
+-------+

+-------+
| error |
+-------+
| 00000 |
+-------+

mysql> select @a;
+-------+
| @a    |
+-------+
| 23000 |
+-------+

与例1唯一不同的是：handler_action选择的是exit，表明在异常处理结束后不会继续执行错误语句后面的语句，直接退出begin end语句块。

 【top】

 

三、多个异常处理程序

　　可以在一个过程中定义多个异常处理程序，针对不同的错误进行不同的处理。

例1：

mysql> INSERT INTO TEAMS VALUES(2,27,'third',5);
ERROR 1136 (21S01): Column count doesn't match value count at row 1

mysql> DELIMITER $$
mysql> CREATE  PROCEDURE small_mistake3( 
    -> 　　OUT error VARCHAR(5))  
    -> BEGIN
    -> 　　DECLARE CONTINUE HANDLER FOR SQLSTATE '23000'  
    -> 　　SET error = '23000'; 
    ->   
    -> 　　DECLARE CONTINUE HANDLER FOR SQLSTATE '21S01' 
    -> 　　SET error = '21S01';
    ->     
    ->　　 INSERT INTO TEAMS VALUES(2,27,'third',5);  #错误语句   
    -> END$$
mysql> DELIMITER ;
mysql> call small_mistake3(@error);
mysql> select @error;
+--------+
| @error |
+--------+
| 21S01  |
+--------+

解析：

　　如果SQLSTATE码是23000，异常处理执行SET error = '23000'；

　　如果SQLSTATE码是21S01，异常处理执行SET error = '21S01'；

当然，异常处理，可以是自定义，一般都是上述方式的错误信息记录。

 

示例3中的异常处理程序也可以使用错误编号

例如：

DECLARE CONTINUE HANDLER FOR 1062 
        SET error = '23000';     

DECLARE CONTINUE HANDLER FOR 1136 
        SET error = '21S01';

 

关于错误编号和SQLSTATE码：

　　每个MySQL错误都有一个唯一的数字错误编号(mysql_error_code)，每个错误又对应一个5字符的SQLSTATE码(ANSI SQL 采用)。

SQLSTATE码对应的处理程序：

　　1、SQLWARNING处理程序：以‘01’开头的所有sqlstate码与之对应；

　　2、NOT FOUND处理程序：以‘02’开头的所有sqlstate码与之对应；

　　3、SQLEXCEPTION处理程序：不以‘01’或‘02’开头的所有sqlstate码，也就是所有未被SQLWARNING或NOT FOUND捕获的SQLSTATE(常遇到的MySQL错误就是非‘01’、‘02’开头的)

注意：‘01’、‘02’开头和‘1’、‘2’开头是有区别的，是不一样的错误sqlsate码。

 

当不想为每个错误都定义一个处理程序时，可以使用3个处理程序

　　e.g：DECLARE CONTINUE HANDLER FOR SQLWARNING,NOT FOUND,SQLEXCEPTION  

mysql> DELIMITER $$
mysql> CREATE  PROCEDURE small_mistake4( 
    -> 　　OUT error VARCHAR(5))  
    -> BEGIN
    -> 　　DECLARE CONTINUE HANDLER FOR SQLWARNING,NOT FOUND,SQLEXCEPTION  
    -> 　　SET error = 'xxxxx';  
    ->          
    -> 　　INSERT INTO teams VALUES(2,27,'third');   
    -> END$$
mysql> DELIMITER ;
mysql> call small_mistake4(@a);
mysql> select @a;
+-------+
| @a    |
+-------+
| xxxxx |
+-------+

 

如果是在定义处理程序时，想忽略某一个条件

e.g：DECLARE CONTINUE HANDLER FOR SQLWARNING BEGIN END;

也就是说，当遇到SQLWARNING的问题时，进行的异常处理是begin end块，因为里面什么都没有，就类同于直接忽略。

 【top】

 

四、异常处理的命名

　　为了提高可读性，可以给某个sqlstate代码或mysql错误代码一个名字，并且在后面的异常处理程序中使用这个名字。

DECLARE condition_name CONDITION FOR condition_value

condition_value:
    mysql_error_code
   |SQLSTATE [VALUE] sqlstate_value

1、未命名的基本格式：

BEGIN
　　DECLARE CONTINUE HANDLER FOR 1051
    -- body of handler
END;

 

2、有命名的基本格式：

BEGIN
　　DECLARE no_such_table CONDITION FOR 1051;
　　DECLARE CONTINUE HANDLER FOR no_such_table
    -- body of handler
END;

mysql> DELIMITER $$
mysql> CREATE  PROCEDURE small_mistake5( 
    -> 　　OUT error VARCHAR(5))  
    -> BEGIN
    -> 　　DECLARE non_unique CONDITION FOR SQLSTATE '23000';  
    -> 　　DECLARE CONTINUE HANDLER FOR non_unique
    -> 　　begin 
    -> 　　　　SET error = '23000';
    -> 　　　　select error;
    -> 　　end;
    ->
    -> 　　INSERT INTO TEAMS VALUES(2,27,'third');  #会出错语句  
    -> END$$
mysql> DELIMITER ;
mysql> call small_mistake5(@error);
+-------+
| error |
+-------+
| 23000 |
+-------+

 【top】

 

五、异常传播

　　在嵌套块的情况下，内部块中发生异常了，首先由本块的异常处理程序来处理，如果本块没有处理，则由外部块的异常处理程序来处理。

mysql> DELIMITER $$
mysql> CREATE  PROCEDURE small_mistake6()  
    -> BEGIN    
    -> 　　DECLARE CONTINUE HANDLER FOR SQLSTATE '23000' 
    -> 　　SET @processed = 100;  
    ->
    -> 　　BEGIN      
    -> 　　　　DECLARE CONTINUE HANDLER FOR SQLSTATE '21000' 
    -> 　　　　SET @processed = 200;    
    -> 　　　　INSERT INTO TEAMS VALUES(2,27,'third');   
    -> 　　　　set @test=123321;  
    ->    END;
    -> END$$
mysql> DELIMITER ;
mysql> call small_mistake6;
mysql> select @processed,@test;
+------------+--------+
| @processed | @test |
+------------+--------+
| 100 | 123321 |
+------------+--------+

解析：@processed=100说明内部块里的异常传播到了外部块，交由外部块的异常处理程序进行的处理。

墙裂建议：

　　当有多层begin end的时候，每层都应该有自己完善的异常处理，做到：自己的异常，自己这层去处理。

【top】

@author：http://www.cnblogs.com/geaozhang/

-----------------------------------------------------------------

其实，在真实使用中，我们一定是把产生异常对应的记录的基本信息需要获取到并保存到表中已备后续跟踪解决使用，如下

[sql]  view plain  copy

1. #引用前面定义的条件名称并做赋值处理。注意要放到定义游标之后。分别对异常和告警做不同处理。  
2.     #另：@@error_count和@@warning_count是会话变量，除非你修改，否则还是记录你的业务信息有意义  
3.     DECLARE EXIT HANDLER FOR SQLEXCEPTION   
4.     BEGIN  
5.         INSERT INTO tb_err_info(exception_content,create_time)   
6.         VALUES (concat('id为',@u_group_id,' 的记录产生异常，并且执行到第' ,@STEP_WHERE ,'步操作，请结合步骤分析id是企业抑或用户id'),NOW());  
7.     END;  
8.   
9. SET @STEP_WHERE = 1;        #用来追踪流程走到第几步  
10.   
11.     SELECT count(1)   
12.         INTO LOOP_COUNT  
13.         FROM tb_mapping_cm_group ;  
14.     SET @LOOP_STEP = 0;  
15. SET @STEP_WHERE = 2;  
16.     #首先处理用户组到企业和部门表的同步  
17.     OPEN cursor_user_group;  
18.     WHILE @LOOP_STEP < LOOP_COUNT DO  
19.         FETCH cursor_user_group INTO GROUP_ID, GROUP_NAME, GROUP_TOP_ID, CREATE_TIME, UPDATE_TIME, DEAL_TYPE;  
20.         #如果group_top_id是空，说明为企业信息，插入企业表和企业映射翻译表  
21.         IF GROUP_TOP_ID IS NULL OR GROUP_TOP_ID = '' THEN  
22.             INSERT INTO nv_enterprise (enterprise_name, status)   
23.             VALUES(GROUP_NAME, 1) ;  
24. SET @STEP_WHERE = 3;  
25.             #从information_schema获取尚未commit的自增长字段的最新值  
26.             SELECT A.AUTO_INCREMENT   
27.                 INTO TMP_EID  
28.                 FROM information_schema.`TABLES` A   
29. <span style="color:#FF6666;">#这里制造一个异常，也就是会into多条记录到一个变量中的错误</span>  
30. #            WHERE A.TABLE_NAME = 'nv_enterprise'   
31. #                AND A.TABLE_SCHEMA= 'pexipmeetingcm'  
32. ;  
33. SET @STEP_WHERE = 4;  
34.             INSERT INTO tb_mapping_trans_cm_ent(ent_id, user_group_id, status)   
35.             VALUES (TMP_EID, GROUP_ID, '1');  
36. SET @STEP_WHERE = 5;  
37.         #否则就认为是部门级记录，插入到部门表和部门映射翻译表  
38.         ELSE  
39.             #需要先根据GROUP_TOP_ID查询对应企业编码，再插入到部门表  
40.             SELECT a.ent_id  
41.                 INTO TMP_EID  
42.                 FROM tb_mapping_trans_cm_ent a  
43.              WHERE a.user_group_id = GROUP_TOP_ID;  
44. SET @STEP_WHERE = 6;  
45. SET @u_group_id = GROUP_ID;  
46.             INSERT INTO nv_department (name, enterprise_id)   
47.             VALUES(GROUP_NAME, TMP_EID) ;  
48. SET @STEP_WHERE = 7;  
49.             #从information_schema获取尚未commit的自增长字段的最新值  
50.             SELECT A.AUTO_INCREMENT   
51.                 INTO TMP_DID  
52.                 FROM information_schema.`TABLES` A   
53.              WHERE A.TABLE_NAME = 'nv_department'   
54.                  AND A.TABLE_SCHEMA= 'pexipmeetingcm';  
55. SET @STEP_WHERE = 8;  
56.             INSERT INTO tb_mapping_trans_cm_dept(dept_id, ent_id, user_group_id, user_group_parent_id, status)   
57.             VALUES (TMP_DID, TMP_EID, GROUP_ID, GROUP_TOP_ID, '1');  
58. SET @STEP_WHERE = 9;  
59.         END IF;  
60.         SET @LOOP_STEP = @LOOP_STEP + 1;  
61.     COMMIT;  
62.     END WHILE;  
63.     CLOSE cursor_user_group;  

-----------------------------------------------------

有几种错误处理的声明形式： 
§ 如果任何错误（不是 NOT FOUND ） , 设置 l_error 为 1 后继续执行： 
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION 
SET l_error=1; 
§ 如果发生任何错误（不是 NOT FOUND）， 执行 ROLLBACK和产生一条错误消息后退出当前块或存储过程。 
DECLARE EXIT HANDLER FOR SQLEXCEPTION 
BEGIN 
ROLLBACK; 
SELECT 'Error occurred – terminating'; 
END; 
§ 如果 MySQL 1062错误 (重复的健值 )发生，执行 SELECT语句（向调用程序发一条消息）后继续执行 
DECLARE CONTINUE HANDER FOR 1062 
SELECT 'Duplicate key in index'; 
§ 如果 SQLSTATE 2300错误 (重复的健值 )发生，执行 SELECT语句（向调用程序发一条消息）后继续执行 
DECLARE CONTINUE HANDER FOR SQLSTATE '23000' 
SELECT 'Duplicate key in index'; 
§ 当游标或者 SQL 选择语句没有返回值时，设置 l_done=1 后继续执行 
DECLARE CONTINUE HANDLER FOR NOT 
FOUND 
SET l_done=1; 
§ 此例除了用 SQLSTATE 变量而不是命名条件以外，跟前一个例子一样 
DECLARE CONTINUE HANDLER FOR SQLSTATE '02000 ' 
SET l_done=1; 
§ 此例除了用 MySQL 的错误码变量而不是命名条件或者 SQLSTATE 变量以外，跟前两个例子一样
DECLARE CONTINUE HANDLER FOR 1329 

SET l_done=1;

DECLARE CONTINUE HANDLER FOR NOT FOUND SET not_found = 1; -- 如果未找到数据 将标记改为不可用

DECLARE EXIT HANDLER FOR SQLEXCEPTION ROLLBACK;  -- 异常跳出

start TRANSACTION;

COMMIT;