Transact-SQL 参考

sp_trace_generateevent

创建用户定义事件。

语法

sp_trace_generateevent [ @eventid = ] event_id
    [ , [ @userinfo = ] 'user_info' ]
    [ , [ @userdata = ] user_data ]

参数

[ @eventid = ] event_id

是要打开的事件 ID。event_id 的数据类型为 int,没有默认设置。此 ID 必须是事件号 82 至 91 中的一个,它表示用 sp_trace_setevent 设置的用户定义事件。

[ @userinfo = ] 'user_info'

是识别事件原因的可选的用户定义字符串。user_info 的数据类型为 nvarchar(128),默认设置为 NULL。

[ @userdata = ] user_data

是用于事件的可选的用户指定数据。user_data 的数据类型为 varbinary(8000),默认设置为 NULL。

返回代码值

下表描述在存储过程完成之后用户可能获得的代码值。

返回代码 描述
0 没有错误。
1 未知错误。
3 指定的事件无效。该事件可能不存在或者它不适用于此存储过程。
13 内存不足。在没有足够内存执行指定的操作时返回此代码。

注释

sp_trace_generateevent 是一个 Microsoft SQL Server 2000 存储过程,它执行以前由 SQL Server 早期版本中使用的 xp_trace_* 扩展存储过程执行的许多操作。使用 sp_trace_generateevent 而不使用 xp_trace_generate_event

只有用户定义事件的 ID 号可用于 sp_trace_generateevent中。如果使用其它事件 ID 号,则 SQL Server 将产生错误。

严格地键入所有 SQL 跟踪存储过程 (sp_trace_xx) 的参数。如果没有用正确的输入参数数据类型(与在参数说明中指定的相同)调用这些参数,则存储过程将返回错误。

权限

只有 sysadmin 固定服务器角色成员才能执行 sp_trace_generateevent

示例

请参见

fn_trace_geteventinfo

sp_trace_setevent