MySQLストアドプロシージャでエラーメッセージを出しながら処理を継続するCONTINUE HANDLERの作成方法

はじめに：なぜ例外処理が重要なのか

MySQLのストアドプロシージャ内で例外（エラー）が発生した場合、適切なエラーメッセージを投げて対処することは非常に重要です。例外をハンドリングしないまま放置すると、その例外が原因でアプリケーション全体が予期せず失敗してしまう可能性があります。

MySQLでは、「エラーメッセージを表示しつつ、その後も処理を継続する」ためのハンドラーとして DECLARE CONTINUE HANDLER FOR SQLEXCEPTION が用意されています。本記事では、実際のサンプルコードを使ってこのハンドラーの使い方を解説します。

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

以下の例では、主キー（PRIMARY KEY）列に対して重複した値を挿入しようとした場合に、エラーメッセージを表示しながら実行を継続するプロシージャを作成しています。

mysql> DELIMITER //
mysql> Create Procedure Insert_Studentdetails(S_Studentid INT, S_StudentName Varchar(20), S_Address Varchar(20))
    -> BEGIN
    -> DECLARE CONTINUE 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.19 sec)

ポイント：DECLARE CONTINUE HANDLER の意味

• SQLEXCEPTION：すべてのSQL例外（エラー）を捕捉します。
• CONTINUE：例外が発生してもプロシージャの実行を中断せず、次のステートメントから処理を続行します。
• ここでは例外発生時に SELECT 'Got an error' を実行し、「Got an error」というメッセージを結果セットとして返します。

プロシージャの実行と動作確認

上記で作成したプロシージャを呼び出してみましょう。studentid 列に重複した値を挿入しようとした場合、「Got an error」というメッセージが表示され、その後も処理は継続されます。

mysql> Delimiter ;
mysql> CALL Insert_Studentdetails(100, 'Gaurav', 'Delhi');
+-----------+-------------+---------+
| Studentid | StudentName | address |
+-----------+-------------+---------+
| 100       | Gaurav      | Delhi   |
+-----------+-------------+---------+
1 row in set (0.11 sec)

Query OK, 0 rows affected (0.12 sec)

mysql> CALL Insert_Studentdetails(101, 'Raman', 'Shimla');
+-----------+-------------+---------+
| Studentid | StudentName | address |
+-----------+-------------+---------+
|      100 | Gaurav      | Delhi   |
|      101 | Raman       | Shimla  |
+-----------+-------------+---------+
2 rows in set (0.06 sec)

Query OK, 0 rows affected (0.12 sec)

重複値を挿入した場合の動作

次に、すでに存在する studentid = 101 と同じ値を挿入してみます。すると、INSERT文は主キー制約違反により失敗しますが、CONTINUE HANDLERによって「Got an error」が表示され、その後のSELECT文も正常に実行されていることがわかります。

mysql> CALL Insert_Studentdetails(101, 'Rahul', 'Jaipur');
+--------------+
| Got an error |
+--------------+
| Got an error |
+--------------+
1 row in set (0.03 sec)

+-----------+-------------+---------+
| Studentid | StudentName | address |
+-----------+-------------+---------+
|      100 | Gaurav      | Delhi   |
|      101 | Raman       | Shimla  |
+-----------+-------------+---------+
2 rows in set (0.04 sec)

Query OK, 0 rows affected (0.05 sec)

一方、重複していない新しいID（103）を挿入した場合は、エラーは発生せず、通常どおりデータが追加されます。

mysql> CALL Insert_Studentdetails(103, 'Rahul', 'Jaipur');
+-----------+-------------+---------+
| Studentid | StudentName | address |
+-----------+-------------+---------+
|     100  | Gaurav      | Delhi   |
|     101  | Raman       | Shimla  |
|     103  | Rahul       | Jaipur  |
+-----------+-------------+---------+
3 rows in set (0.08 sec)
Query OK, 0 rows affected (0.10 sec)

まとめ

DECLARE CONTINUE HANDLER FOR SQLEXCEPTION を使うことで、ストアドプロシージャ内で例外が発生しても、エラーメッセージをユーザーに通知しながら後続の処理を継続できます。これにより、アプリケーションが単一の例外によって突然停止するリスクを回避でき、より堅牢なデータベース処理を実現できます。なお、処理を中断したい場合は EXIT HANDLER を使用するなど、目的に応じてハンドラーの種類を使い分けることが重要です。