sp_trace_setevent (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Aggiunge o rimuove un evento o colonna di evento in una traccia. sp_trace_setevent può essere eseguito solo su tracce esistenti arrestate (@status è 0). Viene restituito un errore se questa stored procedure viene eseguita su una traccia che non esiste o il cui @status non 0è .

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, usare Eventi estesi.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_trace_setevent
    [ @traceid = ] traceid
    , [ @eventid = ] eventid
    , [ @columnid = ] columnid
    , [ @on = ] on
[ ; ]

Argomenti

[ @traceid = ] traceid

ID della traccia da modificare. @traceid è int, senza impostazione predefinita. L'utente usa questo valore @traceid per identificare, modificare e controllare la traccia.

[ @eventid = ] eventid

ID dell'evento da attivare. @eventid è int, senza impostazione predefinita.

Nella tabella seguente vengono descritti gli eventi che è possibile aggiungere o rimuovere in una traccia.

Numero evento Nome evento Descrizione
0 a 9 Reserved Prenotato
10 RPC:Completed Viene generato al completamento di una chiamata di procedura remota (RPC).
11 RPC:Starting Viene generato all'avvio di una chiamata RPC.
12 SQL:BatchCompleted Si verifica al completamento di un batch Transact-SQL.
13 SQL:BatchStarting Si verifica all'avvio di un batch Transact-SQL.
14 Audit Login Si verifica quando un utente accede correttamente a SQL Server.
15 Audit Logout Si verifica quando un utente si disconnette da SQL Server.
16 Attention Viene generato per eventi di attenzione, come le richieste di interrupt dei client o l'interruzione di connessioni client.
17 ExistingConnection Rileva tutte le attività da parte degli utenti connessi a SQL Server prima dell'avvio della traccia.
18 Audit Server Starts and Stops Si verifica quando viene modificato lo stato del servizio SQL Server.
19 DTCTransaction Tiene traccia delle transazioni coordinate di Microsoft Distributed Transaction Coordinator (MS DTC) tra due o più database.
20 Audit Login Failed Indica che un tentativo di accesso a SQL Server da un client non è riuscito.
21 EventLog Indica che sono stati registrati eventi nel registro applicazioni di Windows.
22 ErrorLog Indica che gli eventi di errore sono stati registrati nel log degli errori di SQL Server.
23 Lock:Released Indica il rilascio di un blocco su una risorsa, ad esempio una pagina.
24 Lock:Acquired Indica l'acquisizione di un blocco su una risorsa, ad esempio una pagina di dati.
25 Lock:Deadlock Indica che due transazioni simultanee si sono bloccate a vicenda con un deadlock, in seguito al tentativo di una transazione di ottenere blocchi incompatibili sulle risorse di proprietà dell'altra transazione.
26 Lock:Cancel Indica l'annullamento dell'acquisizione di un blocco su una risorsa, ad esempio in seguito a un deadlock.
27 Lock:Timeout Indica il timeout di una richiesta di blocco su una risorsa, come una pagina, dovuto alla presenza di un blocco su tale risorsa mantenuto attivo da un'altra transazione. Il timeout è determinato dalla funzione @@LOCK_TIMEOUT e può essere impostato con l'istruzione SET LOCK_TIMEOUT.
28 Degree of Parallelism Event Viene generato prima dell'esecuzione di un'istruzione SELECT, INSERT o UPDATE.
29 a 31 Reserved Utilizzare l'evento 28 in alternativa.
32 Reserved Prenotato
33 Exception Indica che si è verificata un'eccezione in SQL Server.
34 SP:CacheMiss Indica quando una stored procedure non viene trovata nella cache delle procedure.
35 SP:CacheInsert Indica l'inserimento di un elemento nella cache delle procedure.
36 SP:CacheRemove Indica la rimozione di un elemento dalla cache delle procedure.
37 SP:Recompile Indica la ricompilazione di una stored procedure.
38 SP:CacheHit Indica l'individuazione di una stored procedure nella cache delle procedure.
39 Deprecated Deprecato
40 SQL:StmtStarting Si verifica all'avvio dell'istruzione Transact-SQL.
41 SQL:StmtCompleted Si verifica quando l'istruzione Transact-SQL è stata completata.
42 SP:Starting Indica l'avvio della stored procedure.
43 SP:Completed Indica il completamento della stored procedure.
44 SP:StmtStarting Indica che è stata avviata l'esecuzione di un'istruzione Transact-SQL all'interno di una stored procedure.
45 SP:StmtCompleted Indica che un'istruzione Transact-SQL all'interno di una stored procedure è stata completata.
46 Object:Created Indica la creazione di un oggetto, ad esempio tramite le istruzioni CREATE INDEX, CREATE TABLE e CREATE DATABASE.
47 Object:Deleted Indica l'eliminazione di un oggetto, ad esempio tramite le istruzioni DROP INDEX e DROP TABLE.
48 Reserved
49 Reserved
50 SQL Transaction Tiene traccia delle istruzioni Transact-SQL BEGIN, COMMIT, SAVE e ROLLBACK TRANSACTION.
51 Scan:Started Indica l'avvio dell'analisi di una tabella o di un indice.
52 Scan:Stopped Indica l'arresto dell'analisi di una tabella o di un indice.
53 CursorOpen Indica quando un cursore viene aperto in un'istruzione Transact-SQL da ODBC, OLE DB o DB-Library.
54 TransactionLog Tiene traccia del momento in cui le transazioni vengono scritte nel log delle transazioni.
55 Hash Warning Indica che un'operazione di hashing (ad esempio, hash join, aggregazione hash, unione hash e hash distinct) che non viene elaborata in una partizione di buffer è stata ripristinata in un piano alternativo. Ciò può verificarsi a causa del livello di nidificazione della ricorsione, di asimmetrie dei dati, di flag di traccia o del conteggio dei bit.
56 a 57 Reserved
58 Auto Stats Indica un aggiornamento automatico delle statistiche dell'indice.
59 Lock:Deadlock Chain Viene generato per ogni evento che ha portato al deadlock.
60 Lock:Escalation Indica la conversione di un blocco con granularità fine in un blocco con granularità grossolana, come nel caso di un blocco a livello di pagina convertito (escalation) in un blocco TABLE o HoBT.
61 OLE DB Errors Indica la generazione di un errore OLE DB.
62 a 66 Reserved
67 Execution Warnings Indica eventuali avvisi che si sono verificati durante l'esecuzione di un'istruzione o di una stored procedure di SQL Server.
68 Showplan Text (Unencoded) Visualizza l'albero del piano dell'istruzione Transact-SQL eseguita.
69 Sort Warnings Indica le operazioni di ordinamento che non rientrano nella memoria. Non include operazioni di ordinamento che coinvolgono la creazione di indici; solo le operazioni di ordinamento all'interno di una query, ad esempio una clausola ORDER BY usata in un'istruzione SELECT.
70 CursorPrepare Indica quando un cursore in un'istruzione Transact-SQL viene preparato per l'uso da PARTE di ODBC, OLE DB o DB-Library.
71 Prepare SQL ODBC, OLE DB o DB-Library ha preparato un'istruzione o istruzioni Transact-SQL da usare.
72 Exec Prepared SQL ODBC, OLE DB o DB-Library ha eseguito un'istruzione o istruzioni Transact-SQL preparate.
73 Unprepare SQL ODBC, OLE DB o DB-Library include istruzioni o istruzioni Transact-SQL preparate non preparate (eliminate).
74 CursorExecute Viene eseguito un cursore preparato in precedenza in un'istruzione Transact-SQL da ODBC, OLE DB o DB-Library.
75 CursorRecompile Un cursore aperto in un'istruzione Transact-SQL da ODBC o DB-Library è stato ricompilato direttamente o a causa di una modifica dello schema.

Evento generato per cursori ANSI e non ANSI.
76 CursorImplicitConversion Un cursore in un'istruzione Transact-SQL viene convertito da SQL Server da un tipo a un altro.

Evento generato per cursori ANSI e non ANSI.
77 CursorUnprepare Un cursore preparato in un'istruzione Transact-SQL non è preparato (eliminato) da ODBC, OLE DB o DB-Library.
78 CursorClose Un cursore aperto in precedenza in un'istruzione Transact-SQL da ODBC, OLE DB o DB-Library viene chiuso.
79 Missing Column Statistics Le statistiche sulle colonne che potrebbero essere utili per l'utilità di ottimizzazione non sono disponibili.
80 Missing Join Predicate La query che non è un predicato di join viene eseguita. Ciò può comportare tempi di esecuzione della query prolungati.
81 Server Memory Change L'utilizzo della memoria di SQL Server è aumentato o diminuito di 1 megabyte (MB) o del 5% della memoria massima del server, a qualsiasi valore maggiore.
82 a 91 User Configurable (0 - 9) Dati di evento definiti dall'utente.
92 Data File Auto Grow Indica che le dimensioni di un file di dati sono state aumentate automaticamente dal server.
93 Log File Auto Grow Indica che le dimensioni di un file di log sono state aumentate automaticamente dal server.
94 Data File Auto Shrink Indica che le dimensioni di un file di dati sono state compattate automaticamente dal server.
95 Log File Auto Shrink Indica che le dimensioni di un file di log sono state compattate automaticamente dal server.
96 Showplan Text Visualizza l'albero del piano della query dell'istruzione SQL da Query Optimizer. La TextData colonna non contiene showplan per questo evento.
97 Showplan All Visualizza il piano della query con dettagli completi sulla fase di compilazione dell'istruzione SQL eseguita. La TextData colonna non contiene showplan per questo evento.
98 Showplan Statistics Profile Visualizza il piano della query con dettagli completi sulla fase di esecuzione dell'istruzione SQL eseguita. La TextData colonna non contiene showplan per questo evento.
99 Reserved
100 RPC Output Parameter Genera valori di output dei parametri per ogni chiamata RPC.
101 Reserved
102 Audit Database Scope GDR Si verifica ogni volta che un'autorizzazione GRANT, DENY, REVOKE per un'istruzione viene rilasciata da qualsiasi utente in SQL Server per azioni solo database, ad esempio la concessione di autorizzazioni per un database.
103 Audit Object GDR Event Si verifica ogni volta che un'autorizzazione GRANT, DENY, REVOKE per un oggetto viene rilasciata da qualsiasi utente in SQL Server.
104 Audit AddLogin Event Si verifica quando viene aggiunto o rimosso un account di accesso di SQL Server; per sp_addlogin e sp_droplogin.
105 Audit Login GDR Event Si verifica quando viene aggiunto o rimosso un diritto di accesso di Windows; per sp_grantlogin, sp_revokelogine sp_denylogin.
106 Audit Login Change Property Event Si verifica quando viene modificata una proprietà di un account di accesso, ad eccezione delle password; per sp_defaultdb e sp_defaultlanguage.
107 Audit Login Change Password Event Si verifica quando viene modificata una password di accesso di SQL Server.

Le password non vengono registrate.
108 Audit Add Login to Server Role Event Si verifica quando un account di accesso viene aggiunto o rimosso da un ruolo predefinito del server; per sp_addsrvrolemembere sp_dropsrvrolemember.
109 Audit Add DB User Event Si verifica quando un account di accesso viene aggiunto o rimosso come utente del database (Windows o SQL Server) a un database; per sp_grantdbaccess, sp_revokedbaccess, sp_addusere sp_dropuser.
110 Audit Add Member to DB Role Event Si verifica quando un account di accesso viene aggiunto o rimosso come utente del database (fisso o definito dall'utente) a un database; per sp_addrolemember, sp_droprolemembere sp_changegroup.
111 Audit Add Role Event Si verifica quando un account di accesso viene aggiunto o rimosso come utente del database a un database; per sp_addrole e sp_droprole.
112 Audit App Role Change Password Event Viene generato per la modifica di una password di un ruolo applicazione.
113 Audit Statement Permission Event Viene generato quando si utilizza un'autorizzazione per le istruzioni, ad esempio CREATE TABLE.
114 Audit Schema Object Access Event Viene generato quando si utilizza un'autorizzazione per gli oggetti (ad esempio SELECT) con esito sia positivo che negativo.
115 Audit Backup/Restore Event Viene generato per l'esecuzione di un comando BACKUP o RESTORE.
116 Audit DBCC Event Viene generato per l'esecuzione di comandi DBCC.
117 Audit Change Audit Event Viene generato per modifiche apportate alla traccia di controllo.
118 Audit Object Derived Permission Event Viene generato per l'esecuzione dei comandi per gli oggetti CREATE, ALTER e DROP.
119 OLEDB Call Event Viene generato per l'esecuzione di chiamate del provider OLE DB per query distribuite e stored procedure remote.
120 OLEDB QueryInterface Event Si verifica quando vengono effettuate chiamate OLE DB QueryInterface per query distribuite e stored procedure remote.
121 OLEDB DataRead Event Viene generato per l'esecuzione di una chiamata di richiesta di dati al provider OLE DB.
122 Showplan XML Si verifica quando viene eseguita un'istruzione SQL. Includere questo evento per identificare gli operatori Showplan. Ogni evento viene archiviato in un documento XML ben formato. La Binary colonna per questo evento contiene l'oggetto Showplan codificato. Utilizzare SQL Server Profiler per aprire la traccia e visualizzare il piano Showplan.
123 SQL:FullTextQuery Viene generato per l'esecuzione di una query full-text.
124 Broker:Conversation Segnala lo stato di avanzamento di una conversazione di Service Broker.
125 Deprecation Announcement Si verifica quando si usa una funzionalità che verrà rimossa da una versione futura di SQL Server.
126 Deprecation Final Support Si verifica quando si usa una funzionalità che verrà rimossa dalla versione principale successiva di SQL Server.
127 Exchange Spill Event Si verifica quando i buffer di comunicazione in un piano di query parallelo sono stati scritti temporaneamente nel tempdb database.
128 Audit Database Management Event Viene generato per la creazione, modifica o eliminazione di un database.
129 Audit Database Object Management Event Viene generato per l'esecuzione di un'istruzione CREATE, ALTER o DROP sugli oggetti di database, come gli schemi.
130 Audit Database Principal Management Event Viene generato quando in un database vengono create, modificate o eliminate entità, come gli utenti.
131 Audit Schema Object Management Event Viene generato per la creazione, modifica o eliminazione di oggetti del server.
132 Audit Server Principal Impersonation Event Si verifica quando è presente una rappresentazione all'interno dell'ambito del server, ad esempio EXECUTE AS LOGIN.
133 Audit Database Principal Impersonation Event Viene generato in presenza di una rappresentazione nell'ambito del database, come per EXECUTE AS USER o SETUSER.
134 Audit Server Object Take Ownership Event Viene generato per la modifica del proprietario degli oggetti nell'ambito del server.
135 Audit Database Object Take Ownership Event Viene generato per la modifica del proprietario degli oggetti nell'ambito del database.
136 Broker:Conversation Group Si verifica quando Service Broker crea un nuovo gruppo di conversazioni o elimina un gruppo di conversazioni esistente.
137 Blocked Process Report Viene generato quando un processo rimane bloccato per un periodo di tempo maggiore di quello specificato. Non include processi o processi di sistema in attesa di risorse non rilevabili da deadlock. Usare sp_configure per configurare la soglia e la frequenza con cui vengono generati i report.
138 Broker:Connection Segnala lo stato di una connessione di trasporto gestita da Service Broker.
139 Broker:Forwarded Message Sent Si verifica quando Service Broker inoltra un messaggio.
140 Broker:Forwarded Message Dropped Si verifica quando Service Broker elimina un messaggio che deve essere inoltrato.
141 Broker:Message Classify Si verifica quando Service Broker determina il routing per un messaggio.
142 Broker:Transmission Indica che si sono verificati errori nel livello di trasporto di Service Broker. Il numero di errore e i valori di stato indicano l'origine dell'errore.
143 Broker:Queue Disabled Indica che è stato rilevato un messaggio non elaborabile perché sono presenti cinque rollback consecutivi delle transazioni in una coda di Service Broker. L'evento include l'ID del database e l'ID della coda contenente il messaggio non elaborabile.
144 a 145 Reserved
146 Showplan XML Statistics Profile Si verifica quando viene eseguita un'istruzione SQL. Identifica gli operatori Showplan e visualizza dati completi della fase di compilazione. La Binary colonna per questo evento contiene l'oggetto Showplan codificato. Utilizzare SQL Server Profiler per aprire la traccia e visualizzare il piano Showplan.
148 Deadlock Graph Viene generato in seguito all'annullamento di un tentativo di acquisizione di un blocco, perché il tentativo fa parte di un deadlock ed è stato scelto come vittima del deadlock. Include una descrizione XML di un deadlock.
149 Broker:Remote Message Acknowledgement Si verifica quando Service Broker invia o riceve un riconoscimento del messaggio.
150 Trace File Close Viene generato quando un file di traccia viene chiuso durante il rollover di un file di traccia.
151 Reserved
152 Audit Change Database Owner Viene generato quando l'istruzione ALTER AUTHORIZATION viene utilizzata per modificare il proprietario di un database e vengono controllate le autorizzazioni a tale scopo.
153 Audit Schema Object Take Ownership Event Viene generato quando l'istruzione ALTER AUTHORIZATION viene utilizzata per assegnare un proprietario a un oggetto e vengono controllate le autorizzazioni a tale scopo.
154 Reserved
155 FT:Crawl Started Viene generato all'avvio di una ricerca per indicizzazione (popolamento) full-text. Utilizzare questo evento per verificare che una richiesta di ricerca per indicizzazione venga effettivamente accolta dalle attività di lavoro.
156 FT:Crawl Stopped Viene generato all'arresto di una ricerca per indicizzazione (popolamento) full-text. L'arresto può essere causato dal corretto completamento dell'operazione o da un errore irreversibile.
157 FT:Crawl Aborted Viene generato quando si rileva un'eccezione durante una ricerca per indicizzazione full-text. In genere l'eccezione causa l'arresto della ricerca per indicizzazione full-text.
158 Audit Broker Conversation Segnala i messaggi di controllo correlati alla sicurezza del dialogo di Service Broker.
159 Audit Broker Login Segnala i messaggi di controllo correlati alla sicurezza del trasporto di Service Broker.
160 Broker:Message Undeliverable Si verifica quando Service Broker non è in grado di conservare un messaggio ricevuto che deve essere stato recapitato a un servizio.
161 Broker:Corrupted Message Si verifica quando Service Broker riceve un messaggio danneggiato.
162 User Error Message Indica i messaggi di errori visualizzati agli utenti in caso di errore o eccezione.
163 Broker:Activation Si verifica quando un monitoraggio code avvia una stored procedure di attivazione, invia una QUEUE_ACTIVATION notifica o quando viene chiusa una stored procedure di attivazione avviata da un monitoraggio code.
164 Object:Altered Viene generato per la modifica di un oggetto di database.
165 Performance statistics Viene generato quando un piano di query compilato viene memorizzato nella cache per la prima volta, ricompilato o rimosso dalla cache dei piani.
166 SQL:StmtRecompile Viene generato quando si verifica una ricompilazione a livello di istruzione.
167 Database Mirroring State Change Viene generato per la modifica dello stato di un database con mirroring.
168 Showplan XML For Query Compile Si verifica quando viene compilata un'istruzione SQL. Vengono visualizzati dati completi della fase di compilazione. La Binary colonna per questo evento contiene l'oggetto Showplan codificato. Utilizzare SQL Server Profiler per aprire la traccia e visualizzare il piano Showplan.
169 Showplan All For Query Compile Si verifica quando viene compilata un'istruzione SQL. Vengono visualizzati dati completi della fase di compilazione. Utilizzare questo evento per identificare gli operatori Showplan.
170 Audit Server Scope GDR Event Indica che è stato generato un evento di concessione, negazione o revoca di autorizzazioni nell'ambito del server, come la creazione di un account di accesso.
171 Audit Server Object GDR Event Indica che è stato generato un evento di concessione, negazione o revoca per un oggetto dello schema, come una tabella o una funzione.
172 Audit Database Object GDR Event Indica che è stato generato un evento di concessione, negazione o revoca per oggetti di database, come assembly e schemi.
173 Audit Server Operation Event Viene generato quando si utilizzano operazioni di controllo della sicurezza, come la modifica di impostazioni, risorse, opzioni per l'accesso esterno o autorizzazioni.
175 Audit Server Alter Trace Event Viene generato quando un'istruzione verifica la presenza dell'autorizzazione ALTER TRACE.
176 Audit Server Object Management Event Viene generato per la creazione, modifica o eliminazione di oggetti del server.
177 Audit Server Principal Management Event Viene generato per la creazione, modifica o eliminazione di entità del server.
178 Audit Database Operation Event Viene generato quando si eseguono operazioni di database, come la creazione di checkpoint o la sottoscrizione di notifica delle query.
180 Audit Database Object Access Event Viene generato per l'accesso a oggetti di database, come gli schemi.
181 TM: Begin Tran starting Si verifica all'avvio di una BEGIN TRANSACTION richiesta.
182 TM: Begin Tran completed Si verifica al completamento di una BEGIN TRANSACTION richiesta.
183 TM: Promote Tran starting Si verifica all'avvio di una PROMOTE TRANSACTION richiesta.
184 TM: Promote Tran completed Si verifica al completamento di una PROMOTE TRANSACTION richiesta.
185 TM: Commit Tran starting Si verifica all'avvio di una COMMIT TRANSACTION richiesta.
186 TM: Commit Tran completed Si verifica al completamento di una COMMIT TRANSACTION richiesta.
187 TM: Rollback Tran starting Si verifica all'avvio di una ROLLBACK TRANSACTION richiesta.
188 TM: Rollback Tran completed Si verifica al completamento di una ROLLBACK TRANSACTION richiesta.
189 Lock:Timeout (timeout > 0) Viene generato quando si verifica il timeout di una richiesta di blocco su una risorsa, ad esempio una pagina.
190 Progress Report: Online Index Operation Indica lo stato di un'operazione di compilazione di un indice online durante l'esecuzione del processo di compilazione.
191 TM: Save Tran starting Si verifica all'avvio di una SAVE TRANSACTION richiesta.
192 TM: Save Tran completed Si verifica al completamento di una SAVE TRANSACTION richiesta.
193 Background Job Error Viene generato quando un processo in background termina in modo anomalo.
194 OLEDB Provider Information Viene generato quando si esegue una query distribuita e tale query raccoglie informazioni corrispondenti alla connessione del provider.
195 Mount Tape Viene generato alla ricezione di una richiesta di montaggio nastro.
196 Assembly Load Viene generato in presenza di una richiesta di caricamento di un assembly CLR.
197 Reserved
198 XQuery Static Type Viene generato quando si esegue un'espressione XQuery. Tramite questa classe di evento viene fornito il tipo statico dell'espressione XQuery.
199 QN: subscription Si verifica quando non è possibile sottoscrivere una registrazione di query. La TextData colonna contiene informazioni sull'evento.
200 QN: parameter table Le informazioni sulle sottoscrizioni attive vengono archiviate in tabelle di parametri interne. Questa classe di evento viene generata per la creazione o l'eliminazione di una tabella di parametri. In genere, queste tabelle vengono create o eliminate in caso di riavvio del database. La TextData colonna contiene informazioni sull'evento.
201 QN: template Un modello di query rappresenta una classe di query di sottoscrizione. In genere, le query della stessa classe sono identiche con l'eccezione dei valori dei parametri. Questa classe di evento si verifica quando una nuova richiesta di sottoscrizione rientra in una classe già esistente di (Match), una nuova classe (Create) o una Drop classe, che indica la pulizia dei modelli per le classi di query senza sottoscrizioni attive. La TextData colonna contiene informazioni sull'evento.
202 QN: dynamics Tiene traccia delle attività interne di notifica delle query. La TextData colonna contiene informazioni sull'evento.
212 Bitmap Warning Indica quando i filtri bitmap sono stati disabilitati in una query.
213 Database Suspect Data Page Indica quando una pagina viene aggiunta alla suspect_pages tabella in msdb.
214 CPU threshold exceeded Indica quando Resource Governor rileva che una query ha superato il valore di soglia della CPU (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Indica quando un trigger LOGON o la funzione di classificazione di Resource Governor avvia l'esecuzione.
216 PreConnect:Completed Indica quando un trigger LOGON o la funzione di classificazione di Resource Governor completa l'esecuzione.
217 Plan Guide Successful Indica che la motore di database ha prodotto correttamente un piano di esecuzione per una query o un batch contenente una guida di piano.
218 Plan Guide Unsuccessful Indica che il motore di database non è riuscito a produrre un piano di esecuzione per una query o un batch contenente una guida di piano. Il motore di database ha tentato di generare un piano di esecuzione per questa query o batch senza applicare la guida di piano. Una guida di piano non valida potrebbe essere la causa di questo problema. È possibile convalidare la guida di piano usando la sys.fn_validate_plan_guide funzione di sistema.
235 Audit Fulltext

[ @columnid = ] columnid

ID della colonna da aggiungere per l'evento. @columnid è int, senza impostazione predefinita.

Nella tabella seguente sono incluse le colonne che è possibile aggiungere per un evento.

Column number Nome colonna Descrizione
1 TextData Valore di testo che dipende dalla classe di evento acquisita nella traccia.
2 BinaryData Valore binario che dipende dalla classe di evento acquisita nella traccia.
3 DatabaseID ID del database specificato dall'istruzione USE database o database predefinito se non viene eseguita alcuna istruzione USE database per una determinata connessione.

È possibile determinare l'ID di un database utilizzando la funzione DB_ID.
4 TransactionID ID della transazione assegnato dal sistema.
5 LineNumber Contiene il numero della riga contenente l'errore. Per gli eventi che coinvolgono istruzioni Transact-SQL, ad esempio SP:StmtStarting, contiene LineNumber il numero di riga dell'istruzione nella stored procedure o nel batch.
6 NTUserName Nome utente di Windows.
7 NTDomainName Dominio Windows di appartenenza dell'utente.
8 HostName Nome del computer client che ha eseguito la richiesta.
9 ClientProcessID ID assegnato dal computer client al processo in cui è in esecuzione l'applicazione client.
10 ApplicationName Nome dell'applicazione client che ha creato la connessione a un'istanza di SQL Server. Questa colonna viene popolata con i valori passati dall'applicazione e non con il nome visualizzato del programma.
11 LoginName Nome di accesso di SQL Server del client.
12 SPID ID processo server assegnato da SQL Server al processo associato al client.
13 Duration Durata dell'evento in microsecondi. Questa colonna di dati non viene popolata dall'evento Hash Warning .
14 StartTime Ora di inizio dell'evento, se disponibile.
15 EndTime Ora di fine dell'evento. Questa colonna non viene popolata per le classi di evento iniziali, ad esempio SQL:BatchStarting o SP:Starting. Non viene popolato anche dall'evento Hash Warning .
16 Reads Numero di letture logiche del disco eseguite dal server per conto dell'evento. Questa colonna non viene popolata dall'evento Lock:Released .
17 Writes Numero di scritture fisiche su disco eseguite dal server per conto dell'evento.
18 CPU Tempo della CPU in millisecondi utilizzato dall'evento.
19 Permissions Rappresenta la mappa di bit delle autorizzazioni e viene utilizzata per il controllo di sicurezza.
20 Severity Livello di gravità di un'eccezione.
21 EventSubClass Tipo di sottoclasse di evento. Questa colonna di dati non viene popolata per tutte le classi di evento.
22 ObjectID ID dell'oggetto assegnato dal sistema.
23 Success Esito del tentativo di utilizzo delle autorizzazioni; valore utilizzato per il controllo.

1 = esito positivo
0 = errore
24 IndexID ID dell'indice dell'oggetto interessato dall'evento. Per determinare l'ID di indice per un oggetto, utilizzare la indid colonna della tabella di sysindexes sistema.
25 IntegerData Valore integer che dipende dalla classe di evento acquisita nella traccia.
26 ServerName Nome dell'istanza di SQL Server, nomeserver o nomeserver\nomeistanza, da tracciare.
27 EventClass Tipo di classe di evento che viene registrato.
28 ObjectType Tipo di oggetto, ad esempio tabella, funzione o stored procedure.
29 NestLevel Livello di nidificazione in cui viene eseguita la stored procedure. Vedere @@NESTLEVEL.
30 State Stato del server in caso di errore.
31 Error Numero di errore.
32 Mode Modalità del blocco acquisito. Questa colonna non viene popolata dall'evento Lock:Released .
33 Handle Handle dell'oggetto a cui si fa riferimento nell'evento.
34 ObjectName Nome dell'oggetto a cui si accede.
35 DatabaseName Nome del database specificato nell'istruzione USE database .
36 FileName Nome logico del nome di file modificato.
37 OwnerName Nome del proprietario dell'oggetto a cui si fa riferimento.
38 RoleName Nome del ruolo del database o del server a cui viene applicata un'istruzione.
39 TargetUserName Nome utente della destinazione di un'azione.
40 DBUserName Nome utente del database di SQL Server del client.
41 LoginSid ID di sicurezza (SID) dell'utente connesso.
42 TargetLoginName Nome dell'account di accesso della destinazione di un'azione.
43 TargetLoginSid SID dell'account di accesso che rappresenta la destinazione di un'azione.
44 ColumnPermissions Stato delle autorizzazioni a livello di colonna; valore utilizzato per il controllo di sicurezza.
45 LinkedServerName Nome del server collegato.
46 ProviderName Nome del provider OLE DB.
47 MethodName Nome del metodo OLE DB.
48 RowCounts Numero di righe nel batch.
49 RequestID ID della richiesta contenente l'istruzione.
50 XactSequence Token utilizzato per descrivere la transazione corrente.
51 EventSequence Numero di sequenza dell'evento.
52 BigintData1 valore bigint , che dipende dalla classe di evento acquisita nella traccia.
53 BigintData2 valore bigint , che dipende dalla classe di evento acquisita nella traccia.
54 GUID Valore GUID che dipende dalla classe di evento acquisita nella traccia.
55 IntegerData2 Valore intero che dipende dalla classe di evento acquisita nella traccia.
56 ObjectID2 ID dell'entità o dell'oggetto correlato, se disponibile.
57 Type Valore intero che dipende dalla classe di evento acquisita nella traccia.
58 OwnerID Tipo di oggetto proprietario del blocco. Solo per gli eventi di blocco.
59 ParentName Nome dello schema in cui è incluso l'oggetto.
60 IsSystem Indica se l'evento è stato generato per un processo di sistema o un processo utente.

1 = sistema
0 = utente.
61 Offset Offset iniziale dell'istruzione nella stored procedure o nel batch.
62 SourceDatabaseID ID del database in cui esiste l'origine dell'oggetto.
63 SqlHandle Hash a 64 bit in base al testo di una query ad hoc o al database e all'ID oggetto di un oggetto SQL. Questo valore può essere passato a sys.dm_exec_sql_text() per recuperare il testo SQL associato.
64 SessionLoginName Nome dell'account di accesso dell'utente che ha avviato la sessione. Ad esempio, se ci si connette a SQL Server usando Login1 ed eseguire un'istruzione come Login2, SessionLoginName visualizza Login1, mentre LoginName visualizza Login2. In questa colonna di dati vengono visualizzati sia gli account di accesso di SQL Server che quelli di Windows.

[ @on = ] on

Specifica se abilitare (1) o disabilitare (0) l'evento. @on è bit, senza impostazione predefinita.

Se @on è impostato su 1e @columnid è NULL, l'evento viene impostato su ON e tutte le colonne vengono cancellate. Se @columnid non è Null, la colonna viene impostata su ON per tale evento.

Se @on è impostato su 0e @columnid è NULL, l'evento viene attivato OFF e tutte le colonne vengono cancellate. Se @columnid non è Null, la colonna viene disattivata.

Questa tabella illustra l'interazione tra @on e @columnid.

@on @columnid Risultato
ON (1) NULL L'evento è attivato.

Tutte le colonne vengono cancellate.
NOT NULL La colonna è attivata per l'evento specificato.
OFF (0) NULL L'evento è disattivato.

Tutte le colonne vengono cancellate.
NOT NULL La colonna è disattivata per l'evento specificato.

Valori del codice restituito

Nella tabella seguente vengono descritti i valori di codice che è possibile ottenere, dopo il completamento della stored procedure.

Codice restituito Descrizione
0 Nessun errore.
1 Errore sconosciuto.
2 La traccia è in esecuzione. Se si modifica la traccia mentre è in esecuzione, viene generato un errore.
3 L'evento specificato non è valido. L'evento potrebbe non esistere o non è appropriato per la procedura di archiviazione.
4 La colonna specificata non è valida.
9 L'handle di traccia specificato non è valido.
11 La colonna specificata viene usata internamente e non può essere rimossa.
13 Memoria esaurita. Restituito quando non è disponibile memoria sufficiente per eseguire l'azione specificata.
16 La funzione non è valida per questa traccia.

Osservazioni:

sp_trace_setevent esegue molte delle azioni eseguite in precedenza da stored procedure estese disponibili nelle versioni precedenti di SQL Server. Usare sp_trace_setevent invece di:

  • xp_trace_addnewqueue
  • xp_trace_eventclassrequired
  • xp_trace_seteventclassrequired

Gli utenti devono eseguire sp_trace_setevent per ogni colonna aggiunta per ogni evento. Durante ogni esecuzione, se @on è impostato su 1, sp_trace_setevent aggiunge l'evento specificato all'elenco di eventi della traccia. Se @on è impostato su 0, sp_trace_setevent rimuove l'evento specificato dall'elenco.

I parametri di tutte le stored procedure di traccia SQL (sp_trace_*) sono rigorosamente tipizzato. Se tali parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituisce un errore.

Per un esempio di utilizzo di stored procedure di traccia, vedere Creare una traccia.

Autorizzazioni

È richiesta l'autorizzazione ALTER TRACE.

Contenuto correlato