MySQL存儲過程的“異常處理”

Q：何為異常？

A：程序在執行過程中有可能出錯，運行時錯誤叫做異常。

默認情況下，當存儲過程運行出錯時，過程會立即終止，并打印系統錯誤消息。

實驗環境：

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 1mysql> 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 |
+------------+--------+
| 300 | 123321 |
+------------+--------+