MySQL  存儲過程錯誤處理

如何使用MySQL處理程序來處理在存儲過程中遇到的異常或錯誤。

當存儲過程中發生錯誤時，重要的是適當處理它，例如：繼續或退出當前代碼塊的執行，並發出有意義的錯誤消息。

MySQL提供了一種簡單的方法來定義處理從一般條件(如警告或異常)到特定條件(例如特定錯誤代碼)的處理程序。

聲明處理程序

要聲明一個處理程序，您可以使用DECLARE HANDLER語句如下：

DECLARE action HANDLER FOR condition_value statement;

如果條件的值與condition_value匹配，則MySQL將執行statement，並根據該操作繼續或退出當前的代碼塊。

操作(action)接受以下值之一：

• CONTINUE：繼續執行封閉代碼塊(BEGIN ... END)。
• EXIT：處理程序聲明封閉代碼塊的執行終止。

condition_value指定一個特定條件或一類激活處理程序的條件。condition_value接受以下值之一：

• 一個MySQL錯誤代碼。
• 標准SQLSTATE值或者它可以是SQLWARNING，NOTFOUND或SQLEXCEPTION條件，這是SQLSTATE值類的簡寫。NOTFOUND條件用於游標或SELECT INTO variable_list語句。
• 與MySQL錯誤代碼或SQLSTATE值相關聯的命名條件。

該語句可以是一個簡單的語句或由BEGIN和END關鍵字包圍的復合語句。

MySQL錯誤處理示例

我們來看幾個聲明處理程序的例子。

以下處理程序意味着如果發生錯誤，則將has_error變量的值設置為1並繼續執行。

DECLARE CONTINUE HANDLER FOR SQLEXCEPTION SET has_error = 1;

以下是另一個處理程序，如果發生錯誤，回滾上一個操作，發出錯誤消息，並退出當前代碼塊。 如果在存儲過程的BEGIN END塊中聲明它，則會立即終止存儲過程。

DECLARE EXIT HANDLER FOR SQLEXCEPTION
BEGIN
ROLLBACK;
SELECT 'An error has occurred, operation rollbacked and the stored procedure was terminated';
END;

以下處理程序如果沒有更多的行要提取，在光標或SELECT INTO語句的情況下，將no_row_found變量的值設置為1並繼續執行。

DECLARE CONTINUE HANDLER FOR NOT FOUND SET no_row_found = 1;

以下處理程序如果發生重復的鍵錯誤，則會發出MySQL錯誤1062。 它發出錯誤消息並繼續執行。

DECLARE CONTINUE HANDLER FOR 1062
SELECT 'Error, duplicate key occurred';

存儲過程中的MySQL處理程序示例

首先，為了更好地演示，我們創建一個名為article_tags的新表：

USE testdb;
CREATE TABLE article_tags(
    article_id INT,
    tag_id     INT,
    PRIMARY KEY(article_id,tag_id)
);

article_tags表存儲文章和標簽之間的關系。每篇文章可能有很多標簽，反之亦然。 為了簡單起見，我們不會在article_tags表中創建文章(article)表和標簽(tags)表以及外鍵。

接下來，創建一個存儲過程，將文章的id和標簽的id插入到article_tags表中：

USE testdb;
DELIMITER $$

CREATE PROCEDURE insert_article_tags(IN article_id INT, IN tag_id INT)
BEGIN

 DECLARE CONTINUE HANDLER FOR 1062
 SELECT CONCAT('duplicate keys (',article_id,',',tag_id,') found') AS msg;

 -- insert a new record into article_tags
 INSERT INTO article_tags(article_id,tag_id)
 VALUES(article_id,tag_id);

 -- return tag count for the article
 SELECT COUNT(*) FROM article_tags;
END$$
DELIMITER ;

然后，通過調用insert_article_tags存儲過程，為文章ID為1添加標簽ID：1,2和3，如下所示：

CALL insert_article_tags(1,1);
CALL insert_article_tags(1,2);
CALL insert_article_tags(1,3);

之后，嘗試插入一個重復的鍵來檢查處理程序是否真的被調用。

CALL insert_article_tags(1,3);

執行上面查詢語句，得到以下結果

mysql> CALL insert_article_tags(1,3);
+----------------------------+
| msg                        |
+----------------------------+
| duplicate keys (1,3) found |
+----------------------------+
1 row in set

