raiseerror深入解析

发布时间:2023-05-20

一、raiseerror宏

raiseerror是一个T-SQL语句,用来在用户定义的错误消息中抛出一个错误。通过使用这个宏可以让用户自定义错误消息并抛出。语法如下:

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

msg_idmsg_str指明消息的ID或文字。severity是错误的严重程度level,从1~25级。state是这个错误的状态码,一般用来帮助客户区分错误的源头。比如,ERR001是application error,ERR002是server error。如果没有提供state的话会默认是1。argument是可选项,用户提供的一组为错误消息参数提供值的变量。option是使用下面的指令来进一步定义的一些其他的选项:

  • LOG(打印到windows日志)
  • NOWAIT(立即向客户端发送响应,而不是等待batch完成)
  • SETERROR(如果启用了 NOCOUNT,则即使在 TRY/CATCH 块中也会产生错误消息)

二、raiseerror缺点

raiseerror是一个非常强大的工具,但是它也有一些缺点。首先,如果使用太过于频繁,就可能会导致性能问题。其次,最值得关注的是,如果代码中不恰当地使用了raiseerror,可能会让客户端产生印象非常糟糕的错误信息,于是客户端很可能失去信心甚至产生恐慌,这是非常危险的。所以,在使用raiseerror之前一定要考虑清楚。

三、raiseerror操作

raiseerror能够抛出自定义的错误消息,方便定位错误,在编写复杂的T-SQL语句时尤为重要。下面给大家举一个例子:

DECLARE @my_var CHAR(2);
SET @my_var = 'B';
IF @my_var = 'B'
  RAISERROR ('The value of variable @my_var cannot be "B".', 16, 1);
GO

在这个例子中,如果变量@my_var为字符B的话就会抛出我们自定义的错误消息“The value of variable @my_var cannot be "B".”。severity等级为16,state为1。

四、raiseerror是哪错了

在开发过程中,我们经常会遇到T-SQL语句返回错误的情况。有些错误是直接显示错误信息提示的,比如divide-by-zero error。但是有些错误显得非常纠结,比如'There is already an object named 'xxx' in the database',这时我们需要更好的错误提示信息帮助我们快速找出问题并且解决。这时raiseerror就可以派上用场了。

五、raiseerror函数

raiseerror是一个T-SQL语句,也是一个函数。函数使用时需要注意,运行过程会抛出异常,所以需要写在try...catch块里。同时,任何对数据库的更改操作(比如CREATE)都必须放在一个批次里,否则在实现过程中会出现“无法获取当前数据库”错误。同时,由于T-SQL语句会中断一条代码行,所以一定要注意在T-SQL语句块间放置分号(;),以防止代码被解释器错误切分。

六、raiseerror在if函数里面应用

RAISEERROR除了可以作为独立的语句外,还可以作为IF语句中的一部分,来控制异常的具体行为。比如我们可以使用如下的代码:

IF EXISTS(select * from demo_table)
BEGIN
   RAISERROR('demo_table exits',16,1)
END

demo_table存在的情况下,就会跳出IF语句并且抛出我们自定义的错误信息。

七、raiseerror在宏里怎么找不到

有时我们在使用raiseerror时会出现类似“名称‘RAISERROR’并不属于此范围。它可能是一个未声明的变量、函数或存储过程”的错误提示,这是因为在宏中使用raiseerror时,还要特别注意raiseerror所处的作用域以及是否已经启用。要使用raiseerror,必须先启用宏:在T-SQL代码的一开始使用“SET”选项(replace xx with your macro name):

SET QUOTED_IDENTIFIER ON;
SET ANSI_NULLS ON;
GO
CREATE Procedure xx
AS
...

八、raiseerror在宏中的用法

在宏中使用raiseerror的语法和使用方法和在普通T-SQL语句中是一样的。可以通过将消息文本存储在varchar类型的变量中来实现:

DECLARE @error_msg VARCHAR(50);
SET @error_msg = 'error message.';
RAISERROR (@error_msg ,16, 1);
GO

将内容为“error message.”的消息作为自定义的错误消息,severity等级为16,state为1。这样可以很方便地完成自定义错误消息。

九、raiserror什么意思

RAISERROR是T-SQL中的一条语句,作用是引发一个用户定义的错误消息。它允许用户自定义一个错误消息,指明出错的等级(severity)和sql server错误的状态码(state)等信息。在开发过程中,我们会用到这个功能,这样可以更好地定位错误信息,缩短错误排查的时间。

十、raiserror的三个参数是什么

RAISERROR函数共有三个参数:

  1. msg_id:是消息的ID号
  2. severity:是严重程度等级
  3. state:是错误状态码 msg_id:可以是消息的ID或文字,如msg_ID '1'为“Divide by zero error encountered.”,msg_ID '50001'为用户定义的消息等等。 severity:严重程度等级从125级,一般建议取值在16以上,比如16表示一般错误,18为严重错误。一般来说,值越大,代表错误越严重。 state:可以是指定的状态码。我们可以自己定义一些非系统预定的数字(1255之间),来标识不同的错误行为。