處理器類型
CONTINUE:執行處理器後繼續執行後續語句。
EXIT:執行處理器後離開當前 BEGIN ... END 區塊。
捕捉條件
| 條件 | 說明 |
SQLEXCEPTION | 所有 SQL 錯誤(不含 NOT FOUND) |
SQLWARNING | 所有 SQL 警告 |
NOT FOUND | 游標或查詢無資料返回(SQLSTATE '02000') |
SQLSTATE 'value' | 特定 SQLSTATE 代碼(如 '23000' 重複鍵) |
MySQL 錯誤碼 | 如 1062 (重複鍵)、1329 (游標無資料) |
常見範例
1. 記錄錯誤旗標並繼續
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION
SET l_error = 1;
2. 遇錯回滾並退出
DECLARE EXIT HANDLER FOR SQLEXCEPTION
BEGIN
ROLLBACK;
SELECT 'Error occurred – terminating';
END;
3. 處理重複鍵錯誤 (MySQL 1062 / SQLSTATE 23000)
DECLARE CONTINUE HANDLER FOR 1062
SELECT 'Duplicate key in index';
-- 或用 SQLSTATE
DECLARE CONTINUE HANDLER FOR SQLSTATE '23000'
SELECT 'Duplicate key in index';
4. 處理游標/查詢無資料
-- 命名條件
DECLARE CONTINUE HANDLER FOR NOT FOUND
SET l_done = 1;
-- SQLSTATE
DECLARE CONTINUE HANDLER FOR SQLSTATE '02000'
SET l_done = 1;
-- MySQL 錯誤碼
DECLARE CONTINUE HANDLER FOR 1329
SET l_done = 1;
實戰模板:帶完整錯誤處理的事務程序
CREATE PROCEDURE sp_transfer(IN from_id INT, IN to_id INT, IN amount DECIMAL(10,2), OUT success BOOL)
BEGIN
DECLARE EXIT HANDLER FOR SQLEXCEPTION
BEGIN
ROLLBACK;
SET success = FALSE;
END;
START TRANSACTION;
UPDATE accounts SET balance = balance - amount WHERE id = from_id AND balance >= amount;
IF ROW_COUNT() = 0 THEN
SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = 'Insufficient balance';
END IF;
UPDATE accounts SET balance = balance + amount WHERE id = to_id;
COMMIT;
SET success = TRUE;
END;
注意事項
- 處理器宣告必須在變數宣告**之後**、執行語句**之前**。
- 同一區塊可宣告多個處理器,優先順序:特定錯誤碼 > SQLSTATE > 類別 (SQLEXCEPTION) > NOT FOUND。
SIGNAL (MySQL 5.5+) 可主動拋出自訂錯誤,配合應用層捕捉。
- 避免在處理器中執行複雜邏輯,保持輕量。