創(chuàng)建用戶定義事件。
sp_trace_generateevent [ @eventid = ] event_id
[ , [ @userinfo = ] 'user_info' ]
[ , [ @userdata = ] user_data ]
[ @eventid = ] event_id
是要打開的事件 ID。event_id 的數(shù)據(jù)類型為 int,沒有默認(rèn)設(shè)置。此 ID 必須是事件號 82 至 91 中的一個(gè),它表示用 sp_trace_setevent 設(shè)置的用戶定義事件。
[ @userinfo = ] 'user_info'
是識別事件原因的可選的用戶定義字符串。user_info 的數(shù)據(jù)類型為 nvarchar(128),默認(rèn)設(shè)置為 NULL。
[ @userdata = ] user_data
是用于事件的可選的用戶指定數(shù)據(jù)。user_data 的數(shù)據(jù)類型為 varbinary(8000),默認(rèn)設(shè)置為 NULL。
下表描述在存儲過程完成之后用戶可能獲得的代碼值。
返回代碼 | 描述 |
---|---|
0 | 沒有錯(cuò)誤。 |
1 | 未知錯(cuò)誤。 |
3 | 指定的事件無效。該事件可能不存在或者它不適用于此存儲過程。 |
13 | 內(nèi)存不足。在沒有足夠內(nèi)存執(zhí)行指定的操作時(shí)返回此代碼。 |
sp_trace_generateevent 是一個(gè) Microsoft SQL Server 2000 存儲過程,它執(zhí)行以前由 SQL Server 早期版本中使用的 xp_trace_* 擴(kuò)展存儲過程執(zhí)行的許多操作。使用 sp_trace_generateevent 而不使用 xp_trace_generate_event。
只有用戶定義事件的 ID 號可用于 sp_trace_generateevent中。如果使用其它事件 ID 號,則 SQL Server 將產(chǎn)生錯(cuò)誤。
嚴(yán)格地鍵入所有 SQL 跟蹤存儲過程 (sp_trace_xx) 的參數(shù)。如果沒有用正確的輸入?yún)?shù)數(shù)據(jù)類型(與在參數(shù)說明中指定的相同)調(diào)用這些參數(shù),則存儲過程將返回錯(cuò)誤。
只有 sysadmin 固定服務(wù)器角色成員才能執(zhí)行 sp_trace_generateevent。