ERROR_STATE (Transact-SQL)

發行項
11/15/2023

適用于： SQL Server Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW） Microsoft Fabric 倉儲中的 SQL 分析端點

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

Transact-SQL 語法慣例

Syntax

ERROR_STATE ( )

注意

若要檢視 SQL Server 2014 （12.x）和舊版的 Transact-SQL 語法，請參閱舊版檔。

傳回型別

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