ERROR_NUMBER (Transact-SQL)
返回错误的错误号,该错误会导致运行 TRY…CATCH 结构的 CATCH 块。
语法
ERROR_NUMBER()
返回类型
int
返回值
在 CATCH 块中调用时,返回导致运行 CATCH 块的错误消息的错误号。
如果在 CATCH 块作用域以外调用,则返回 NULL。
备注
可以在 CATCH 块的作用域内的任何位置调用此函数。
不管在 CATCH 块的作用域内运行的次数和位置,ERROR_NUMBER 都返回错误号。这与 @@ERROR 不同,后者只在紧跟导致错误的语句的语句中或 CATCH 块的第一个语句中返回错误号。
在嵌套的 CATCH 块中,ERROR_NUMBER 返回特定于其被引用的 CATCH 块作用域的错误号。例如,外部 TRY...CATCH 构造的 CATCH 块可能具有嵌套 TRY...CATCH 构造。在嵌套的 CATCH 块中,ERROR_NUMBER 返回调用嵌套的 CATCH 块的错误的编号。如果 ERROR_NUMBER 在外部 CATCH 块中运行,则返回调用此 CATCH 块的错误的编号。
示例
A. 在 CATCH 块中使用 ERROR_NUMBER
下面的代码示例显示一个生成被零除错误的 SELECT 语句。将返回错误号。
USE AdventureWorks;
GO
BEGIN TRY
-- Generate a divide-by-zero error.
SELECT 1/0;
END TRY
BEGIN CATCH
SELECT ERROR_NUMBER() AS ErrorNumber;
END CATCH;
GO
B. 在包含其他错误处理工具的 CATCH 块中使用 ERROR_NUMBER
下面的代码示例显示一个生成被零除错误的 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
请参阅
参考
sys.messages (Transact-SQL)
TRY...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)
其他资源
在 Transact-SQL 中检索错误信息
在 Transact-SQL 中使用 TRY...CATCH
使用 RAISERROR
使用 @@ERROR
数据库引擎错误严重性