本教程將向您展示如何使用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;
這段代碼比以前的代碼顯然更可讀。
請注意,條件聲明必須出現在處理程式或游標聲明之前。