sql server数据库中raiserror函数用法的详细介绍

sql server数据库中raiserror函数的用法

server数据库中raiserror的作用就和asp.NET中的throw new Exception一样，用于抛出一个异常或错误。这个错误可以被程序捕捉到。

raiserror的常用格式如下：
raiserror('错误的描述',错误的严重级别代码，错误的标识，错误的描述中的参数的值(这个可以是多个)，一些其它参数)，在官方上的格式描述如下：

RAISERROR ( { msg_id | msg_str | @local_variable } 
 { ,severity ,state } 
 [ ,argument [ ,...n ] ] ) 
 [ WITH option [ ,...n ] ]

其中，[ ,argument [ ,...n ] ]与 [ WITH option [ ,...n ] 两项是可以不写的。

分别解释一下各参数的用法：

一、{ msg_id | msg_str | @local_variable }

从这个参数中可以看出，这一项可能为三个值，
1,sys.messages中的自定义错误信息的错误信息号，自定义错误信息可以使用sp_addmessage存储过程添加到sys.messages中，注意, 用户定义错误消息的错误号应当大于 50000。
示例：raiserror(50001,16,1)
2,一条直接的错误描述，示例：raiserror('这里是错误描述的示例',16,1)
3,一个包含错误描述变量，示例:

declare @error_mes varchar(1000) 
set @error_mes='这里是错误描述的示例' 
raiserror(@error_mes,16,1)

二、severity

这个参数为用户定义的该错误信息的级别，我们可以指定 0 到 18 之间的严重级别。只有 sysadmin 固定服务器角色成员或具有 ALTER TRACE 权限的用户才能指定 19 到 25 之间的严重级别。若要使用 19 到 25 之间的严重级别，必须选择 WITH LOG 选项。

注意，如果错误级别在20~25之间，那么数据库会认为这个错误是致命，那么数据库会将该错误记录到错误日志和应用程序日志后终止数据库的连接。任何小于 0 的严重级别被认为等于0。大于 25 的严重级别被认为等于25。

三、state

这个参数是可以是1~127之间任意整数，可以用来标识错误的发生位置，如果一段代码的多个位置都会发生同样的错误，那么就可以将这个参数设置为不同的值，用来标识是那个位
置发生错误了。

四、[ ,argument [ ,...n ] ]

如果参数{ msg_id | msg_str | @local_variable }中包含了一些代替符，那么这个参数就是代替符的具体的值，这个和asp.Net中的string.Format用法是一样的。示例如下:

declare @error_mes varchar(1000) 
set @error_mes='这里是用户%s引发的错误描述' 
raiserror(@error_mes,16,1,'张三')

也可以是这样，可能适用性更广些。

declare @error_mes varchar(1000) 
declare @error_obj varchar(1000) 
select @error_obj=name from table_users where…… 
set @error_mes='这里是用户%s引发的错误描述' 
raiserror(@error_mes,16,1,@error_obj)

上面代码中的%s，代表它要替代是一个字符串，如果我们把示例写成下面这样就会报错了：

declare @error_mes varchar(1000) 
set @error_mes='这里是用户%s引发的错误描述' 
raiserror(@error_mes,16,1,1)

因为1不是一个字符串，如果要替代是一个整数，就需要使用%i或者%d了。所有的对应关系如下：
1,%d或%i代表有符号整数
2,%u代表无符号整数
3,%o代表无符号八进制数
4,%s代表字符串
5,%x或%X代表 无符号十六进制数

五、[ WITH option [ ,...n ] ]

该参数为错误的自定义选项，可以是下面三个值中的一个：
1,LOG--在 Microsoft SQL Server 数据库引擎 实例的错误日志和应用程序日志中记录错误。记录到错误日志的错误目前被限定为最多 440 字节。只有 sysadmin 固定服务器角色
成员或具有 ALTER TRACE 权限的用户才能指定 WITH LOG。
2,NOWAIT--将消息立即发送给客户端。
3,SETERROR--将 @@ERROR 值和 ERROR_NUMBER 值设置为 msg_id 或 50000，不用考虑严重级别。

我们还可以在Begin catch中使用raiserror。示例如下:

begin try 
 raiserror('这是一个错误',16,1) //注意，只有severity级别在11~19之间，控制才会跳转到catch块中。 
end try 
begin catch 
 declare @error_message varchar(1000) 
 set @error_message=error_message() 
 raiserror(@error_message,16,1) 
 return 
end catch