ERROR_PROCEDURE (Transact-SQL)

返回在其中出现了导致 TRY…CATCH 构造的 CATCH 块运行的错误的存储过程或触发器的名称。

主题链接图标Transact-SQL 语法约定

语法

ERROR_PROCEDURE ( )

返回类型

nvarchar(126)

返回值

在 CATCH 块中调用时,返回出现错误的存储过程名称。

如果该错误未在存储过程或触发器中出现,则返回 NULL。

如果在 CATCH 块作用域以外调用,则返回 NULL。

注释

ERROR_PROCEDURE 可以在 CATCH 块的作用域内的任何位置调用。

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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
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