Classe d'événements CursorUnprepare

La classe d'événements CursorUnprepare fournit des informations sur les événements de non-préparation de curseur qui se produisent dans les curseurs de l'interface de programmation d'applications (API, Application Programming Interface). Ces événements se produisent lorsque le Moteur de base de données de Microsoft rejette un plan d'exécution.

Incluez la classe d'événements CursorUnprepare dans des traces qui enregistrent les performances des curseurs. Lorsque la classe d'événements CursorUnprepare est incluse dans une trace, l'importance de la charge induite dépend de la fréquence d'utilisation des curseurs sur la base de données pendant la trace. Si les curseurs sont beaucoup utilisés, la trace peut gêner considérablement les performances.

Colonnes de la classe d'événements CursorUnprepare

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 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

ID de la base de données spécifiée par l'instruction USE ou celui de la base de données par défaut si aucune instruction USE 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é = 77.

27

Non

EventSequence

int

Séquence de traitement de la classe d'événements CursorUnprepare.

51

Non

GroupID

int

ID du groupe de charges de travail où l'événement Trace SQL se déclenche.

66

Oui

Handle

Int

Identifie le handle préparé en cours d'annulation de préparation.

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 de connexion Microsoft Windows au format DOMAINE\nom_utilisateur).

11

Oui

LoginSid

image

Identificateur 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

Oui

NTUserName

nvarchar

Nom d'utilisateur Windows.

6

Oui

RequestID

int

Identification de la demande qui a annulé la préparation du 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 à l'aide de Connexion1 et exécutez une instruction en tant que Connexion2, SessionLoginName affiche Connexion1, tandis que LoginName affiche Connexion2. 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 qui décrit la transaction actuelle.

50

Oui

Voir aussi

Autres ressources

sp_trace_setevent (Transact-SQL)