ストアドプロシージャでMySQLハンドラーを作成するにはどうすればよいですか？

MySQLストアドプロシージャにおける例外処理の重要性

ストアドプロシージャの実行中に例外が発生した場合、適切なエラーメッセージを返して対処することが非常に重要です。もし例外をハンドリングせずに放置すると、その例外が原因でアプリケーション全体が予期せず失敗してしまう恐れがあります。

MySQLでは、ストアドプロシージャ内で発生した例外を処理するための仕組みとして「ハンドラー」が用意されています。ハンドラーを使うことで、エラー発生時の挙動（処理を続けるか、中断するか）を明示的に制御できます。

MySQLハンドラーの4つの基本形

ストアドプロシージャで利用できる代表的なハンドラーには、以下の4種類があります。

1. エラーメッセージを表示して処理を続行する

DECLARE CONTINUE HANDLER FOR SQLEXCEPTION SELECT 'got an error';

このハンドラーは、エラーメッセージを出力した後も、後続の処理をそのまま続行します。

2. 変数にフラグを設定して処理を続行する

DECLARE CONTINUE HANDLER FOR SQLEXCEPTION SET got_error = 1;

このハンドラーは、変数 got_error に 1 を設定した後も、処理を続行します。フラグ変数の値を後から判定することで、エラーが発生したかどうかを把握できます。

3. 変数にフラグを設定して処理を終了する

DECLARE EXIT HANDLER FOR SQLEXCEPTION SET got_error = 1;

このハンドラーは、変数 got_error に 1 を設定した上で、その時点で処理を終了します。エラー発生後に以降の処理を実行させたくない場合に有効です。

4. SQLSTATEを指定して処理を終了する

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

このハンドラーは、特定のSQLSTATEコードに対してのみ反応します。変数 got_error に 1 を設定し、MySQLのデフォルトのエラーメッセージを出力して処理を終了します。なお、'23000' は一意制約違反や外部キー制約違反など、整合性制約に関するエラーを表す標準的なSQLSTATEコードです。

CONTINUEハンドラーとEXITハンドラーの違い

両者の違いは、例外発生後の動作にあります。CONTINUEハンドラーは、ハンドラーの処理を実行した後もストアドプロシージャの実行を続けます。一方、EXITハンドラーは、ハンドラーの処理を実行した時点でストアドプロシージャを抜けます。

軽微なエラーなら記録だけ残して処理を継続したい場合はCONTINUE、致命的なエラーなら即座に中断したい場合はEXITというように、状況に応じて使い分けることが大切です。