Classe d'événements CursorPrepare
La classe d'événements CursorPrepare décrit les événements de préparation des curseurs qui se produisent dans les curseurs de l'interface de programmation d'applications (API, Application Programming Interface). Les événements de préparation de curseurs se produisent lorsque le moteur de base de données Microsoft compile une instruction SELECT associée à un curseur dans un plan d'exécution mais ne crée pas le curseur.
Incluez la classe d'événements CursorPrepare dans les traces qui enregistrent les performances des curseurs. Lorsque la classe d'événements CursorPrepare est incluse dans une trace, la charge générée varie selon la fréquence d'utilisation des curseurs sur la base de données pendant la trace. Si des curseurs sont utilisés de façon intensive, la trace peut compromettre de façon significative les performances.
Colonnes de données de la classe d'événements CursorPrepare
Nom de la colonne de données |
Type de données |
Description |
ID de la colonne |
Filtrable |
|---|---|---|---|---|
ApplicationName |
nvarchar |
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. |
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 l'ID du processus du client est fourni par le client. |
9 |
Oui |
DatabaseID |
int |
ID 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 database n'a été spécifiée pour une instance donnée. Le SQL Server Profiler affiche le nom de la base de données si la colonne de données ServerName du serveur 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 dans laquelle l'instruction de l'utilisateur est exécutée. |
35 |
Oui |
EventClass |
int |
Type d'événement enregistré = 70. |
27 |
Non |
EventSequence |
int |
Séquence de la classe d'événements CursorPrepare dans un traitement. |
51 |
Non |
GroupID |
int |
ID du groupe de charges de travail où l'événement Trace SQL se déclenche. |
66 |
Oui |
Handle |
int |
Descripteur de la classe d'événements. |
33 |
Oui |
HostName |
nvarchar |
Nom de l'ordinateur sur lequel le client est exécuté. Cette colonne de données est remplie si le nom d'hôte est fourni par le client. Pour déterminer le nom de l'hôte, utilisez la fonction HOST_NAME. |
8 |
Oui |
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 Windows au format DOMAINE\nom_utilisateur). |
11 |
Oui |
LoginSid |
image |
Numéro d'identification de sécurité (SID) de l'utilisateur connecté. Vous pouvez trouver ces informations dans l'affichage catalogue sys.server_principals. Chaque connexion possède un SID unique au niveau du serveur. |
41 |
Oui |
NTDomainName |
nvarchar |
Domaine Windows auquel appartient l'utilisateur. |
7 |
Non |
NTUserName |
nvarchar |
Nom d'utilisateur Windows. |
6 |
Oui |
RequestID |
int |
Identification de la demande qui a préparé le curseur. |
49 |
Oui |
ServerName |
nvarchar |
Nom de l'instance SQL Server tracée. |
26 |
Non |
SessionLoginName |
nvarchar |
Nom de connexion de l'utilisateur à l'origine de la session. Par exemple, si vous vous connectez à SQL Server au moyen de Login1 et que vous exécutez une commande en tant que Login2, SessionLoginName affiche Login1 et LoginName affiche Login2. Cette colonne affiche à la fois les connexions SQL Server et Windows. |
64 |
Oui |
SPID |
int |
ID de la session au cours de laquelle l'événement s'est produit. |
12 |
Oui |
StartTime |
datetime |
Heure à laquelle a débuté l'événement, si elle est connue. |
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
Référence
sp_trace_setevent (Transact-SQL)