ERROR_SEVERITY (Transact-SQL)

项目
10/31/2024

适用于： SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics 分析平台系统 (PDW) Microsoft Fabric 中的 SQL 分析端点 Microsoft Fabric 中的仓库

如果该错误导致执行了 TRY…CATCH 构造的 CATCH 块，此函数将在发生错误的位置返回错误的严重性值。

Transact-SQL 语法约定

语法

ERROR_SEVERITY ( )

返回类型

int

返回值

在发生错误的 CATCH 块中调用时，ERROR_SEVERITY 返回导致 CATCH 块运行的错误的严重性值。

如果在 CATCH 块作用域外调用，ERROR_SEVERITY 返回 NULL。

备注

ERROR_SEVERITY 支持在 CATCH 块作用域内的任意位置调用。

无论 ERROR_SEVERITY 运行多少次或在 CATCH 块作用域内的任意位置运行，它都将返回错误的错误严重性值。这与 @@ERROR 之类的函数不同，后者只在导致错误的语句的后一个语句中返回错误号。

ERROR_SEVERITY 通常在嵌套的 CATCH 块中运行。 ERROR_SEVERITY 返回特定于引用该 CATCH 块的 CATCH 块的作用域的错误严重性值。例如，外部 TRY...CATCH 构造的 CATCH 块可能具有内部 TRY...CATCH 构造。在该内部 CATCH 块内，ERROR_SEVERITY 将返回调用内部 CATCH 块的错误的严重性值。如果 ERROR_SEVERITY 在外部 CATCH 块中运行，它将返回调用该外部 CATCH 块的错误的错误严重性值。

示例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

A. 在 CATCH 块中使用 ERROR_SEVERITY

下面的示例显示生成被零除错误的存储过程。 ERROR_SEVERITY 返回该错误的严重性值。

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

结果集如下。

-----------

(0 row(s) affected)

ErrorSeverity
-------------
16

(1 row(s) affected)

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

下面示例显示生成被零除错误的 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