将用户定义消息记入 Microsoft® SQL Server™ 日志文件和 Microsoft Windows NT® 事件查看器。可以使用 xp_logevent 发送警报,而不必给客户端发送消息。
xp_logevent
{error_number, 'message'
} [, 'severity']
error_number
是用户定义的大于 50,000 的错误号。最大值为 1073741823 (230 - 1)。
'message'
是少于 8,000 个字符的字符串。
'severity'
是以下三个字符串之一:INFORMATIONAL、WARNING 或 ERROR。severity 是可选的,其默认值为 INFORMATIONAL。
0(成功)或 1(失败)
对于所包含的代码示例,xp_logevent 返回下列错误信息:
The command(s) completed successfully.
在从 Transact-SQL 过程、触发器、批处理等环境中发送消息时,请使用 RAISERROR 语句,而不要使用 xp_logevent。xp_logevent 不调用客户端的消息处理程序,也不设置 @@ERROR。若要将消息写入 Windows NT 事件查看器和 SQL Server 内的 SQL Server 错误日志文件中,请执行 RAISERROR 语句。
xp_logevent 的执行权限默认授予 master 数据库中的 db_owner 固定数据库角色成员以及 sysadmin 固定服务器角色成员,但可以授予其他用户。
下例将消息(连同传递给消息的变量)记入 Windows NT 事件查看器。
DECLARE @@TABNAME varchar(30)
DECLARE @@USERNAME varchar(30)
DECLARE @@MESSAGE varchar(255)
SET @@TABNAME = 'customers'
SET @@USERNAME = USER_NAME()
SELECT @@MESSAGE = 'The table ' + @@TABNAME + ' is not owned by the user
' + @@USERNAME + '.'
USE master
EXEC xp_logevent 60000, @@MESSAGE, informational
相关文章