Classe d'événements CursorExecute
La classe d'événements CursorExecute décrit les événements d'exécution de curseur qui se produisent dans les curseurs d'interface de programmation (API). Les événements d'exécution de curseur se produisent lorsque le Moteur de base de données SQL Server 2005 Microsoft crée et remplit un curseur à partir du plan d'exécution généré par un événement de préparation de curseur.
Incluez la classe d'événements CursorExecute dans les traces qui enregistrent les performances des curseurs. Lorsque la classe d'événements CursorExecute figure dans une trace, la quantité de charge inhérente dépend de la fréquence d'utilisation des curseurs sur la base de données pendant la trace. Si les curseurs sont utilisés de façon intensive, la trace peut peser sensiblement sur les performances.
Colonnes de données de la classe d'événements CursorExecute
| Nom de la colonne de données | Type de données | Description | ID de colonne | Filtrable |
|---|---|---|---|---|
ApplicationName |
nvarchar |
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. |
10 |
Oui |
ClientProcessID |
int |
ID affecté par l'ordinateur hôte au processus dans lequel s'exécute l'application cliente. Cette colonne de données est remplie si le client fournit l'ID du processus client. |
9 |
Oui |
DatabaseID |
int |
Identificateur de la base de données spécifiée par l'instruction USE database ou celui de la base de données par défaut si aucune instruction USE databasen'a été émise pour une instance donnée. Le Générateur de profils SQL Server affiche le nom de la base de données si la colonne de données ServerName est capturée dans la trace et que le serveur est disponible. Déterminez la valeur pour une base de données à l'aide de la fonction DB_ID. |
3 |
Oui |
DatabaseName |
nvarchar |
Nom de la base de données où l'instruction de l'utilisateur est exécutée. |
35 |
Oui |
EventClass |
int |
Type d'événement enregistré = 74. |
27 |
Non |
EventSequence |
int |
Séquence de la classe d'événements CursorExecute dans le lot. |
51 |
Non |
Handle |
int |
Entier utilisé par ODBC, OLE DB ou la bibliothèque de base de données pour coordonner l'exécution avec le serveur. |
33 |
Oui |
HostName |
nvarchar |
Nom de l'ordinateur sur lequel s'exécute le client. Cette colonne de données est remplie si le client fournit le nom de l'hôte. Pour déterminer le nom de l'hôte, utilisez la fonction HOST_NAME. |
8 |
Oui |
IntegerData |
int |
Type de curseur. Valeurs possibles : 1 = Jeu de clés 2 = Dynamique 4 = Avant uniquement 8 = Statique 16 = Avance rapide |
25 |
Non |
IsSystem |
int |
Indique si l'événement s'est produit sur un processus système ou sur un processus utilisateur. 1 = système, 0 = utilisateur. |
60 |
Oui |
LoginName |
nvarchar |
Nom de la connexion de l'utilisateur (soit la connexion de sécurité SQL Server, soit les informations d'identification de connexion Windows sous la forme DOMAINE\nom_utilisateur). |
11 |
Oui |
LoginSid |
image |
Identificateur de sécurité (SID) de l'utilisateur connecté. Vous pouvez trouver ces informations dans la table syslogins de la base de données master. Chaque SID est unique pour chaque connexion dans le serveur. |
41 |
Oui |
NTDomainName |
nvarchar |
Domaine Windows auquel appartient l'utilisateur. |
7 |
Oui |
NTUserName |
nvarchar |
Nom d'utilisateur Windows. |
6 |
Oui |
RequestID |
int |
Identification de la demande à l'origine de l'exécution du curseur. |
49 |
Oui |
ServerName |
nvarchar |
Nom de l'instance de SQL Server faisant l'objet d'une trace. |
26 |
Non |
SessionLoginName |
nvarchar |
Nom de connexion de l'utilisateur à l'origine de la session. Par exemple, si vous vous connectez à SQL Server en utilisant Connexion1 et que vous exécutez une instruction en tant que Connexion2, SessionLoginName affiche Connexion1, tandis que LoginName indique Connexion2. Cette colonne affiche les connexions SQL Server et Windows. |
64 |
Oui |
SPID |
int |
ID de la session sur laquelle l'événement s'est produit. |
12 |
Oui |
StartTime |
datetime |
Heure à laquelle a débuté l'événement, si elle est disponible. |
14 |
Oui |
TransactionID |
bigint |
ID affecté par le système à la transaction. |
4 |
Oui |
XactSequence |
bigint |
Jeton utilisé pour décrire la transaction en cours. |
50 |
Oui |
Voir aussi
Concepts
Curseurs (moteur de base de données)
Autres ressources
Analyse des événements
sp_trace_setevent (Transact-SQL)