MySQL存儲過程的異常處理

閱讀目錄：存儲過程的異常處理

• 定義異常處理
• 單一異常處理程序

　　　　continue

　　　　exit

• 多個異常處理程序

　　　　關於錯誤編號和SQLSTATE碼

　　　　使用3個處理程序

　　　　忽略某一異常的處理

• 異常處理的命名
• 異常傳播

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被聲明用於處理該條件，程序的進行將取決於條件類型。

 

二、單個異常處理程序

　　在輸出參數中包含出錯消息的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語句塊。

 

三、多個異常處理程序

　　可以在一個過程中定義多個異常處理程序，針對不同的錯誤進行不同的處理。

例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塊，因為里面什么都沒有，就類同於直接忽略。

 

四、異常處理的命名

　　為了提高可讀性，可以給某個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 |
+-------+

 

五、異常傳播

　　在嵌套塊的情況下，內部塊中發生異常了，首先由本塊的異常處理程序來處理，如果本塊沒有處理，則由外部塊的異常處理程序來處理。

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 |
+------------+--------+

解析：@processed=100說明內部塊里的異常傳播到了外部塊，交由外部塊的異常處理程序進行的處理。

牆裂建議：

　　當有多層begin end的時候，每層都應該有自己完善的異常處理，做到：自己的異常，自己這層去處理。