ERROR_NUMBER (Transact-SQL)ERROR_NUMBER (Transact-SQL)

03/16/2017

適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse

この関数は、TRY...CATCH 構造の CATCH ブロックが実行される原因となったエラーのエラー番号を返します。This function returns the error number of the error that caused the CATCH block of a TRY...CATCH construct to execute.

トピックリンクアイコン Transact-SQL 構文表記規則 Topic link icon Transact-SQL Syntax Conventions

構文Syntax

ERROR_NUMBER ( )

注意

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

戻り値の型Return Types

intint

戻り値Return Value

CATCH ブロックで呼び出されると、ERROR_NUMBER は CATCH ブロックの実行を引き起こしたエラーのエラー番号を返します。When called in a CATCH block, ERROR_NUMBER returns the error number of the error that caused the CATCH block to run.

ERROR_NUMBER は、CATCH ブロックの範囲外で呼び出されると、NULL を返します。ERROR_NUMBER returns NULL when called outside the scope of a CATCH block.

解説Remarks

ERROR_NUMBER は、CATCH ブロックのスコープ内の任意の場所で呼び出すことができます。ERROR_NUMBER supports calls anywhere within the scope of a CATCH block.

ERROR_NUMBER は、実行回数に関係なく、あるいは CATCH ブロックのスコープ内の実行場所に関係なく、関連エラー番号を返します。ERROR_NUMBER returns a relevant error number regardless of how many times it runs, or where it runs within the scope of the CATCH block. エラーが発生したステートメントの直後のステートメントのエラー番号のみを返す、@@ERROR などの関数とは対照的となります。This contrasts with a function like @@ERROR, which only returns an error number in the statement immediately following the one that causes an error.

CATCH ブロックが入れ子になっている場合、ERROR_NUMBER は、CATCH ブロックを参照した CATCH ブロックのスコープに固有のエラー番号を返します。In a nested CATCH block, ERROR_NUMBER returns the error number specific to the scope of the CATCH block that referenced that CATCH block. たとえば、外側の TRY...CATCH 構造の CATCH ブロックの中に TRY...CATCH 構造が含まれることがあります。For example, the CATCH block of an outer TRY...CATCH construct could have an inner TRY...CATCH construct. その内側の CATCH ブロック内では、ERROR_NUMBER は内側の CATCH ブロックを呼び出したエラーの番号を返します。Inside that inner CATCH block, ERROR_NUMBER returns the number of the error that invoked the inner CATCH block. ERROR_NUMBER が外側の CATCH ブロック内で実行される場合、外側の CATCH ブロックを呼び出したエラーの番号を返します。If ERROR_NUMBER runs in the outer CATCH block, it returns the number of the error that invoked that outer CATCH block.

例Examples

A.A. CATCH ブロックで ERROR_NUMBER を使用するUsing ERROR_NUMBER in a CATCH block

この例は、0 除算エラーを生成する SELECT ステートメントを示しています。This example shows a SELECT statement that generates a divide-by-zero error. CATCH ブロックはエラー番号を返します。The CATCH block returns the error number.

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

結果セットは次のようになります。Here is the result set.

-----------

(0 row(s) affected)

ErrorNumber
-----------
8134

(1 row(s) affected)

B.B. CATCH ブロックで ERROR_NUMBER を他のエラー処理ツールと一緒に使用するUsing ERROR_NUMBER in a CATCH block with other error-handling tools

この例は、0 除算エラーを生成する SELECT ステートメントを示しています。This example shows a SELECT statement that generates a divide-by-zero error. CATCH ブロックは、エラー番号と共にそのエラーに関する情報を返します。Along with the error number, the CATCH block returns information about that error.

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