适用于:SQL Server
Azure SQL 数据库
Azure SQL 托管实例
Azure Synapse Analytics
分析平台系统(PDW)
Microsoft Fabric 中的 SQL 分析终结点
Microsoft Fabric 中的仓库
Microsoft Fabric 中的 SQL 数据库
此函数返回错误的错误号,该错误导致执行了 TRY…CATCH 构造的 CATCH 块。
语法
ERROR_NUMBER ( )
返回类型
int
返回值
在 CATCH 块中调用时,ERROR_NUMBER 返回导致 CATCH 块运行的错误的错误号。
在 CATCH 块作用域外调用时,ERROR_NUMBER 返回 NULL。
备注
ERROR_NUMBER 支持在 CATCH 块作用域内的任意位置调用。
无论 ERROR_NUMBER 运行多少次或在 CATCH 块作用域内的任意位置运行,它都将返回相关的错误号。 这与 @@ERROR 之类的函数不同,后者只在导致错误的语句的后一个语句中返回错误号。
在嵌套 CATCH 块中,ERROR_NUMBER 返回特定于引用该 CATCH 块的 CATCH 块的作用域的错误号。 例如,外部 TRY...CATCH 构造的 CATCH 块可能具有内部 TRY...CATCH 构造。 在该内部 CATCH 块内,ERROR_NUMBER 将返回调用内部 CATCH 块的错误号。 如果 ERROR_NUMBER 在外部 CATCH 块中运行,它将返回调用该外部 CATCH 块的错误号。
示例
A. 在 CATCH 块中使用 ERROR_NUMBER
此示例显示生成被零除错误的 SELECT 语句。
CATCH 块返回错误号。
BEGIN TRY
-- Generate a divide-by-zero error.
SELECT 1/0;
END TRY
BEGIN CATCH
SELECT ERROR_NUMBER() AS ErrorNumber;
END CATCH;
GO
结果集如下。
-----------
(0 row(s) affected)
ErrorNumber
-----------
8134
(1 row(s) affected)
B. 在包含其他错误处理工具的 CATCH 块中使用 ERROR_NUMBER
此示例显示生成被零除错误的 SELECT 语句。
CATCH 块将返回错误号和有关此错误的信息。
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)
尝试。。。CATCH (Transact-SQL)
ERROR_LINE(Transact-SQL)
ERROR_MESSAGE(Transact-SQL)
ERROR_PROCEDURE(Transact-SQL)
ERROR_SEVERITY(Transact-SQL)
ERROR_STATE(Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR(Transact-SQL)
错误和事件参考(数据库引擎)