ERROR_SEVERITY (Transact-SQL)
适用于:Microsoft Fabric Microsoft Fabric Warehouse 中的 SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW) SQL Analytics 终结点
如果该错误导致执行了 TRY…CATCH 构造的 CATCH 块,此函数将在发生错误的位置返回错误的严重性值。
语法
ERROR_SEVERITY ( )
注意
若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法,请参阅早期版本文档。
返回类型
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
下面是结果集。
-----------
(0 row(s) affected)
ErrorNumber ErrorSeverity ErrorState ErrorProcedure ErrorLine ErrorMessage
----------- ------------- ----------- --------------- ----------- ----------------------------------
8134 16 1 NULL 4 Divide by zero error encountered.
(1 row(s) affected)
另请参阅
sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_NUMBER (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
错误和事件参考(数据库引擎)