sp_trace_setevent (Transact-SQL)

  • Article

S’applique à :SQL Server

Ajoute ou supprime un événement ou une colonne d'événement dans une trace. sp_trace_setevent peut être exécuté uniquement sur les traces existantes qui sont arrêtées (@status est 0). Une erreur est retournée si cette procédure stockée est exécutée sur une trace qui n’existe pas ou dont @status n’est pas 0.

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt des événements étendus.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @traceid = ] traceid

ID de la trace à modifier. @traceid est int, sans valeur par défaut. L’utilisateur utilise cette valeur @traceid pour identifier, modifier et contrôler la trace.

[ @eventid = ] eventid

ID de l’événement à activer. @eventid est int, sans 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 de l’événement Description
Il lance 0 sur 9. Reserved Reserved
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 lot Transact-SQL est terminé.
13 SQL:BatchStarting Se produit lorsqu’un lot Transact-SQL a démarré.
14 Audit Login Se produit lorsqu’un utilisateur se connecte correctement à 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 effectuées par les utilisateurs connectés à SQL Server avant le démarrage de la trace.
18 Audit Server Starts and Stops Se produit lorsque l’état du service SQL Server est modifié.
19 DTCTransaction Effectue le suivi des transactions coordonnées par Microsoft Distributed Transaction Coordinator (MS DTC) entre deux bases de données ou plus.
20 Audit Login Failed Indique qu’une tentative de connexion à SQL Server à partir d’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’erreur ont été enregistrés dans le journal des erreurs SQL Server.
23 Lock:Released Indique qu'un verrou sur une ressource, une page par exemple, a été débloqué.
24 Lock:Acquired 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:Cancel 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 avec l’instruction SET LOCK_TIMEOUT.
28 Degree of Parallelism Event Se produit avant l'exécution d'une instruction SELECT, INSERT ou UPDATE.
Il lance 29 sur 31. Reserved Utilisez plutôt l'événement 28.
32 Reserved Reserved
33 Exception Indique qu’une exception s’est produite dans SQL Server.
34 SP:CacheMiss Indique quand une procédure stockée n’est pas trouvée 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 Deprecated Déprécié
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 au sein d’une procédure stockée a commencé à s’exécuter.
45 SP:StmtCompleted Indique qu’une instruction Transact-SQL au sein d’une procédure stockée a terminé l’exécution.
46 Object: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 Reserved
49 Reserved
50 SQL Transaction Effectue 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 quand un curseur est ouvert sur une instruction Transact-SQL par ODBC, OLE DB ou DB-Library.
54 TransactionLog Trace à quel moment les transactions sont écrites dans le journal des transactions.
55 Hash Warning Indique qu’une opération de hachage (par exemple, jointure de hachage, agrégation de hachage, union de hachage et hachage distincte) qui n’est pas traitée sur une partition de mémoire tampon a rétabli un autre plan. 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.
Il lance 56 sur 57. Reserved
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.
Il lance 62 sur 66. Reserved
67 Execution Warnings Indique les avertissements qui se sont produits pendant l’exécution d’une instruction SQL Server ou d’une procédure stockée.
68 Showplan Text (Unencoded) Affiche l’arborescence du plan de l’instruction Transact-SQL exécutée.
69 Sort Warnings Indique les opérations de tri qui ne tiennent pas en mémoire. N’inclut pas d’opérations de tri impliquant la création d’index ; trier uniquement les opérations dans une requête (par exemple, une clause ORDER BY utilisée dans une instruction SELECT).
70 CursorPrepare Indique quand un curseur sur une instruction Transact-SQL est préparé pour une utilisation par ODBC, OLE DB ou DB-Library.
71 Prepare SQL ODBC, OLE DB ou DB-Library a préparé une instruction ou des instructions Transact-SQL à utiliser.
72 Exec Prepared SQL ODBC, OLE DB ou DB-Library a exécuté une instruction ou des instructions Transact-SQL préparées.
73 Unprepare SQL ODBC, OLE DB ou DB-Library n’a pas d’instruction ou d’instructions Transact-SQL préparées (supprimées).
74 CursorExecute Un curseur précédemment préparé sur une instruction Transact-SQL par ODBC, OLE DB ou DB-Library est exécuté.
75 CursorRecompile Un curseur ouvert sur une instruction Transact-SQL par ODBC ou DB-Library a été recompilé directement ou en raison d’une modification de schéma.

