Article
09/27/2010

sp_trace_setevent (Transact-SQL)

Ajoute ou supprime un événement ou une colonne d'événement à une trace. sp_trace_setevent ne peut être exécuté que sur les traces existantes qui sont arrêtées (l'argument status prend la valeur 0). Une erreur est retournée si la procédure stockée est exécutée sur une trace qui n'existe pas ou si l'argument status qu'elle contient n'est pas égal à 0.

Icône Lien de rubrique Conventions de syntaxe Transact-SQL

Syntaxe

sp_trace_setevent [ @traceid = ] trace_id 
          , [ @eventid = ] event_id
          , [ @columnid = ] column_id
          , [ @on = ] on

Arguments

[ @traceid= ] trace_id
ID de la trace à modifier. L'argument trace_id est de type int et ne possède pas de valeur par défaut. L'utilisateur emploie cette valeur trace_id pour identifier, modifier et contrôler la trace.
[ @eventid= ] event_id
Identificateur de l'événement à activer. L'argument event_id est de type int et ne possède pas de valeur par défaut.

Ce tableau répertorie les événements qui peuvent être ajoutés ou supprimés d'une trace.

Numéro d'événement	Nom d'événement	Description
0-9	Réservé	Réservé
10	RPC:Completed	Se produit lorsqu'un appel de procédure distante (RPC) s'est terminé.
11	RPC:Starting	Se produit lorsqu'un appel de procédure distante a commencé.
12	SQL:BatchCompleted	Se produit lorsqu'un traitement d'instructions Transact-SQL est terminé.
13	SQL:BatchStarting	Se produit lorsqu'un traitementTransact-SQL a démarré.
14	Audit Login	Se produit lorsqu'un utilisateur réussit à se connecter à SQL Server.
15	Audit Logout	Se produit lorsqu'un utilisateur se déconnecte de SQL Server.
16	Attention	Se produit en même temps que les événements d'avertissement, tels que les requêtes d'interruption du client ou les ruptures de connexion client.
17	ExistingConnection	Détecte toutes les activités des utilisateurs connectés à SQL Server avant le démarrage de la trace.
18	Audit Server Starts and Stops	Se produit lorsque l'état des services SQL Server est modifié.
19	DTCTransaction	Assure le suivi des transactions coordonnées MS DTC (Microsoft Distributed Transaction Coordinator) entre plusieurs bases de données.
20	Audit Login Failed	Indique qu'une tentative de connexion à SQL Server depuis un client a échoué.
21	EventLog	Indique que les événements ont été enregistrés dans le journal des applications Windows.
22	ErrorLog	Indique que les événements d'erreurs ont été enregistrés dans le journal des erreurs SQL Server.
23	Lock:Release	Indique qu'un verrou sur une ressource, une page par exemple, a été débloqué.
24	Lock:Acquire	Indique qu'un verrou a été acquis sur une ressource, une page de données par exemple.
25	Lock:Deadlock	Indique que deux transactions concurrentes ont généré un interblocage, l'une essayant d'obtenir des verrous incompatibles sur des ressources appartenant à l'autre.
26	Lock:Canceled	Indique que l'acquisition d'un verrou sur une ressource a été annulée (par exemple à cause d'un interblocage).
27	Lock:Timeout	Indique qu'une demande de verrou sur une ressource (par exemple une page) a dépassé le délai d'attente parce qu'une autre transaction retient un verrou bloquant sur la ressource requise. Le délai d'attente est déterminé par la fonction @@LOCK_TIMEOUT et peut être défini à l'aide de l'instruction SET LOCK_TIMEOUT.
28	Degré d'événement de parallélisme (Insertion 7.0)	Se produit avant l'exécution d'une instruction SELECT, INSERT ou UPDATE.
29-31	Réservé	Utilisez plutôt l'événement 28.
32	Réservé	Réservé
33	Exception	Indique qu'une exception s'est produite dans SQL Server.
34	SP:CacheMiss	Indique qu'une procédure stockée est introuvable dans le cache de procédure.
35	SP:CacheInsert	Indique qu'un élément est inséré dans le cache de procédure.
36	SP:CacheRemove	Indique qu'un élément est supprimé du cache de procédure.
37	SP:Recompile	Indique qu'une procédure stockée a été recompilée.
38	SP:CacheHit	Indique qu'une procédure stockée est trouvée dans le cache de procédure.
39	Désapprouvé	Désapprouvé
40	SQL:StmtStarting	Se produit lorsque l'instruction Transact-SQL a démarré.
41	SQL:StmtCompleted	Se produit lorsque l'instruction Transact-SQL est terminée.
42	SP:Starting	Indique que la procédure stockée a démarré.
43	SP:Completed	Indique que la procédure stockée s'est terminée.
44	SP:StmtStarting	Indique qu'une instruction Transact-SQL d'une procédure stockée a commencé à s'exécuter.
45	SP:StmtCompleted	Indique qu'une instruction Transact-SQL d'une procédure stockée a fini de s'exécuter.
46	Objetct:Created	Indique qu'un objet a été créé, par exemple avec les instructions CREATE INDEX, CREATE TABLE et CREATE DATABASE.
47	Object:Deleted	Indique qu'un objet a été supprimé, par exemple avec les instructions DROP INDEX et DROP TABLE.
48	Réservé
49	Réservé
50	SQL Transaction	Assure le suivi des instructions Transact-SQL BEGIN, COMMIT, SAVE et ROLLBACK TRANSACTION.
51	Scan:Started	Indique qu'une analyse de table ou d'index a démarré.
52	Scan:Stopped	Indique qu'une analyse de table ou d'index s'est terminée.
53	CursorOpen	Indique qu'un curseur a été ouvert dans une instruction Transact-SQL par ODBC, OLE DB ou la bibliothèque de bases de données.
54	TransactionLog	Trace à quel moment les transactions sont écrites dans le journal des transactions.
55	HashWarning	Indique qu'une opération de hachage (jointure hachée, agrégation hachée, union hachée, hachage distinct) qui n'est pas en cours sur un tampon de partition bascule vers un plan de rechange. Ceci se produit à cause de la profondeur de récurrence, du décalage des données, des indicateurs de trace ou du comptage des bits.
56-57	Réservé
58	Auto Stats	Indique qu'une mise à jour automatique des statistiques d'index a eu lieu.
59	Lock:Deadlock Chain	Produit pour chacun des événements entraînant le blocage.
60	Lock:Escalation	Se produit lorsqu'un verrouillage spécifique s'est transformé en verrouillage de grande ampleur (par exemple, un verrou de page augmenté ou converti en verrou TABLE ou HoBT).
61	OLE DB Errors	Indique qu'une erreur OLE DB s'est produite.
62-66	Réservé
67	ExecutionWarnings	Indique les messages d'avertissement survenus lors de l'exécution d'une instruction ou d'une procédure stockée SQL Server.
68	Showplan Text (non codée)	Affiche l'arborescence du plan de l'instruction Transact-SQL exécutée.
69	Sort Warnings	Indique les opérations de tri ne pouvant pas être effectuées en mémoire. N'inclut pas les opérations de tri comprenant la création d'index, seulement les opérations de tri au sein d'une requête (une clause ORDER BY dans une commande SELECT, par exemple).
70	CursorPrepare	Indique qu'un curseur dans une instruction Transact-SQL est préparé pour être utilisé par ODBC, OLE DB ou la bibliothèque de bases de données.
71	Prepare SQL	ODBC, OLE DB ou la bibliothèque de bases de données a préparé une ou plusieurs instructions Transact-SQL à utiliser.
72	Exec Prepared SQL	ODBC, OLE DB ou la bibliothèque de bases de données a exécuté une ou plusieurs instructions Transact-SQL préparées.
73	Unprepare SQL	ODBC, OLE DB ou la bibliothèque de bases de données a annulé la préparation (supprimé) d'une ou plusieurs instructions Transact-SQL préparées.
74	CursorExecute	Un curseur qui a été précédemment préparé dans une instruction Transact-SQL par ODBC, OLE DB ou la bibliothèque de bases de données est exécuté.
75	CursorRecompile	Un curseur ouvert dans une instruction Transact-SQL par ODBC ou la bibliothèque de bases de données a été recompilé soit directement, soit du fait d'un changement de schéma. Déclenché pour les curseurs ANSI et non-ANSI.
76	CursorImplicitConversion	Un curseur dans une instruction Transact-SQL est converti par SQL Server d'un type à un autre. Déclenché pour les curseurs ANSI et non-ANSI.
77	CursorUnprepare	Un curseur préparé dans une instruction Transact-SQL voit sa préparation annulée (= est supprimé) par ODBC, OLE DB ou la bibliothèque de bases de données.
78	CursorClose	Un curseur qui a été précédemment ouvert dans une instruction Transact-SQL par ODBC, OLE DB ou la bibliothèque de bases de données est fermé.
79	Missing Column Statistics	Des statistiques de colonne qui auraient pu être utiles pour l'optimiseur ne sont pas disponibles.
80	Missing Join Predicate	Une requête sans prédicat de jointure est en cours d'exécution. Ceci peut rendre la requête longue à exécuter.
81	Server Memory Change	L'utilisation de la mémoire de SQL Server a augmenté ou diminué, soit de 1 mégaoctet (Mo), soit de 5 % de la taille maximale de la mémoire du serveur, selon celle qui est la plus importante.
82-91	User Configurable (0 -9)	Données d’événement définies par l'utilisateur.
92	Data File Auto Grow	Indique qu'un fichier de données a été augmenté automatiquement par le serveur.
93	Log File Auto Grow	Indique qu'un fichier journal a été augmenté automatiquement par le serveur.
94	Data File Auto Shrink	Indique qu'un fichier de données a été réduit automatiquement par le serveur.
95	Log File Auto Shrink	Indique qu'un fichier journal a été réduit automatiquement par le serveur.
96	Showplan Text	Affiche l'arborescence du plan de requête de l'instruction SQL à partir de l'optimiseur de requête. Sachez que la colonne TextData ne contient pas de plan d'exécution de requêtes pour cet événement.
97	Showplan All	Affiche le plan de requête avec les détails complets de la compilation de l'instruction SQL en cours d'exécution. Sachez que la colonne TextData ne contient pas de plan d'exécution de requêtes pour cet événement.
98	Showplan Statistics Profile	Affiche le plan de requête avec les détails complets de l'exécution de l'instruction SQL en cours. Sachez que la colonne TextData ne contient pas de plan d'exécution de requêtes pour cet événement.
99	Réservé
100	RPC Output Parameter	Produit les valeurs de sortie des paramètres pour tous les RPC.
101	Réservé
102	Audit Statement GDR Event	Se produit à chaque fois qu'un utilisateur émet une instruction GRANT, DENY ou REVOKE relative à une autorisation d'instruction dans SQL Server.
103	Audit Object GDR Event	Se produit à chaque fois qu'un utilisateur émet une instruction GRANT, DENY ou REVOKE relative à une autorisation d'objet dans SQL Server.
104	Audit AddLogin Event	Se produit lorsqu'un nom de connexion SQL Server est ajouté ou supprimé ; pour sp_addlogin et sp_droplogin.
105	Audit Login GDR Event	Se produit lorsqu'un droit de connexion Windows est ajouté ou supprimé ; pour sp_grantlogin, sp_revokelogin et sp_denylogin.
106	Audit Login Change Property Event	Se produit lorsqu'une propriété d'une connexion d'accès, sauf pour les mots de passe, est modifiée ; pour sp_defaultdb et sp_defaultlanguage.
107	Audit Login Change Password Event	Se produit lorsqu'un mot de passe de connexion SQL Server est modifié. Les mots de passe ne sont pas enregistrés.
108	Audit Add Login to Server Role Event	Se produit lorsqu'une connexion d'accès est ajoutée ou supprimée d'un rôle serveur fixe ; pour sp_addsrvrolemember et sp_dropsrvrolemember.
109	Audit Add DB User Event	Se produit lorsqu'un nom de connexion est ajouté ou supprimé en tant qu'utilisateur de base de données (Windows ou SQL Server) dans une base de données ; pour sp_grantdbaccess, sp_revokedbaccess, sp_adduser et sp_dropuser.
110	Audit Add Member to DB Role Event	Se produit lorsqu'une connexion est ajoutée ou supprimée sous forme d'utilisateur de base de données (fixe ou défini par l'utilisateur) dans une base de données ; pour sp_addrolemember, sp_droprolemember et sp_changegroup.
111	Audit Add Role Event	Se produit lorsqu'une connexion d'accès est ajoutée ou supprimée sous forme d'utilisateur de base de données dans une base de données ; pour sp_addrole et sp_droprole.
112	Audit App Role Change Password Event	Se produit lorsque le mot de passe d'un rôle d'application est modifié.
113	Audit Statement Permission Event	Se produit lorsqu'une autorisation d'instruction (par exemple, CREATE TABLE) est utilisée.
114	Audit Schema Object Access Event	Se produit lorsqu'une autorisation d'objet (par exemple, SELECT) est utilisée, de manière réussie ou non.
115	Audit Backup/Restore Event	Se produit lorsqu'une commande BACKUP ou RESTORE est émise.
116	Audit DBCC Event	Se produit lorsque des commandes DBCC sont émises.
117	Audit Change Audit Event	Se produit lorsque des modifications de trace d'audit sont effectuées.
118	Audit Object Derived Permission Event	Se produit à l'émission de commandes des objets CREATE, ALTER et DROP.
119	OLEDB Call Event	Se produit lorsque des appels de fournisseur OLE DB sont effectués pour des requêtes distribuées et des procédures stockées distantes.
120	OLEDB QueryInterface Event	Se produit lorsque des appels QueryInterface OLE DB sont effectués pour des requêtes distribuées et des procédures stockées distantes.
121	OLEDB DataRead Event	Se produit lorsqu'un appel de requête de données est effectué vers le fournisseur OLE DB.
122	Showplan XML	Se produit lors de l'exécution d'une instruction SQL. Incluez cet événement pour identifier des opérateurs Showplan. Chaque événement est stocké dans un document XML correct. Sachez que la colonne Binary de cet événement ne contient pas de plan d'exécution de requêtes codé. Utilisez SQL Server Profiler pour ouvrir la trace et afficher le plan d'exécution de requêtes.
123	SQL:FullTextQuery	Se produit lors de l'exécution d'une requête de texte intégral.
124	Broker:Conversation	Indique la progression d'une conversation Service Broker.
125	Deprecation Announcement	Se produit lorsque vous utilisez une fonction qui sera supprimée d'une version ultérieure de SQL Server.
126	Deprecation Final Support	Se produit lorsque vous utilisez une fonction qui sera supprimée de la prochaine version importante de SQL Server.
127	Exchange Spill Event	Se produit lorsque des tampons de communication dans un plan de requête en parallèle ont été temporairement écrits dans la base de données tempdb.
128	Audit Database Management Event	Intervient lors de la création, de la modification ou de la suppression d'une base de données.
129	Audit Database Object Management Event	Se produit lorsqu'une instruction CREATE, ALTER ou DROP s'exécute sur des objets de base de données, tels que des schémas.
130	Audit Database Principal Management Event	Intervient lors de la création, de la modification ou de la suppression d'une base de données d'entités de sécurité, telles que des utilisateurs.
131	Audit Schema Object Management Event	Intervient lors de la création, de la modification ou de la suppression d'objets serveur.
132	Audit Server Principal Impersonation Event	Se produit en cas d'emprunt d'identité dans une étendue du serveur, comme EXECUTE AS LOGIN.
133	Audit Database Principal Impersonation Event	Intervient si un emprunt d'identité se produit dans une étendue de base de données, comme EXECUTE AS USER ou SETUSER.
134	Audit Server Object Take Ownership Event	Intervient lors de la modification du propriétaire par des objets dans l'étendue du serveur.
135	Audit Database Object Take Ownership Event	Intervient lors de la modification d'un propriétaire par des objets au sein de l'étendue de base de données.
136	Broker:Conversation Group	Se produit lorsque Service Broker crée un nouveau groupe de conversations ou supprime un groupe de conversations existant.
137	Blocked Process Report	Indique qu'une tâche a été bloquée plus longtemps qu'une période spécifiée. Cette classe d'événements n'inclut pas de tâches système ou de tâches qui attendent des ressources à blocage non détectable. Pour configurer la fréquence et le seuil de de création de rapport, utilisez la commande sp_configure.
138	Broker:Connection	Indique l'état d'une connexion de transport gérée par Service Broker.
139	Broker:Forwarded Message Sent	Se produit lorsque Service Broker transfère un message.
140	Broker:Forwarded Message Dropped	Se produit lorsque Service Broker supprime un message qui devait être transféré.
141	Broker:Message Classify	Se produit lorsque Service Broker détermine le routage d'un message.
142	Broker:Transmission	Indique que des erreurs se sont produites dans la couche de transport de Service Broker. Le numéro de l'erreur et les valeurs d'état indiquent la source de l'erreur.
143	Broker:Queue Disabled	Indique qu'un message incohérent a été détecté parce qu'une file d'attente Service Broker comportait cinq restaurations de transactions successives. L'événement contient l'ID de base de données et l'ID de file d'attente de la file d'attente contenant le message concerné.
144-145	Réservé
146	Showplan XML Statistics Profile	Se produit lors de l'exécution d'une instruction SQL. Identifie les opérateurs Showplan et affiche des données complètes de compilation. Sachez que la colonne Binary de cet événement ne contient pas de plan d'exécution de requêtes codé. Utilisez SQL Server Profiler pour ouvrir la trace et afficher le plan d'exécution de requêtes.
148	Deadlock Graph	Se produit lors de l'annulation d'une tentative faisant partie d'un blocage et qui était choisie en tant que victime de blocage. Fournit une description XML d'un blocage.
149	Broker:Remote Message Acknowledgement	Se produit lorsque Service Broker envoie ou reçoit un accusé de réception de message.
150	Trace File Close	Intervient lors de la fermeture d'un fichier de trace au cours de la substitution de ce dernier.
151	Réservé
152	Audit Change Database Owner	Se produit lorsque ALTER AUTHORIZATION sert à modifier le propriétaire d'une base de données et que des autorisations sont vérifiées à cet effet.
153	Audit Schema Object Take Ownership Even	Se produit lorsque ALTER AUTHORIZATION sert à affecter un propriétaire à un objet et que des autorisations sont vérifiées à cet effet.
154	Réservé
155	FT:Crawl Started	Se produit lorsqu'une analyse de texte intégral (remplissage) a démarré. Utilisez-la pour vérifier si une demande d'analyse est actuellement sélectionnée par des tâches de travail.
156	FT:Crawl Stopped	Se produit lorsqu'une analyse de texte intégral (remplissage) s'arrête. Les arrêts se produisent lors de l'achèvement réussi d'une analyse ou si une erreur irrécupérable survient.
157	FT:Crawl Aborted	Intervient lorsqu'une exception est détectée au cours d'une analyse de texte intégral. Elle engendre généralement l'arrêt de l'analyse de texte intégral.
158	Audit Broker Conversation	Crée un rapport de messages d'audit associés à la sécurité du dialogue de Service Broker.
159	Audit Broker Login	Crée un rapport de messages d'audit associés à la sécurité de transport de Service Broker.
160	Broker:Message Undeliverable	Se produit lorsque Service Broker ne parvient pas à conserver un message reçu qui aurait dû être remis à un service.
161	Broker:Corrupted Message	Se produit lorsque Service Broker reçoit un message corrompu.
162	User Error Message	Affiche des messages d'erreur que les utilisateurs aperçoivent en cas d'erreur ou d'exception.
163	Broker:Activation	Se produit lorsqu'un moniteur de file d'attente démarre une procédure stockée d'activation, envoie une notification QUEUE_ACTIVATION, ou lorsqu'il existe une procédure stockée d'activation démarrée par un moniteur de file d'attente.
164	Object:Altered	Se produit lors de la modification d'un objet de base de données.
165	Performance statistics	Indique qu'un plan de requête compilé a été mis en mémoire cache pour la première fois, recompilé ou supprimé de la mémoire cache du plan.
166	SQL:StmtRecompile	Se produit lors d'une recompilation au niveau de l'instruction.
167	Database Mirroring State Change	Se produit lorsque l'état d'une base de données mise en miroir change.
168	Showplan XML For Query Compile	Se produit lors de la compilation d'une instruction SQL. Affiche les données complètes de compilation. Sachez que la colonne Binary de cet événement ne contient pas de plan d'exécution de requêtes codé. Utilisez SQL Server Profiler pour ouvrir la trace et afficher le plan d'exécution de requêtes.
169	Showplan All For Query Compile	Se produit lors de la compilation d'une instruction SQL. Affiche les données complètes de compilation. Utilisez cet événement pour identifier des opérateurs Showplan.
170	Audit Server Scope GDR Event	Indique qu'un événement d'attribution, de refus ou de révocation d'autorisations s'est produit dans l'étendue du serveur, tel que la création d'une connexion.
171	Audit Server Object GDR Event	Indique qu'un événement d'attribution, de refus ou de révocation d'un objet de schéma, tel qu'une table ou une fonction, s'est produit.
172	Audit Database Object GDR Event	Indique qu'un événement d'attribution, de refus ou de révocation d'objets de base de données, tel que des assemblys et des schémas, s'est produit.
173	Audit Server Operation Event	Se produit lorsque des opérations d'audit de sécurité, telles que la modification de paramètres, de ressources, d'accès externe ou d'autorisation sont utilisées.
175	Audit Server Alter Trace Event	Se produit lorsqu'une instruction vérifie l'autorisation ALTER TRACE.
176	Audit Server Object Management Event	Intervient lors de la création, de la modification ou de la suppression d'objets serveur.
177	Audit Server Principal Management Event	Intervient lors de la création, de la modification ou de la suppression d'entités de sécurité du serveur.
178	Audit Database Operation Event	Se produit lorsque surviennent diverses opérations dans une base de données, tel qu'un point de contrôle ou une notification de requête d'abonnement.
180	Audit Database Object Access Event	Se produit lors de l'accès à des objets de base de données, tels que des schémas.
181	TM: Begin Tran starting	Intervient lors du démarrage d'une requête BEGIN TRANSACTION.
182	TM: Begin Tran completed	Intervient lors de l'achèvement d'une requête BEGIN TRANSACTION.
183	TM: Promote Tran starting	Intervient lors du démarrage d'une requête PROMOTE TRANSACTION.
184	TM: Promote Tran completed	Intervient lors de l'achèvement d'une requête PROMOTE TRANSACTION.
185	TM: Commit Tran starting	Intervient lors du démarrage d'une requête COMMIT TRANSACTION.
186	TM: Commit Tran completed	Intervient lors de l'achèvement d'une requête COMMIT TRANSACTION.
187	TM: Rollback Tran starting	Intervient lors du démarrage d'une requête ROLLBACK TRANSACTION.
188	TM: Rollback Tran completed	Intervient lors de l'achèvement d'une requête ROLLBACK TRANSACTION.
189	Lock:Timeout (timeout> 0)	Se produit lors de l'expiration d'une demande de verrou sur une ressource, telle qu'une page.
190	Progress Report: Online Index Operation	Indique la progression d'une opération de génération d'index en ligne pendant l'exécution du processus de création.
191	TM: Save Tran starting	Intervient lors du démarrage d'une requête SAVE TRANSACTION.
192	TM: Save Tran completed	Intervient lors de l'achèvement d'une requête SAVE TRANSACTION.
193	Background Job Error	Se produit lorsque le travail en arrière-plan s'est terminé anormalement.
194	OLEDB Provider Information	Intervient lorsqu'une requête distribuée s'exécute et collecte des informations correspondant à la connexion du fournisseur.
195	Mount Tape	Se produit lorsqu'une demande de montage de bande est reçue.
196	Assembly Load	Se produit lorsqu'une demande de chargement d'un assembly CLR est exécutée.
197	Réservé
198	XQuery Static Type	Se produit avant l'exécution d'une expression XQuery. Cette classe d'événements fournit le type statique de l'expression XQuery.
199	QN: subscription	Se produit lorsqu'il est impossible de s'abonner à une inscription de requête. La colonne TextData contient des informations sur l'événement.
200	QN: parameter table	Des informations sur les abonnements actifs sont stockées dans des tables de paramètres internes. Cette classe d'événements se produit lorsqu'une table de paramètres est créée ou supprimée. En général, ces tables sont créées ou supprimées lors du redémarrage de la base de données. La colonne TextData contient des informations sur l'événement.
201	QN: template	Un modèle de requête représente une classe de requêtes d'abonnement. En règle générale, les requêtes de même classe sont identiques, à l'exception de leurs valeurs de paramètre. Cette classe d'événements se produit lorsqu'une nouvelle demande d'abonnement correspond à une classe déja existante de (Correspondance), une nouvelle classe (Créer), ou une classe Supprimer, qui indique un nettoyage des modèles de classes de requêtes sans abonnement actif. La colonne TextData contient des informations sur l'événement.
202	QN: dynamics	Effectue un suivi des activités internes de notifications de requête. La colonne TextData contient des informations sur l'événement.

[ @columnid= ] column_id
Identificateur de la colonne à ajouter pour l'événement. L'argument column_id est de type int et ne possède pas de valeur par défaut.

Le tableau suivant répertorie les colonnes qui peuvent être ajoutées pour un événement.

Numéro de colonne	Nom de colonne	Description
1	TextData	Valeur de texte dépendant de la classe d'événements capturée dans la trace.
2	BinaryData	Valeur binaire dépendante de la classe d'événements capturés dans la trace.
3	DatabaseID	ID de la base de données spécifiée par l'instruction USE database, ou la base de données par défaut si aucune instruction USE database n'est émise pour une connexion spécifique. La valeur pour une base de données peut être déterminée à l'aide de la fonction DB_ID.
4	TransactionID	ID affecté par le système à la transaction.
5	LineNumber	Indique le numéro de la ligne qui contient l'erreur. Pour les événements qui impliquent des instructions Transact-SQL, comme SP:StmtStarting, la colonne LineNumber contient le numéro de ligne de l'instruction dans la procédure stockée ou le traitement.
6	NTUserName	Nom d'utilisateur Microsoft Windows.
7	NTDomainName	Domaine Windows auquel appartient l'utilisateur.
8	HostName	Nom de l'ordinateur client à l'origine de la requête.
9	ClientProcessID	ID affecté par l'ordinateur client au processus dans lequel s'exécute l'application cliente.
10	ApplicationName	Nom de l'application cliente qui a créé la connexion à une instance de SQL Server. Cette colonne est remplie des valeurs transmises par l'application et non pas du nom affiché du programme.
11	LoginName	Nom de connexion SQL Server du client.
12	SPID	ID de processus serveur affecté par SQL Server au processus associé au client.
13	Duration	Temps (en microsecondes) pris par l'événement. Cette colonne de données n'est pas remplie par l'événement Hash Warning.
14	StartTime	Heure à laquelle a débuté l'événement, si disponible.
15	EndTime	Heure de fin de l'événement. Cette colonne n'est pas remplie pour les classes d'événements de début, par exemple SQL:BatchStarting ou SP:Starting. En outre, elle n'est pas remplie par l'événement Hash Warning.
16	Reads	Nombre de lectures logiques sur disque effectuées par le serveur pour l'événement. Cette colonne n'est pas remplie par l'événement Lock:Released.
17	Writes	Nombre d'écritures physiques effectuées par le serveur pour l'événement.
18	CPU	Temps du processeur (en millisecondes) utilisé par l'événement.
19	Permissions	Représente l'image bitmap des autorisations ; utilisé par l'audit de sécurité.
20	Severity	Niveau de gravité d'une exception.
21	EventSubClass	Type de sous-classe d'événements. Cette colonne de données n'est pas remplie pour toutes les classes d'événements.
22	ObjectID	ID affecté à l'objet par le système.
23	Success	Succès de la tentative d'utilisation des autorisations ; utilisé pour l'audit. 1 = succès0 = échec
24	IndexID	ID de l'index de l'objet affecté par l'événement. Pour déterminer l'ID d'index d'un objet, utilisez la colonne indid de la table système sysindexes.
25	IntegerData	Valeur entière dépendante de la classe d'événements capturés dans la trace.
26	ServerName	Nom de l'instance de SQL Server (servername ou servername\instancename) faisant l'objet de la trace.
27	EventClass	Type de classe d'événement actuellement enregistrée.
28	ObjectType	Type d'objet : table, fonction ou procédure stockée, par exemple.
29	NestLevel	Niveau d'imbrication où s'exécute la procédure stockée. Consultez @@NESTLEVEL (Transact-SQL).
30	State	État du serveur, en cas d'erreur.
31	Error	Numéro d'erreur.
32	Mode	Mode de verrouillage du verrou acquis. Cette colonne n'est pas remplie par l'événement Lock:Released.
33	Handle	Handle de l'objet référencé dans l'événement.
34	ObjectName	Nom de l'objet en cours d'accès.
35	DatabaseName	Nom de la base de données spécifiée dans l'instruction USE database.
36	FileName	Nom logique du nom de fichier modifié.
37	OwnerName	Nom de propriétaire de l'objet référencé.
38	RoleName	Nom du rôle de base de données ou de serveur ciblé par une instruction.
39	TargetUserName	Nom d'utilisateur de la cible d'une action.
40	DBUserName	Nom d'utilisateur de base de données SQL Server du client.
41	LoginSid	Identificateur de sécurité (SID) de l'utilisateur connecté.
42	TargetLoginName	Nom de connexion d'accès de la cible d'une action.
43	TargetLoginSid	SID de la connexion d'accès qui représente la cible d'une action.
44	ColumnPermissions	État des autorisations au niveau des colonnes ; utilisé par l'audit de sécurité.
45	LinkedServerName	Nom du serveur lié.
46	ProviderName	Nom du fournisseur OLE DB.
47	Methodname	Nom de la méthode OLE DB.
48	RowCounts	Nombre de lignes dans le traitement.
49	RequestID	ID de la requête contenant l'instruction.
50	XactSequence	Jeton décrivant la transaction en cours.
51	EventSequence	Numéro de séquence de cet événement.
52	BigintData1	Valeur bigint qui dépend de la classe d'événements capturée dans la trace.
53	BigintData2	Valeur bigint dépendante de la classe d'événements capturés dans la trace.
54	GUID	Valeur GUID dépendante de la classe d'événements capturés dans la trace.
55	IntegerData2	Valeur entière qui dépend de la classe d'événements capturée dans la trace.
56	ObjectID2	ID de l'objet ou de l'entité connexe, si disponible.
57	Type	Valeur d'entier dépendante de la classe d'événements capturés dans la trace.
58	OwnerID	Type de l'objet qui possède le verrou. Pour les événements de verrou uniquement.
59	ParentName	Nom du schéma dans lequel se trouve l'objet.
60	IsSystem	Indique si l'événement s'est produit sur un processus système ou un processus utilisateur. 1 = système 0 = utilisateur.
61	Offset	Décalage de départ de l'instruction dans la procédure stockée ou le traitement.
62	SourceDatabaseID	ID de la base de données dans laquelle existe la source de l'objet.
63	SqlHandle	Hachage 64 bits basé sur le texte d'une requête adhoc ou l'ID de base de données et d'objet d'un objet SQL. Cette valeur peut être transmise à sys.dm_exec_sql_text() pour récupérer le texte SQL associé.
64	SessionLoginName	Nom de connexion de l'utilisateur à l'origine de la session. Par exemple, si vous vous connectez à SQL Server à l'aide de Connexion1 et que vous exécutez une instruction en tant que Connexion2, SessionLoginName affiche Connexion1, tandis que LoginName affiche Connexion2. Cette colonne de données affiche les noms de connexion SQL Server et Windows.

**[ @on=\]**on
Indique si l'événement doit être activé, ON (1) ou désactivé, OFF (0). on est de type bit, sans valeur par défaut.

Si on prend la valeur 1, et que column_id est NULL, alors l'événement est activé (ON) et toutes les colonnes sont effacées. Si column_id ne prend pas la valeur NULL, alors la colonne est activée (ON) pour l'événement spécifié.

Si on prend la valeur 0, et que column_id est NULL, alors l'événement est désactivé (OFF) et toutes les colonnes sont effacées. Si la valeur de column_id n'est pas NULL, la colonne est désactivée (OFF).

Ce tableau illustre l'interaction entre @on et @columnid.

@on	@columnid	Résultat
ON (1)	NULL	Événement activé (ON). Toutes les colonnes sont effacées.
	NOT NULL	La colonne est activée (ON) pour l'événement spécifié.
OFF (0)	NULL	Événement désactivé (OFF). Toutes les colonnes sont effacées.
	NOT NULL	La colonne est désactivée (OFF) pour l'événement spécifié.

Valeurs du code de retour

Le tableau suivant décrit les valeurs de code que les utilisateurs peuvent recevoir à la fin de l'exécution de la procédure stockée.

Code de retour	Description
0	Aucune erreur.
1	Erreur inconnue.
2	La trace est en cours d'exécution. La modification de la trace à cet instant précis entraîne une erreur.
3	L'événement spécifié n'est pas valide. L'événement peut ne pas exister ou être inapproprié pour la procédure stockée.
4	La colonne spécifiée n'est pas valide.
9	Le handle de trace spécifié n'est pas valide.
11	La colonne spécifiée est utilisée de manière interne et ne peut pas être supprimée.
13	Mémoire insuffisante. Renvoyé lorsqu'il n'y a pas assez de mémoire pour exécuter l'action spécifiée.
16	La fonction n'est pas valide pour cette trace.

Notes

sp_trace_setevent effectue une grande partie des actions précédemment exécutées par les procédures stockées étendues disponibles dans des versions antérieures de SQL Server. Utilisez sp_trace_setevent au lieu des procédures suivantes :

xp_trace_addnewqueue
xp_trace_eventclassrequired
xp_trace_seteventclassrequired

Les utilisateurs doivent exécuter sp_trace_setevent pour chaque colonne ajoutée pour chaque événement. Durant chaque exécution, si @on possède la valeur 1, sp_trace_setevent ajoute l'événement spécifié à la liste des événements de la trace. Si @on possède la valeur 0, sp_trace_setevent supprime l'événement spécifié de la liste.

Les paramètres de toutes les procédures stockées SQL Trace (sp_trace_xx) doivent être saisis de manière rigoureuse. Si ces paramètres ne sont pas appelés à l'aide des types de données de paramètre d'entrée appropriés, comme le définit la description de l'argument, la procédure stockée renvoie une erreur.

Pour obtenir un exemple d'utilisation de procédures stockées de trace, consultez Procédure : créer une trace (Transact-SQL).