Udostępnij za pośrednictwem

  • Artykuł

sp_trace_generateevent (Transact-SQL)

Tworzy zdarzenie zdefiniowanej przez użytkownika.

Topic link iconKonwencje składni języka Transact-SQL

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

Argumenty

  • [ @eventid=] event_id
    Is the ID of the event to turn on.event_id is int, with no default.Identyfikator musi być jednym z numerów zdarzeń z 82 za pomocą 91, które reprezentują zdarzenie zdefiniowane przez użytkownika zgodnie z sp_trace_setevent.

  • [ @ userinfo= ] "user_info'
    Is the optional user-defined string identifying the reason for the event.user_info is nvarchar(128), with a default of NULL.

  • [ @ userdata= ] user_data
    Is the optional user-specified data for the event.user_data is varbinary(8000), with a default of NULL.

Wartości kodów powrotnych

W poniższej tabela opisano wartości kodów, że użytkownicy mogą uzyskać po przeprowadzeniu procedura przechowywana.

Zwraca kod

Description

0

Brak błędu.

1

Nieznany błąd.

3

Określonego zdarzenie jest nieprawidłowy.Zdarzenie może nie istnieć lub nie jest jeden z odpowiednią procedurą magazynu.

13

Mało pamięci.Zwracane, gdy jest za mało pamięci do wykonania określonej akcja.

Remarks

sp_trace_generateevent is a Microsoft SQL Server 2000 stored procedure that performs many of the actions previously executed by xp_trace_* extended stored procedures available in earlier versions of SQL Server.Użycie sp_trace_generateevent zamiast xp_trace_generate_event.

Only ID numbers of user-defined events may be used with sp_trace_generateevent.SQL Server will raise an error if other event ID numbers are used.

(Procedury przechowywane parametry wszystkich śledzenia SQLsp_trace_xx) ściśle są wpisane.Jeśli te parametry nie są nazywane z typami danych prawidłowego parametru wejściowego, jak określono w opisie argumentu procedura przechowywana zwróci błąd.

Uprawnienia

Użytkownik musi mieć uprawnienie ALTER TRACE.

Przykłady

Poniższy przykład tworzy użytkownika konfigurowane zdarzenie na przykładową tabela.

--Create a sample table.
CREATE TABLE user_config_test(col1 int, col2 char(10))

--DROP the trigger if it already exists.
IF EXISTS
   (SELECT * FROM sysobjects WHERE name = 'userconfig_trg')
   DROP TRIGGER userconfig_trg

--Create an ON INSERT trigger on the sample table.
CREATE TRIGGER userconfig_trg
   ON user_config_test FOR INSERT
AS
EXEC master..sp_trace_generateevent
   @event_class = 82, @userinfo = N'Inserted row into user_config_test'

--When an insert action happens, the user-configurable event fires. If 
you were capturing the event id=82, you will see it in the Profiler output.
INSERT INTO user_config_test VALUES(1, 'abc')