sp_trace_generateevent (Transact-SQL)sp_trace_generateevent (Transact-SQL)

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions)

Erstellt ein benutzerdefiniertes Ereignis in SQL ServerSQL Server.Creates a user-defined event in SQL ServerSQL Server.

Hinweis: Diese gespeicherte Prozedur ist nicht als veraltet markiert.NOTE: This stored procedure is not deprecated. Alle anderen ablaufverfolgungsbezogenen gespeicherten Prozeduren sind veraltet.All other trace-related stored procedures are deprecated.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @eventid = ] event_id Die ID des Ereignisses, das aktiviert werden soll.[ @eventid = ] event_id Is the ID of the event to turn on. event_id ist vom Datentyp intund hat keinen Standardwert.event_id is int, with no default. Die ID muss eine der Ereignisnummern von 82 bis 91 sein, die mit sp_trace_seteventfestgelegte benutzerdefinierte Ereignisse darstellen.The ID must be one of the event numbers from 82 through 91, which represent user-defined events as set with sp_trace_setevent.

[ @userinfo = ] 'user_info' Die optionale benutzerdefinierte Zeichenfolge, die den Grund für das Ereignis identifiziert.[ @userinfo = ] 'user_info' Is the optional user-defined string identifying the reason for the event. user_info ist vom Datentyp nvarchar(128) und hat den Standardwert NULL.user_info is nvarchar(128), with a default of NULL.

[ @userdata = ] user_data Die optionalen benutzerdefinierten Daten für das Ereignis.[ @userdata = ] user_data Is the optional user-specified data for the event. user_data ist vom Datentyp varbinary(8000) und hat den Standardwert NULL.user_data is varbinary(8000), with a default of NULL.

RückgabecodewerteReturn Code Values

In der folgenden Tabelle werden die Codewerte beschrieben, die die Benutzer nach Abschluss der gespeicherten Prozedur möglicherweise erhalten.The following table describes the code values that users may get following completion of the stored procedure.

RückgabecodeReturn code BESCHREIBUNGDescription
00 Kein Fehler.No error.
11 Unbekannter Fehler.Unknown error.
33 Das angegebene Ereignis ist ungültig.The specified event is not valid. Das Ereignis ist möglicherweise nicht vorhanden oder nicht für die gespeicherte Prozedur geeignet.The event may not exist or it is not an appropriate one for the store procedure.
1313 Nicht genügend Arbeitsspeicher.Out of memory. Wird zurückgegeben, wenn nicht genügend Arbeitsspeicher zum Ausführen der angegebenen Aktion verfügbar ist.Returned when there is not enough memory to perform the specified action.

HinweiseRemarks

sp_trace_generateevent führt viele der Aktionen aus, die zuvor von den * xp_trace_ erweiterten gespeicherten Prozeduren ausgeführt wurden.sp_trace_generateevent performs many of the actions previously executed by the xp_trace_* extended stored procedures. Verwenden Sie sp_trace_generateevent anstelle von xp_trace_generate_event.Use sp_trace_generateevent instead of xp_trace_generate_event.

Mit sp_trace_generateeventkönnen nur die ID-Nummern von benutzerdefinierten Ereignissen verwendet werden.Only ID numbers of user-defined events may be used with sp_trace_generateevent. In SQL ServerSQL Server wird ein Fehler ausgelöst, wenn andere Ereignis-ID-Nummern verwendet werden.SQL ServerSQL Server will raise an error if other event ID numbers are used.

Parameter aller gespeicherten Prozeduren der SQL-Ablaufverfolgung (sp_trace_xx) haben eine strikte Typbindung.Parameters of all SQL Trace stored procedures (sp_trace_xx) are strictly typed. Wenn diese Parameter nicht mit den richtigen Datentypen für Eingabeparameter aufgerufen werden, wie in der Argumentbeschreibung angegeben, gibt die gespeicherte Prozedur einen Fehler zurück.If these parameters are not called with the correct input parameter data types, as specified in the argument description, the stored procedure will return an error.

BerechtigungenPermissions

Benutzer müssen über die ALTER TRACE-Berechtigung verfügen.User must have ALTER TRACE permission.

BeispieleExamples

Im folgenden Beispiel wird ein vom Benutzer konfigurierbares Ereignis in einer Beispieltabelle erstellt.The following example creates a user-configurable event on a sample table.

--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');  

Weitere InformationenSee also

sys. fn_trace_geteventinfo (Transact-SQL-) sys.fn_trace_geteventinfo (Transact-SQL)
sp_trace_setevent (Transact-SQL) sp_trace_setevent (Transact-SQL)
SQL-AblaufverfolgungSQL Trace