SQL Server での RAISERROR の使用方法

SQL Server の RAISERROR は、カスタム エラー メッセージを発行する T-SQL ステートメントです。これにより、カスタム エラー メッセージをキャプチャして作成し、アプリケーションまたはクライアントに返します。RAISERROR ステートメントの基本構文は次のとおりです。RAISERROR ({‘error_message’, ‘severity’, ‘state’})ここで、’error_message’ はカスタム エラー メッセージを示し、文字列定数または文字列変数にすることができます。’severity’ はエラー メッセージの重大度を示し、1 から 25 の間の整数値にすることができます。値が大きいほど重大なエラーを表します。’state’ はカスタムの状態コードであり、エラーをさらに区別および処理するために使用できます。RAISERROR ステートメントを使用する例を次に示します。DECLARE @error_message NVARCHAR(100) = ‘Custom error message.’;DECLARE @severity INT = 16;DECLARE @state INT = 1;RAISERROR (@error_message, @severity, @state);この例では、RAISERROR ステートメントは重大度 16 のカスタム エラー メッセージを生成し、アプリケーションまたはクライアントに返します。さらに、RAISERROR は TRY…CATCH ブロックなどの他の T-SQL ステートメントと組み合わせて使用して、エラーをキャプチャして処理することもできます。例: BEGIN TRY
— エラーが発生する可能性のあるコードEND TRYBEGIN CATCH
DECLARE @error_message NVARCHAR(100) = ERROR_MESSAGE();
DECLARE @severity INT = ERROR_SEVERITY();
DECLARE @state INT = ERROR_STATE();
RAISERROR (@error_message, @severity, @state);END CATCH;この例では、TRY ブロック内のコードでエラーが発生した場合、CATCH ブロックは RAISERROR ステートメントを使用してエラー メッセージをアプリケーションまたはクライアントに返します。