+----------+
| COUNT(*) |
+----------+
|        3 |
+----------+
1 row in set

Query OK, 0 rows affected

執行后會收到一條錯誤消息。 但是，由於我們將處理程序聲明為CONTINUE處理程序，所以存儲過程繼續執行。因此，最后獲得了文章的標簽計數值為：3。

如果將處理程序聲明中的CONTINUE更改為EXIT，那么將只會收到一條錯誤消息。如下查詢語句 

 

DELIMITER $$

CREATE PROCEDURE insert_article_tags_exit(IN article_id INT, IN tag_id INT)
BEGIN

 DECLARE EXIT HANDLER FOR SQLEXCEPTION 
 SELECT 'SQLException invoked';

 DECLARE EXIT HANDLER FOR 1062 
        SELECT 'MySQL error code 1062 invoked';

 DECLARE EXIT HANDLER FOR SQLSTATE '23000'
 SELECT 'SQLSTATE 23000 invoked';

 -- insert a new record into article_tags
 INSERT INTO article_tags(article_id,tag_id)
   VALUES(article_id,tag_id);

 -- return tag count for the article
 SELECT COUNT(*) FROM article_tags;
END $$
DELIMITER ;

執行上面查詢語句，得到以下結果 

mysql> CALL insert_article_tags_exit(1,3);
+-------------------------------+
| MySQL error code 1062 invoked |
+-------------------------------+
| MySQL error code 1062 invoked |
+-------------------------------+
1 row in set

Query OK, 0 rows affected

MySQL處理程序優先級

如果使用多個處理程序來處理錯誤，MySQL將調用最特定的處理程序來處理錯誤。

錯誤總是映射到一個MySQL錯誤代碼，因為在MySQL中它是最具體的。 SQLSTATE可以映射到許多MySQL錯誤代碼，因此它不太具體。 SQLEXCPETION或SQLWARNING是SQLSTATES類型值的縮寫，因此它是最通用的。

假設在insert_article_tags_3存儲過程中聲明三個處理程序，如下所示：

DELIMITER $$

CREATE PROCEDURE insert_article_tags_3(IN article_id INT, IN tag_id INT)
BEGIN

 DECLARE EXIT HANDLER FOR 1062 SELECT 'Duplicate keys error encountered';
 DECLARE EXIT HANDLER FOR SQLEXCEPTION SELECT 'SQLException encountered';
 DECLARE EXIT HANDLER FOR SQLSTATE '23000' SELECT 'SQLSTATE 23000';

 -- insert a new record into article_tags
 INSERT INTO article_tags(article_id,tag_id)
 VALUES(article_id,tag_id);

 -- return tag count for the article
 SELECT COUNT(*) FROM article_tags;
END $$
DELIMITER ;

我們嘗試通過調用存儲過程將重復的鍵插入到article_tags表中：

CALL insert_article_tags_3(1,3);

如下，可以看到MySQL錯誤代碼處理程序被調用。 

mysql> CALL insert_article_tags_3(1,3);
+----------------------------------+
| Duplicate keys error encountered |
+----------------------------------+
| Duplicate keys error encountered |
+----------------------------------+
1 row in set

Query OK, 0 rows affected

使用命名錯誤條件

從錯誤處理程序聲明開始，如下 

DECLARE EXIT HANDLER FOR 1051 SELECT 'Please create table abc first';
SELECT * FROM abc;

1051號是什么意思？ 想象一下，你有一個大的存儲過程代碼使用了好多類似這樣的數字; 這將成為維護代碼的噩夢。

幸運的是，MySQL為我們提供了聲明一個命名錯誤條件的DECLARE CONDITION語句，它與條件相關聯。

DECLARE CONDITION語句的語法如下：

DECLARE condition_name CONDITION FOR condition_value;

condition_value可以是MySQL錯誤代碼，例如：1015或SQLSTATE值。 condition_value由condition_name表示。

 聲明后，可以參考condition_name，而不是參考condition_value。

所以可以重寫上面的代碼如下：

DECLARE table_not_found CONDITION for 1051;
DECLARE EXIT HANDLER FOR  table_not_found SELECT 'Please create table abc first';
SELECT * FROM abc;

這段代碼比以前的代碼顯然更可讀。

請注意，條件聲明必須出現在處理程序或游標聲明之前