T-SQL——异常捕获&打印异常信息
- 目录
shanzm-2020年5月13日
0. 背景说明
我们在存储过程中的事务中定义了一个临时变量@sum,在事务的每一句sql语句后都@sum+@@error,最后根据@sum是否为0来判断是否有异常，
如果没有异常则@@error为0，有异常则@@error值为错误代码，即一定不为0
所以，可以通过最终的@sum判断是否有异常，
但是有一点要说明的是，@@error对那种重大错误无法捕捉，而且@@error只对其前一句sql语句生效
所以，建议还是使用TRY……CATCH
这里定义一个捕获异常的存储过程，实现将存储过程中出现的异常记录在数据库的异常信息表中。
本示例中，全部的存储过程都是在一个新建的测试数据库ShanTest数据库中进行的
1. 建立异常信息表ErrorLog
USE [ShanTest]
GO
/****** Object: Table [dbo].[ErrorLog] Script Date: 2020-05-11 14:49:33 ******/
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[ErrorLog](
[ErrorLogID] [int] IDENTITY(1,1) NOT NULL,--异常表ID
[ErrorTime] [datetime] NOT NULL CONSTRAINT [DF_ErrorLog_ErrorTime] DEFAULT (getdate()),--异常时间，提供默认值就是当前时间
[UserName] [sysname] NOT NULL, --异常用户名，这里就是dbo,dbo是每个数据库的默认用户，具有所有者权限，全称：datebaseOwner
[ErrorNumber] [int] NOT NULL, --异常代码
[ErrorSeverity] [int] NULL, --异常严重性
[ErrorState] [int] NULL, --异常状态码
[ErrorProcedure] [nvarchar](126) NULL, --抛异常的存储过程
[ErrorLine] [int] NULL, --错误行数
[ErrorMessage] [nvarchar](4000) NOT NULL,--完整的异常信息
CONSTRAINT [PK_ErrorLog_ErrorLogID] PRIMARY KEY CLUSTERED
(
[ErrorLogID] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY]
GO
异常信息表中字段如下：
2. 建立保存异常信息的存储过程
USE [ShanTest]
GO
/****** Object: StoredProcedure [dbo].[pro_ErrorLog] Script Date: 2020-05-11 14:15:46 ******/
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =================================================
-- Author: shanzm
-- Create date: 2020年5月11日
-- Description: 保存存储过程中捕获的异常到ErrorLog表
-- =================================================
CREATE PROCEDURE [dbo].[pro_ErrorLog]
@ErrorLogID [int] = 0 OUTPUT
AS
BEGIN
SET NOCOUNT ON;
INSERT INTO [dbo].[ErrorLog]
(
[UserName],
[ErrorNumber],
[ErrorSeverity],
[ErrorState],
[ErrorProcedure],
[ErrorLine],
[ErrorMessage]
)
VALUES
(
CONVERT(sysname, CURRENT_USER),--current_user ,这里值是dbo,dbo是每个数据库的默认用户，具有所有者权限
--sysname类型 用于表列、变量以及用于存储对象名的存储过程参数，等价与nvachart(120)
ERROR_NUMBER(), --错误代号，有很多错误代号，可以自行百度
ERROR_SEVERITY(), --错误的严重性
ERROR_STATE(), --错误的状态码
ERROR_PROCEDURE(), --错误的存储过程
ERROR_LINE(), --错误行号
ERROR_MESSAGE() --错误信息
);
SET @ErrorLogID = @@IDENTITY;--@@IDENTITY 是插入记录时自动产生的ID
execute dbo.pro_PrintError;--改存储过程会将ERROR_MESSAGE()在sql server信息窗口打印出来
END;
3. 建立在SQL Server中打印异常信息的存储过程
在存储过程 pro_ErrorLog 中存储异常信息后，在调用这个存储过程
USE [ShanTest]
GO
/****** Object: StoredProcedure [dbo].[pro_PrintError] Script Date: 2020-05-11 14:43:25 ******/
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author: shanzm
-- Create date: 2020年5月11日
-- Description: 在消息框中打印异常信息
-- =============================================
CREATE PROCEDURE [dbo].[pro_PrintError]
AS
BEGIN
SET NOCOUNT ON;
-- Print error information.
PRINT 'ErrorNumber ： ' +CONVERT(varchar(50), ERROR_NUMBER())
PRINT 'ErrorSeverity ： ' + CONVERT(varchar(5), ERROR_SEVERITY())
PRINT 'ErrorState ：' + CONVERT(varchar(5), ERROR_STATE())
PRINT 'ErrorProcedure ：' + ISNULL(ERROR_PROCEDURE(), '-')
PRINT 'ErrorLine ：' + CONVERT(varchar(5), ERROR_LINE());
PRINT 'ErrorMessage ：' + ERROR_MESSAGE();
END;
4. 建立一个用于测试的存储过程抛出异常进行测试
切记我们在业务中需要使用存储过程的时候，一旦使用了事务，则我们必须在BEGIN CATCH语句中判断是否有异常抛出，一旦有异常抛出，则存储过程中的事务一定要进行ROLLBACK
USE [ShanTest]
GO
/****** Object: StoredProcedure [dbo].[TestErrorLog] Script Date: 2020-05-11 15:14:11 ******/
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author: shanzm
-- Create date: 2020年5月11日
-- Description: 用于抛出异常测试ErrorLog是否可用
-- =============================================
ALTER PROCEDURE [dbo].[TestErrorLog]
AS
BEGIN
SET NOCOUNT ON;
BEGIN TRY---------开始捕捉异常
BEGIN TRANSACTION------------------开始事务
update ShanTest.dbo.Product set Name=NULL where Id=1--这里随便建一个数据库，建一个表，给该表中不允许为空的列插入一个NUll
--select 1/0;
COMMIT ----------------------------提交事务
END TRY-----------结束捕捉异常
BEGIN CATCH------有异常被捕获
IF @@TRANCOUNT > 0---------------------判断有没有事务
BEGIN
ROLLBACK --------------------------回滚事务
END
EXEC pro_ErrorLog----------------------执行存储过程将错误信息记录在表当中
END CATCH--------结束异常处理
END
执行改存储过程，进行测试：
USE [ShanTest]
GO
EXEC [dbo].[TestErrorLog]
GO
测试结果：
SQL Serve消息框中现实消息：
ErrorNumber ： 515
ErrorSeverity ： 16
ErrorState ：2
ErrorProcedure ：TestErrorLog
ErrorLine ：13
ErrorMessage ：不能将值 NULL 插入列 'Name'，表 'ShanTest.dbo.Product'；列不允许有 Null 值。UPDATE 失败。
该消息是由pro_PrintError存储过程打印的
同时ErrorLog表中添加了一条记录：
