共用方式為


ERROR_STATE (Transact-SQL)

適用於:Microsoft Fabric 中Microsoft網狀架構倉儲中的 SQL Server Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW) SQL 分析端點

傳回造成執行 TRY...CATCH 建構的 CATCH 區塊之錯誤的狀態碼。

Transact-SQL 語法慣例

語法

ERROR_STATE ( )  

傳回型別

int

傳回值

當它在 CATCH 區塊中被呼叫時,會傳回造成執行 CATCH 區塊之錯誤訊息的狀態碼。

如果是在 CATCH 區塊範圍之外呼叫,便傳回 NULL。

備註

某些錯誤訊息可能會在 Microsoft SQL Server 資料庫引擎程式碼中的多個點上引發。 例如,在許多不同情況下,都有可能產生 "1105" 錯誤。 每個產生錯誤的特定狀況,都會指派唯一的狀態碼。

當檢視已知問題的資料庫時,例如 Microsoft 知識庫,您可以利用狀態碼來判斷所記錄的問題,與您遇到的錯誤是否相同。 例如,如果知識庫文件討論狀態為 2 的 1105 錯誤訊息,而您收到的 1105 錯誤訊息的狀態卻是 3,錯誤原因可能不是文章所報告的原因。

SQL Server 支援工程師也可以利用錯誤中的狀態碼,來找出原始程式碼發生錯誤的位置,這也許能提供如何診斷問題的其他想法。

可以在 CATCH 區塊範圍內的任何位置呼叫 ERROR_STATE。

ERROR_STATE 不論執行多少次,也不論是在 CATCH 區塊範圍內的任何位置執行,都會傳回錯誤狀態。 這有別於 @@ERROR,@@ERROR 只會在緊接於發生錯誤的陳述式之後的陳述式中,或在 CATCH 區塊的第一個陳述式中傳回錯誤訊息。

在巢狀 CATCH 區塊中,ERROR_STATE 會傳回參考它的 CATCH 區塊範圍特定的錯誤狀態。 例如,外部 TRY...CATCH 建構的 CATCH 區塊可能會有巢狀的 TRY...CATCH 建構。 在巢狀 CATCH 區塊內,ERROR_STATE 會從呼叫巢狀 CATCH 區塊的錯誤傳回狀態。 如果 ERROR_STATE 是在外部 CATCH 區塊內執行,它會從呼叫 CATCH 區塊的錯誤傳回狀態。

範例

A. 在 CATCH 區塊中使用 ERROR_STATE

下列範例顯示將會產生除以零之錯誤的 SELECT 陳述式。 它會傳回錯誤的狀態。

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

B. 在含有其他錯誤處理工具的 CATCH 區塊中使用 ERROR_STATE

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

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

C. 在含有其他錯誤處理工具的 CATCH 區塊中使用 ERROR_STATE

下列範例顯示將會產生除以零之錯誤的 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_MESSAGE() AS ErrorMessage;  
END CATCH;  
GO  

另請參閱

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_SEVERITY (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
錯誤和事件參考 (Database Engine)