ERROR_SEVERITY (Transact-SQL)

返回导致 TRY…CATCH 构造的 CATCH 块运行的错误的严重级别。

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

语法

ERROR_SEVERITY ( )

返回类型

int

返回值

在 CATCH 块中调用时,返回导致 CATCH 块运行的错误消息的严重级别。

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

注释

ERROR_SEVERITY 可以在 CATCH 块范围内的任意位置调用。

ERROR_SEVERITY 返回错误严重级别,不管它运行多少次,或它运行在 CATCH 块的范围内的什么位置。这与 @@ERROR 之类的函数形成鲜明对比,后者只在导致错误的语句的下一个语句中或者在 CATCH 块的第一个语句中返回错误号。

在嵌套 CATCH 块中,ERROR_SEVERITY 返回特定于引用它的 CATCH 块的范围的错误严重级别。例如,外部 TRY...CATCH 构造的 CATCH 块可能具有嵌套 TRY...CATCH 构造。在嵌套 CATCH 块中,ERROR_SEVERITY 返回调用了嵌套 CATCH 块的错误的严重级别。如果 ERROR_SEVERITY 运行在 CATCH 块以外,则它会返回调用该 CATCH 块的错误的严重级别。

示例

A. 在 CATCH 块中使用 ERROR_SEVERITY

下面的示例显示一个会生成被零除错误的 SELECT 语句。返回错误的严重级别。

USE AdventureWorks;
GO

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

B. 使用其他错误处理工具在 CATCH 块中使用 ERROR_SEVERITY

下面的示例显示一个会生成被零除错误的 SELECT 语句。同时与严重级别一起返回与该错误相关的信息。

USE AdventureWorks;
GO

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