Classe d'événements CursorExecute

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

La classe d’événements CursorExecute décrit les événements d’exécution de curseur qui se produisent dans les curseurs de l’interface de programmation d’applications (API). Les événements d’exécution de curseur se produisent quand Microsoft Moteur de base de données crée et remplit un curseur à partir du plan d’exécution créé 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 fortement utilisés, la trace peut dégrader notablement 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 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. La 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 database ou ID de la base de données par défaut si aucune instruction USE databasen’a été émise pour une instance donnée. 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é = 74.	27	Non
EventSequence	int	Séquence de la classe d’événements CursorExecute dans le 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	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 le client est exécuté. La 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. Les valeurs sont les suivantes : 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 Windows sous la forme DOMAINE\Nomutilisateur).	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 à l'origine de l'exécution 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 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

Événements étendus
sp_trace_setevent (Transact-SQL)
Curseurs