Déclenché pour les curseurs ANSI et non-ANSI.
76 CursorImplicitConversion Un curseur sur 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é sur une instruction Transact-SQL n’est pas préparé (supprimé) par ODBC, OLE DB ou DB-Library.
78 CursorClose Un curseur précédemment ouvert sur une instruction Transact-SQL par ODBC, OLE DB ou DB-Library est fermé.
79 Missing Column Statistics Les statistiques de colonne qui auraient pu être utiles pour l’optimiseur ne sont pas disponibles.
80 Missing Join Predicate La requête qui n’est pas un prédicat de jointure n’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 SQL Server a augmenté ou diminué de 1 mégaoctet (Mo) ou de 5 % de la mémoire maximale du serveur, selon ce qui est supérieur.
Il lance 82 sur 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. La TextData colonne ne contient pas le plan d’exécution 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. La TextData colonne ne contient pas le plan d’exécution 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. La TextData colonne ne contient pas le plan d’exécution pour cet événement.
99 Reserved
100 RPC Output Parameter Produit les valeurs de sortie des paramètres pour tous les RPC.
101 Reserved
102 Audit Database Scope GDR Se produit chaque fois qu’une autorisation GRANT, DENY, REVOKE pour une instruction est émise par n’importe quel utilisateur dans SQL Server pour les actions de base de données uniquement, telles que l’octroi d’autorisations sur une base de données.
103 Audit Object GDR Event Se produit chaque fois qu’une autorisation GRANT, DENY, REVOKE pour un objet est émise par n’importe quel utilisateur dans SQL Server.
104 Audit AddLogin Event Se produit lorsqu’une connexion SQL Server est ajoutée ou supprimée ; 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_revokeloginet sp_denylogin.
106 Audit Login Change Property Event Se produit lorsqu’une propriété d’une connexion, à l’exception des 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 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’une connexion est ajoutée ou supprimée en tant qu’utilisateur de base de données (Windows ou SQL Server) à une base de données ; pour sp_grantdbaccess, , sp_addusersp_revokedbaccess, et sp_dropuser.
110 Audit Add Member to DB Role Event Se produit lorsqu’une connexion est ajoutée ou supprimée en tant qu’utilisateur de base de données (fixe ou défini par l’utilisateur) à une base de données ; pour sp_addrolemember, sp_droprolememberet sp_changegroup.
111 Audit Add Role Event Se produit lorsqu’une connexion est ajoutée ou supprimée en tant qu’utilisateur de base de données à 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 les appels OLE DB QueryInterface sont effectués pour les requêtes distribuées et les 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. La Binary colonne de cet événement contient le plan d’exécution encodé. 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 Signale la progression d’une conversation Service Broker.
125 Deprecation Announcement Se produit lorsque vous utilisez une fonctionnalité qui sera supprimée d’une version ultérieure de SQL Server.
126 Deprecation Final Support Se produit lorsque vous utilisez une fonctionnalité qui sera supprimée de la prochaine version majeure de SQL Server.
127 Exchange Spill Event Se produit lorsque les mémoires tampons de communication dans un plan de requête parallèle ont été temporairement écrites dans la tempdb base de données.
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 de principaux, tels 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 lorsqu’il existe un emprunt d’identité dans l’étendue du serveur, par exemple 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 groupe de conversation ou supprime un groupe de conversation existant.
137 Blocked Process Report Se produit lorsqu’un processus a été bloqué pendant plus d’une durée spécifiée. N’inclut pas les processus système ou les processus qui attendent des ressources non détectables par interblocage. Permet sp_configure de configurer le seuil et la fréquence à laquelle les rapports sont générés.
138 Broker:Connection Signale 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 destiné à ê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 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’il y a eu cinq restaurations de transaction consécutives sur une file d’attente Service Broker. 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é.
Il lance 144 sur 145. Reserved
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. La Binary colonne de cet événement contient le plan d’exécution encodé. 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 Reserved
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 Event Se produit lorsque ALTER AUTHORIZATION sert à affecter un propriétaire à un objet et que des autorisations sont vérifiées à cet effet.
154 Reserved
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é de boîte de dialogue Service Broker.
159 Audit Broker Login Crée un rapport de messages d'audit associés à la sécurité de transport Service Broker.
160 Broker:Message Undeliverable Se produit lorsque Service Broker ne parvient pas à conserver un message reçu qui doit avoir été remis à un service.
161 Broker:Corrupted Message Se produit lorsque Service Broker reçoit un message endommagé.
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 QUEUE_ACTIVATION notification ou lorsqu’une procédure stockée d’activation démarrée par un moniteur de file d’attente quitte.
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. La Binary colonne de cet événement contient le plan d’exécution encodé. 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 et au moment de la 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 de principaux 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 Se produit lorsqu’une BEGIN TRANSACTION demande démarre.
182 TM: Begin Tran completed Se produit lorsqu’une BEGIN TRANSACTION demande est terminée.
183 TM: Promote Tran starting Se produit lorsqu’une PROMOTE TRANSACTION demande démarre.
184 TM: Promote Tran completed Se produit lorsqu’une PROMOTE TRANSACTION demande est terminée.
185 TM: Commit Tran starting Se produit lorsqu’une COMMIT TRANSACTION demande démarre.
186 TM: Commit Tran completed Se produit lorsqu’une COMMIT TRANSACTION demande est terminée.
187 TM: Rollback Tran starting Se produit lorsqu’une ROLLBACK TRANSACTION demande démarre.
188 TM: Rollback Tran completed Se produit lorsqu’une ROLLBACK TRANSACTION demande est terminée.
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 Se produit lorsqu’une SAVE TRANSACTION demande démarre.
192 TM: Save Tran completed Se produit lorsqu’une SAVE TRANSACTION demande est terminée.
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 Reserved
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’une inscription de requête ne peut pas être abonnée. La TextData colonne 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 TextData colonne 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 tombe dans une classe existante de (Match), une nouvelle classe (Create) ou une Drop classe, qui indique propre up de modèles pour les classes de requête sans abonnements actifs. La TextData colonne contient des informations sur l’événement.
202 QN: dynamics Effectue un suivi des activités internes de notifications de requête. La TextData colonne contient des informations sur l’événement.
212 Bitmap Warning Indique quand les filtres bitmap ont été désactivés dans une requête.
213 Database Suspect Data Page Indique quand une page est ajoutée au suspect_pages tableau dans msdb.
214 CPU threshold exceeded Indique quand Resource Governor détecte qu’une requête a dépassé la valeur de seuil processeur (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Indique quand un déclencheur LOGON ou une fonction classifieur du gouverneur de ressources commence à s'exécuter.
216 PreConnect:Completed Indique quand un déclencheur LOGON ou une fonction de classifieur Resource Governor termine l’exécution.
217 Plan Guide Successful Indique que le Moteur de base de données a produit un plan d’exécution pour une requête ou un lot contenant un repère de plan.
218 Plan Guide Unsuccessful Indique que le Moteur de base de données n’a pas pu produire de plan d’exécution pour une requête ou un lot qui contenait un repère de plan. Le Moteur de base de données a tenté de générer un plan d’exécution pour cette requête ou ce lot sans appliquer le repère de plan. Un repère de plan non valide peut être à l'origine de ce problème. Vous pouvez valider le repère de plan à l’aide de la sys.fn_validate_plan_guide fonction système.
235 Audit Fulltext

[ @columnid = ] columnid

ID de la colonne à ajouter pour l’événement. @columnid est int, sans valeur par défaut.

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

Column number 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 base de données par défaut si aucune instruction use database n’est émise pour une connexion donnée.

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, par exemple SP:StmtStarting, le LineNumber numéro de ligne de l’instruction dans la procédure stockée ou le lot.
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 avec les valeurs passées par l'application plutôt que par le nom affiché du programme.
11 LoginName Nom de connexion SQL Server du client.
12 SPID ID de processus serveur attribué par SQL Server au processus associé au client.
13 Duration Durée écoulée (en microsecondes) prise 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 à laquelle l'événement s'est terminé. Cette colonne n’est pas remplie pour démarrer des classes d’événements, telles que SQL:BatchStarting ou SP:Starting. Il n’est pas non plus rempli 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 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 = réussite
0 = é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 indid colonne de la sysindexes table système.
25 IntegerData Valeur entière qui dépend de la classe d'événements capturée dans la trace.
26 ServerName Nom de l’instance de SQL Server, nom _serveur ou nom_instance\nom_instance, suivi.
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 la 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 demande contenant l'instruction.
50 XactSequence Jeton servant à décrire la transaction en cours.
51 EventSequence Numéro de séquence de cet événement.
52 BigintData1 valeur biginte , qui dépend de la classe d’événements capturée dans la trace.
53 BigintData2 valeur biginte , qui dépend de la classe d’événements capturée dans la trace.
54 GUID Valeur GUID dépendante de la classe d'événements capturés dans la trace.
55 IntegerData2 Valeur d'entier dépendante de la classe d'événements capturés 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 sur 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 lot.
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 ad hoc ou sur l'ID de base de données et d'objet d'un objet SQL. Cette valeur peut être transmise pour sys.dm_exec_sql_text() 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 Login1 d’une instruction et exécutez une instruction en tant que Login2, SessionLoginName affiche Login1, tandis que vous LoginName affichez Login2. Cette colonne de données affiche à la fois les connexions SQL Server et Windows.

[ @on = ] on

Spécifie si l’événement est activé (1) ou désactivé (0). @on est bit, sans valeur par défaut.

Si @on est défini 1sur , et @columnid est NULL, l’événement est défini ON sur et toutes les colonnes sont effacées. Si @columnid n’est pas null, la colonne est définie sur ON pour cet événement.

Si @on est défini 0sur , et @columnid est NULL, l’événement est tourné OFF et toutes les colonnes sont effacées. Si @columnid n’est pas null, la colonne est désactivée.

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

@on @columnid Result
ON (1) NULL L’événement est activé.

Toutes les colonnes sont effacées.
NOT NULL La colonne est activée pour l’événement spécifié.
OFF (0) NULL L’événement est désactivé.

Toutes les colonnes sont effacées.
NOT NULL La colonne est désactivée pour l’événement spécifié.

Valeurs des codes 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 n’existe peut-être pas ou il n’est pas approprié pour la procédure de magasin.
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 en interne et ne peut pas être supprimée.
13 Mémoire insuffisante. Retourné lorsqu’il n’y a pas suffisamment de mémoire pour effectuer 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 des procédures stockées étendues disponibles dans les versions antérieures de SQL Server. Utilisez sp_trace_setevent plutôt que :

  • xp_trace_addnewqueue
  • xp_trace_eventclassrequired
  • xp_trace_seteventclassrequired

Les utilisateurs doivent s’exécuter sp_trace_setevent pour chaque colonne ajoutée pour chaque événement. Pendant chaque exécution, si @on est défini 1sur , sp_trace_setevent ajoute l’événement spécifié à la liste des événements de la trace. Si @on est défini 0sur , sp_trace_setevent supprime l’événement spécifié de la liste.

Les paramètres de toutes les procédures stockées trace SQL (sp_trace_*) sont strictement typés. Si ces paramètres ne sont pas appelés avec les types de données de paramètre d’entrée corrects, comme spécifié dans la description de l’argument, la procédure stockée retourne une erreur.

Pour obtenir un exemple d’utilisation de procédures stockées de trace, consultez Créer une trace (Transact-SQL).

Autorisations

Nécessite l’autorisation ALTER TRACE.

Contenu connexe