MySQLストアドプロシージャでエラーメッセージをスローして実行を終了するハンドラーを作成する方法

MySQLのストアドプロシージャ内で例外が発生した場合、適切なエラーメッセージをスローして例外を処理することが非常に重要です。例外を適切に処理しないと、その例外が原因でアプリケーション全体が失敗してしまう可能性があります。MySQLでは、エラーメッセージをスローして実行を終了するための「EXIT HANDLER」が用意されています。ここでは、主キー列に重複した値を挿入しようとするケースを例に、その使い方を解説します。

EXIT HANDLERを使ったストアドプロシージャの作成例

以下の例では、「DECLARE EXIT HANDLER FOR SQLEXCEPTION」を使用して、SQL例外が発生したときに「Got an error」というメッセージを表示し、処理を終了するストアドプロシージャを作成しています。

mysql> Delimiter //
mysql> Create Procedure Insert_Studentdetails3(S_Studentid INT, S_StudentName Varchar(20), S_Address Varchar(20))
    -> BEGIN
    -> DECLARE EXIT HANDLER FOR SQLEXCEPTION SELECT 'Got an error';
    -> INSERT INTO Student_detail
    -> (Studentid, StudentName, Address)
    -> Values(S_Studentid,S_StudentName,S_Address);
    -> Select * from Student_detail;
    -> END //
Query OK, 0 rows affected (0.00 sec)

mysql> Delimiter ;
mysql> CALL Insert_Studentdetails3(105, 'Mohan', 'Chandigarh');
+-----------+-------------+------------+
| Studentid | StudentName | address    |
+-----------+-------------+------------+
|       100 | Gaurav      | Delhi      |
|       101 | Raman       | Shimla     |
|       103 | Rahul       | Jaipur     |
|       104 | Ram         | Chandigarh |
|       105 | Mohan       | Chandigarh |
+-----------+-------------+------------+
5 rows in set (0.04 sec)
Query OK, 0 rows affected (0.06 sec)

このプロシージャを初回に呼び出したときは、Studentid「105」のデータが正常に挿入され、テーブル内の全データが結果セットとして表示されます。例外が発生していないため、ハンドラーは動作しません。

重複データ挿入時の動作

次に、同じ「studentid」の値を再度挿入しようとすると、主キー制約違反の例外が発生します。このとき、EXIT HANDLERが起動するため、プロシージャ内の「select * from student_detail」の結果セットは表示されず、エラーメッセージ「Got an error」のみが出力されて実行が終了します。

mysql> CALL Insert_Studentdetails3(105, 'Sohan', 'Bhopal');
+--------------+
| Got an error |
+--------------+
| Got an error |
+--------------+
1 row in set (0.00 sec)
Query OK, 0 rows affected (0.00 sec)

このように「DECLARE EXIT HANDLER FOR SQLEXCEPTION」を利用することで、例外発生時に任意のエラーメッセージを返しながら、ストアドプロシージャの実行を安全に終了させることができます。これにより、予期しない例外がアプリケーションに影響を与えるのを防ぎ、エラー発生時の挙動を明確に制御できます。