ERROR_SEVERITY (Transact-SQL)

發行項
10/16/2024

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric 的 SQL 端點分析 Microsoft Fabric 的倉儲

此函式會在發生錯誤且該錯誤造成執行 TRY...CATCH 建構的 CATCH 區塊時，傳回錯誤的嚴重性值。

Transact-SQL 語法慣例

語法

ERROR_SEVERITY ( )

傳回型別

int

傳回值

在發生錯誤的 CATCH 區塊中呼叫時，ERROR_SEVERITY 會傳回造成執行 CATCH 區塊之錯誤的嚴重性值。

如果是在 CATCH 區塊範圍之外呼叫，則 ERROR_SEVERITY 會傳回 NULL。

備註

ERROR_SEVERITY 支援在 CATCH 區塊範圍內的任何位置呼叫。

不論執行多少次，或在 CATCH 區塊範圍內的哪個位置執行，ERROR_SEVERITY 都會傳回錯誤的錯誤嚴重性值。和 @@ERROR 之類函數相反的是，其只會在緊接著發生錯誤的陳述式中，傳回錯誤號碼。

ERROR_SEVERITY 通常會在巢狀 CATCH 區塊中作業。 ERROR_SEVERITY 會傳回參考該 CATCH 區塊之 CATCH 區塊範圍特定的錯誤嚴重性值。例如，外部 TRY...CATCH 建構的 CATCH 區塊可能會有內部 TRY...CATCH 建構。在該內部 CATCH 區塊內，ERROR_SEVERITY 會傳回叫用內部 CATCH 區塊之錯誤的嚴重性值。如果 ERROR_SEVERITY 是在外部 CATCH 區塊中執行，它會傳回叫用該外部 CATCH 區塊之錯誤的錯誤嚴重性值。

範例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

A. 在 CATCH 區塊中使用 ERROR_SEVERITY

此範例會顯示產生除以零之錯誤的預存程序。 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

此範例會顯示產生除以零之錯誤的 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)

另請參閱

sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_NUMBER (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
錯誤和事件參考 (Database Engine)

共用方式為