MySQLトリガーでSIGNALステートメントを使う方法をわかりやすく解説

MySQLのSIGNALステートメントは、予期しない事態が発生した際のエラー処理を行うためのメカニズムです。必要に応じてアプリケーションを適切に終了させることもできます。基本的には、エラーハンドラに対してエラー情報を通知する役割を担います。

SIGNALステートメントの基本構文

SIGNAL SQLSTATE | condition_value
[SET signal_information_item = value_1,[, signal_information_item] = value_2,
etc;]

ここで、SIGNALキーワードにはSQLSTATE値、またはDECLARE CONDITIONステートメントで宣言された条件名を指定します。SIGNALステートメントを使用する際は、必ずSQLSTATE値、もしくはSQLSTATE値とともに定義された名前付き条件を指定しなければなりません。

SQLSTATE値のルール

SIGNALステートメントで使用するSQLSTATE値は、5文字の英数字コードで構成されます。独自のSQLSTATEコードを定義する際は、先頭を「00」にしてはいけません。「00」で始まる値は正常終了を意味するため、エラーの通知としては無効だからです。無効な値を指定すると「Bad SQLSTATE」エラーが発生します。

また、あらゆるエラーを包括的に捕捉したい場合は、SQLSTATE値として「45000」を指定します。これは「未処理のユーザー定義例外（unhandled user-defined exception）」を表す特別な値です。

MySQLトリガーでのSIGNALステートメントの実例

ここでは、student_ageテーブルにBEFORE INSERTトリガーを作成し、0未満の年齢データを挿入しようとした場合に、SIGNALステートメントを使ってエラーメッセージをスローする例を見てみましょう。

mysql> Create trigger before_insert_studentage BEFORE INSERT on
student_age FOR EACH ROW BEGIN IF NEW.age<0 then SIGNAL SQLSTATE
'45000' SET MESSAGE_TEXT = 'age less than 0'; END if; END; //
Query OK, 0 rows affected (0.12 sec)

mysql> Insert into student_age(age, name) values(-10,'gaurav')//
ERROR 1644 (45000): age less than 0

このトリガーでは、挿入される行（NEW.age）が0より小さいかどうかをIF文で判定し、条件を満たした場合にSIGNALステートメントによってSQLSTATE「45000」のエラーを発生させています。

実行結果からもわかるように、年齢として-10のような0未満の値を挿入しようとすると、「age less than 0」というエラーメッセージとともにINSERT処理が拒否されます。このようにSIGNALステートメントをトリガー内で活用することで、データ整合性を保つための入力チェックをデータベース側で強制的に行うことができます。