次の方法で共有

ERROR_SEVERITY(Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウスMicrosoft Fabric の SQL データベース

この関数は、エラーが発生したエラーの重大度値を返します。エラーによって、CATCH コンストラクトのTRY...CATCH ブロックが実行された場合です。

Transact-SQL 構文表記規則

構文

ERROR_SEVERITY ( )

戻り値の型

int

戻り値

エラーが発生した CATCH ブロックで呼び出されると、 ERROR_SEVERITY は、 CATCH ブロックの実行の原因となったエラーの重大度値を返します。

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

解説

ERROR_SEVERITY は、 CATCH ブロックのスコープ内の任意の場所で呼び出しをサポートします。

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

通常、ERROR_SEVERITY は入れ子になった CATCH ブロック内で動作します。 ERROR_SEVERITY は、CATCH ブロックを参照した CATCH ブロックのスコープに固有のエラー重大度を返します。 たとえば、外側のCATCH コンストラクトのTRY...CATCH ブロックには、内部TRY...CATCHコンストラクトを含める場合があります。 その内側の CATCH ブロック内では、ERROR_SEVERITY は内側の CATCH ブロックを呼び出したエラーの重大度を返します。 ERROR_SEVERITY が外側の CATCH ブロック内で実行される場合、外側の CATCH ブロックを呼び出したエラーの重大度を返します。

例: Azure Synapse Analytics、Analytics Platform System (PDW)

Ａ。 CATCH ブロックでERROR_SEVERITYを使用する

この例では、0 除算エラーを生成したストアド プロシージャを示します。 ERROR_SEVERITY はそのエラーの重大度を返します。

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

結果セットは次のとおりです。

-----------

(0 row(s) affected)

ErrorSeverity
-------------
16

(1 row(s) affected)

B. CATCH ブロック内のERROR_SEVERITYを他のエラー処理ツールと共に使用する

この例は、0 除算エラーを生成する SELECT ステートメントを示しています。 ストアド プロシージャは、エラーに関する情報を返します。

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

結果セットは次のとおりです。

-----------

(0 row(s) affected)

ErrorNumber ErrorSeverity ErrorState  ErrorProcedure  ErrorLine   ErrorMessage
----------- ------------- ----------- --------------- ----------- ----------------------------------
8134        16            1           NULL            4           Divide by zero error encountered.

(1 row(s) affected)

関連コンテンツ

  • Last updated on