ERROR_PROCEDURE (Transact-SQL)
傳回發生錯誤造成執行 TRY…CATCH 建構的 CATCH 區塊之預存程序或觸發程序的名稱。
語法
ERROR_PROCEDURE()
傳回類型
nvarchar(126)
傳回值
在 CATCH 區塊中呼叫時,會傳回發生錯誤的預存程序名稱。
如果未在預存程序或觸發程序內發生錯誤,便傳回 NULL。
如果是在 CATCH 區塊範圍之外呼叫,便傳回 NULL。
備註
您可以在 CATCH 區塊範圍內的任何位置呼叫 ERROR_PROCEDURE。
ERROR_PROCEDURE 會傳回發生錯誤的預存程序或觸發程序的名稱,不論呼叫它的次數為何,或是在 CATCH 區塊範圍內的什麼位置呼叫它,都是如此。這有別於 @@ERROR 之類的函數,它們會在緊接於發生錯誤的陳述式之後的陳述式中,或在 CATCH 區塊的第一個陳述式中,傳回錯誤號碼。
在巢狀 CATCH 區塊中,ERROR_PROCEDURE 會傳回參考它的 CATCH 區塊範圍專用的預存程序或觸發程序的名稱。例如,TRY...CATCH 建構的 CATCH 區塊可能會有巢狀的 TRY...CATCH。在巢狀 CATCH 區塊內,ERROR_PROCEDURE 會傳回發生叫用巢狀 CATCH 區塊的錯誤之預存程序或觸發程序的名稱。如果 ERROR_PROCEDURE 是在外部 CATCH 區塊中執行,它會傳回發生叫用該 CATCH 區塊的錯誤之預存程序或觸發程序的名稱。
範例
A. 在 CATCH 區塊中使用 ERROR_PROCEDURE
下列程式碼範例會顯示產生除以零的錯誤之預存程序。ERROR_PROCEDURE 會傳回發生錯誤的預存程序名稱。
USE AdventureWorks;
GO
-- Verify that the stored procedure does not already exist.
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL
DROP PROCEDURE usp_ExampleProc;
GO
-- Create a stored procedure that
-- generates a divide-by-zero error.
CREATE PROCEDURE usp_ExampleProc
AS
SELECT 1/0;
GO
BEGIN TRY
-- Execute the stored procedure inside the TRY block.
EXECUTE usp_ExampleProc;
END TRY
BEGIN CATCH
SELECT ERROR_PROCEDURE() AS ErrorProcedure;
END CATCH;
GO
B. 在含有其他錯誤處理工具的 CATCH 區塊中使用 ERROR_PROCEDURE
下列程式碼範例會顯示產生除以零的錯誤之預存程序。它會傳回發生錯誤的預存程序的名稱,以及錯誤的相關資訊。
USE AdventureWorks;
GO
-- Verify that the stored procedure does not already exist.
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL
DROP PROCEDURE usp_ExampleProc;
GO
-- Create a stored procedure that
-- generates a divide-by-zero error.
CREATE PROCEDURE usp_ExampleProc
AS
SELECT 1/0;
GO
BEGIN TRY
-- Execute the stored procedure inside the TRY block.
EXECUTE usp_ExampleProc;
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,
ERROR_LINE() AS ErrorLine;
END CATCH;
GO
請參閱
參考
sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_NUMBER (Transact-SQL)
ERROR_SEVERITY (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
其他資源
在 Transact-SQL 中擷取錯誤資訊
在 Transact-SQL 中使用 TRY...CATCH
使用 RAISERROR
Database Engine 錯誤嚴重性