Applies to:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス
この関数は、エラーが発生したエラーの重大度値を返します。エラーによって、CATCH コンストラクトのTRY...CATCH ブロックが実行された場合です。
構文
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)