SQLSTATEを使ったMySQLハンドラーの書き方：ストアドプロシージャでエラー発生時に実行を終了する方法

MySQLのストアドプロシージャ内で例外が発生した場合、適切なエラーメッセージを投げて対処することが非常に重要です。例外をハンドリングせずに放置すると、その例外が原因でアプリケーション自体が失敗してしまう可能性があるためです。MySQLでは、デフォルトのMySQLエラーに対してSQLSTATEを利用し、実行を終了させるハンドラー（EXIT HANDLER）を提供しています。

以下の例では、主キー列に重複した値を挿入しようとしたケースを通じて、このハンドラーの動作を確認します。

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

mysql> DELIMITER //
mysql> CREATE PROCEDURE Insert_Studentdetails4(S_Studentid INT, S_StudentName VARCHAR(20), S_Address VARCHAR(20), OUT got_error INT)
    -> BEGIN
    -> DECLARE EXIT HANDLER FOR 1062 SET got_error = 1;
    -> 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)

このプロシージャでは、「DECLARE EXIT HANDLER FOR 1062 SET got_error = 1;」という宣言によって、MySQLエラー番号1062（主キーや一意制約における重複エラー）が発生した時点で変数got_errorに1を設定し、プロシージャの実行を即座に終了させます。

なお、エラー番号の代わりにSQLSTATEコードを直接指定することも可能です。エラー1062に対応するSQLSTATEは「23000」であるため、次のように記述しても同じ動作になります。

DECLARE EXIT HANDLER FOR SQLSTATE '23000' SET got_error = 1;

重複データ挿入時の動作確認

続いて、列「studentid」に重複した値を追加しようとしてみます。

mysql> DELIMITER ;
mysql> CALL Insert_Studentdetails4(104, 'Ram', 'Chandigarh', @got_error);

Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @got_error;
+------------+
| @got_error |
+------------+
|         1 |
+------------+
1 row in set (0.00 sec)

結果を見ると、重複した値を挿入しようとした時点で実行が終了していることがわかります。プロシージャ内に記述された「SELECT * FROM Student_detail」の結果セットは返されず、重複値の挿入に関するデフォルトのMySQLエラー（エラー番号1062）だけが通知されます。同時に、ハンドラーによって変数got_errorには1が設定されており、呼び出し元でエラーの発生有無を判定できるようになっています。

このようにEXIT HANDLERを活用することで、ストアドプロシージャ内で予期しないエラーが発生した場合でも、アプリケーション側へ適切な情報を返しながら、安全に処理を終了させることができます。