ERROR_NUMBER (Transact-SQL)

[アーティクル]
12/15/2008

TRY...CATCH 構造の CATCH ブロックの実行を引き起こしたエラーのエラー番号を返します。

構文

ERROR_NUMBER()

戻り値の型

int

戻り値

CATCH ブロックで呼び出されると、CATCH ブロックの実行を引き起こしたエラーメッセージのエラー番号を返します。

CATCH ブロックのスコープ外で呼び出された場合は、NULL を返します。

解説

この関数は、CATCH ブロックのスコープ内の任意の場所で呼び出すことができます。

ERROR_NUMBER は、その実行回数、または実行される CATCH ブロックのスコープ内の場所に関係なく、エラー番号を返します。これは、エラーを引き起こしたステートメントの直後のステートメント、または CATCH ブロックの最初のステートメントでのみエラー番号を返す @@ERROR とは対照的です。

入れ子になった CATCH ブロックでは、ERROR_NUMBER は、参照されている CATCH ブロックのスコープに固有のエラー番号を返します。たとえば、外部の TRY...CATCH 構造の CATCH ブロックには、入れ子になった TRY...CATCH 構造を含めることができます。入れ子になった CATCH ブロック内では、ERROR_NUMBER は、入れ子になった CATCH ブロックを呼び出したエラーの番号を返します。ERROR_NUMBER が外部の CATCH ブロックで実行されると、その CATCH ブロックを呼び出したエラーの番号が返されます。

例

A. CATCH ブロックで ERROR_NUMBER を使用する

次のコードは、0 除算エラーを生成する SELECT ステートメントを示しています。エラーの番号が返されます。

USE AdventureWorks;
GO

BEGIN TRY
    -- Generate a divide-by-zero error.
    SELECT 1/0;
END TRY
BEGIN CATCH
    SELECT ERROR_NUMBER() AS ErrorNumber;
END CATCH;
GO

B. CATCH ブロックで ERROR_NUMBER を他のエラー処理ツールと一緒に使用する

次のコードは、0 除算エラーを生成する SELECT ステートメントを示しています。エラー番号と共に、エラーに関連する情報が返されます。

USE AdventureWorks;
GO

BEGIN TRY
    -- Generate a divide-by-zero error.
    SELECT 1/0;
END TRY
BEGIN CATCH
    SELECT
        ERROR_NUMBER() AS ErrorNumber,
        ERROR_SEVERITY() AS ErrorSeverity,
        ERROR_STATE() AS ErrorState,
        ERROR_PROCEDURE() AS ErrorProcedure,
        ERROR_LINE() AS ErrorLine,
        ERROR_MESSAGE() AS ErrorMessage;
END CATCH;
GO

参照

その他の技術情報

Transact-SQL のエラー情報の取得
 Transact-SQL での TRY...CATCH の使用
 RAISERROR の使用
 @@ERROR の使用
 データベースエンジンエラーの重大度

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

次の方法で共有