sp_trace_generateevent (języka Transact-SQL)

Tworzy zdarzeniezdefiniowane przez użytkownika.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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

Argumenty

  • [ @ identyfikator_zdarzenia =] event_id
    Jest to identyfikator zdarzenie włączyć.event_idjest int, z braku domyślne.Identyfikator musi być jedną numery zdarzenie z 82 poprzez 91, które reprezentują zdarzenia zdefiniowane przez użytkownika jako zestaw z sp_trace_setevent.

  • [ @ userinfo=] 'user_info"
    Opcjonalny zdefiniowane przez użytkownika ciąg identyfikujący przyczynę zdarzenie.user_infojest nvarchar(128), domyślna wartość NULL.

  • [ @ userdata=] user_data
    To opcjonalne dane określone przez użytkownika zdarzenie.user_datajest varbinary(8000), domyślna wartość NULL.

Wartości kodów powrotnych

W poniższej tabela opisano wartości kodu, że użytkownicy mogą uzyskać po przeprowadzeniu procedura składowana.

Kod powrotu

Opis

0

Nie ma błędów.

1

Nieznany błąd.

3

Określone zdarzenie nie jest prawidłowy.zdarzenie nie istnieje lub nie jest właściwe jednej procedury magazynu.

13

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

Uwagi

sp_trace_generateevent jest Microsoft SQL Server 2000 procedura składowana , który wykonuje wiele działań wykonanych wcześniej przez xp_trace_ * rozszerzonych procedur przechowywanych, które są dostępne w starszych wersjach SQL Server.Użycie sp_trace_generateevent zamiast xp_trace_generate_event.

Tylko numery identyfikatorów zdarzeń zdefiniowanych przez użytkownika mogą być używane z sp_trace_generateevent.SQL Serverbędzie podnieść błąd, jeśli używane są inne numery identyfikatorów zdarzenie .

Parametry śledzenia SQL wszystkie procedury przechowywane (sp_trace_xx) są ściśle wpisane.Jeśli te parametry nie są nazywane z typami danych prawidłowych parametrów wejściowych, jak określono w opisie argumentu procedura składowana zwróci błąd.

Uprawnienia

Użytkownik musi mieć uprawnienie Zmiana śledzenia.

Przykłady

Poniższy przykład tworzy konfigurowane przez użytkownika zdarzenie w przykładowej 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')