RAISERROR详解.docVIP

RAISERROR详解 生成错误消息并启动会话的错误处理。RAISERROR 可以引用 sys.messages 目录视图中存储的用户定义消息，也可以动态建立消息。该消息作为服务器错误消息返回到调用应用程序，或返回到 TRY…CATCH 构造的关联 CATCH 块。 语法 RAISERROR ( { msg_id | msg_str | @local_variable } ????{ ,severity ,state } ????[ ,argument [ ,...n ] ] ) ????[ WITH option [ ,...n ] ] 备注 RAISERROR 生成的错误与数据库引擎?代码生成的错误的运行方式相同。RAISERROR 指定的值由 ERROR_LINE、ERROR_MESSAGE、ERROR_NUMBER、ERROR_PROCEDURE、ERROR_SEVERITY、ERROR_STATE 以及 @@ERROR 等系统函数来报告。当 RAISERROR 在严重级别为 11 或更高的情况下在 TRY 块中运行，它便会将控制传输至关联的 CATCH 块。如果 RAISERROR 在下列情况下运行，便会将错误返回到调用方： 在任何 TRY 块的作用域之外运行。 在严重级别为 10 或更低的情况下在 TRY 块中运行。 在严重级别为 20 或更高的情况下终止数据库连接。 CATCH 块可以使用 RAISERROR 来再次引发调用 CATCH 块的错误，方法是使用 ERROR_NUMBER 和 ERROR_MESSAGE 之类的系统函数检索原始错误消息。对于严重级别为 1 到 10 的消息，@@ERROR 默认值为 0。有关详细信息，请参阅在 Transact-SQL 中使用 TRY...CATCH。 当 msg_id 指定 sys.messages 目录视图中可用的用户定义消息时，RAISERROR 按照与应用到使用 msg_str 指定的用户定义消息文本的规则相同的规则处理文本列中的消息。用户定义消息文本可以包含转换规格，并且 RAISERROR 将参数值映射到转换规格。使用 sp_addmessage 添加用户定义错误消息，而使用 sp_dropmessage 删除用户定义错误消息。 RAISERROR 可以替代 PRINT 将消息返回到调用应用程序。RAISERROR 支持类似于 C 标准库中 printf 函数功能的字符替代，而 Transact-SQL PRINT 语句则不支持。PRINT 语句不受 TRY 块的影响，而在严重级别为 11 到 19 的情况下在 TRY 块中运行的 RAISERROR 会将控制传输至关联的 CATCH 块。指定严重级别为 10 或更低以使用 RAISERROR 返回 TRY 块中的消息，而不必调用 CATCH 块。 通常，连续的参数替换连续的转换规格；第一个参数替换第一个转换规格，第二个参数替换第二个转换规格，以此类推。例如，在以下 RAISERROR 语句中，第一个参数 Nnumber 代替第一个转换规格 %s,，第二个参数 5 代替第二个转换规格 %d。 复制代码 RAISERROR (NThis is message %s %d., -- Message text. ???????????10, -- Severity, ???????????1, -- State, ???????????Nnumber, -- First argument. ???????????5); -- Second argument. -- The message text returned is: This is message number 5. GO 如果为转换规格的宽度或精度指定了星号 (*)，则要用于宽度或精度的值被指定为整数参数值。在这种情况下，一个转换规格最多可以使用三个参数，分别用作宽度、精度和替代值。 例如，下列两个 RAISERROR 语句都返回相同的字符串。一个指定参数列表中的宽度值和精度值；另一个指定转换规格中的宽度值和精度值： 复制代码 RAISERROR (N%*.*s, -- Message text. ???????????10, -- Severity, ???????????1, -- State, ???????????7, -- First argument used for width. ???????????3, -- Second argument used for precision. ???????????Nabcde); -- Third argument supplies the string. -- The messag