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

SI APPLICA A: sìSQL Server (a partire dalla versione 2008) noDatabase SQL di Azure noAzure SQL Data Warehouse noParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Crea un evento definito dall'utente in SQL ServerSQL Server.Creates a user-defined event in SQL ServerSQL Server.

NOTA: Questa stored procedure viene non deprecato.NOTE: This stored procedure is not deprecated. Tutte le altre stored procedure correlate alle tracce sono deprecate.All other trace-related stored procedures are deprecated.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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

ArgomentiArguments

[ @eventid = ] event_id È l'ID dell'evento da attivare.[ @eventid = ] event_id Is the ID of the event to turn on. event_id viene int, non prevede alcun valore predefinito.event_id is int, with no default. L'ID deve essere uno dei numeri di evento compreso tra 82 e 91, che rappresentano eventi definiti dall'utente come set con sp_trace_setevent.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' Stringa facoltativa definita dall'utente consiste nell'identificare il motivo per l'evento.[ @userinfo = ] 'user_info' Is the optional user-defined string identifying the reason for the event. user_info viene nvarchar (128), con un valore predefinito è NULL.user_info is nvarchar(128), with a default of NULL.

[ @userdata = ] user_data Contiene i dati specificati dall'utente facoltativi per l'evento.[ @userdata = ] user_data Is the optional user-specified data for the event. user_data viene varbinary(8000, con un valore predefinito è NULL.user_data is varbinary(8000), with a default of NULL.

Valori restituitiReturn Code Values

Nella tabella seguente vengono descritti i possibili valori di codice visualizzati al completamento della stored procedure.The following table describes the code values that users may get following completion of the stored procedure.

Codice restituitoReturn code DescrizioneDescription
00 Nessun errore.No error.
11 Errore sconosciuto.Unknown error.
33 L'evento specificato non è valido,The specified event is not valid. in quanto non esiste oppure non è appropriato per la stored procedure.The event may not exist or it is not an appropriate one for the store procedure.
1313 Memoria esaurita.Out of memory. Restituito quando la quantità di memoria disponibile non è sufficiente per eseguire l'azione specificata.Returned when there is not enough memory to perform the specified action.

NoteRemarks

sp_trace_generateevent esegue molte delle azioni eseguite in precedenza tramite il xp_trace _* stored procedure estese.sp_trace_generateevent performs many of the actions previously executed by the xp_trace_* extended stored procedures. Uso sp_trace_generateevent invece di xp_trace_generate_event.Use sp_trace_generateevent instead of xp_trace_generate_event.

Solo i numeri ID degli eventi definiti dall'utente possono essere utilizzati con sp_trace_generateevent.Only ID numbers of user-defined events may be used with sp_trace_generateevent. Se si utilizzano altri ID di evento, inSQL ServerSQL Server verrà generato un errore.SQL ServerSQL Server will raise an error if other event ID numbers are used.

I parametri di traccia SQL tutte le stored procedure (sp_trace_xx) sono fortemente tipizzati.Parameters of all SQL Trace stored procedures (sp_trace_xx) are strictly typed. Se questi parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituirà un errore.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.

PermissionsPermissions

L'utente deve disporre delle autorizzazioni ALTER TRACE.User must have ALTER TRACE permission.

EsempiExamples

Nell'esempio seguente viene creato un evento configurabile dall'utente in una tabella di esempio.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');  

Vedere ancheSee also

sys.fn_trace_geteventinfo (Transact-SQL) sys.fn_trace_geteventinfo (Transact-SQL)
sp_trace_setevent (Transact-SQL) sp_trace_setevent (Transact-SQL)
Traccia SQLSQL Trace