CursorClose (classe d'événements)
S’applique à :
SQL ServerAzure SQL Database Azure SQL Managed Instance
Les événements de fermeture de curseur se produisent lorsque le Moteur de base de données ferme et désalloue un curseur. La classe d’événements CursorClose décrit les événements de fermeture de curseur qui se produisent dans les curseurs d’interface de programmation d’applications (API). Cette classe d’événements se produit lorsqu’une instruction de curseur Transact-SQL par ODBC, OLE DB ou DB-Library est fermée.
Incluez la classe d’événements CursorClose dans les traces qui enregistrent les performances des curseurs. La surcharge qui en découle dépend de la fréquence d'utilisation des curseurs sur la base de données pendant la trace. Si les curseurs sont largement utilisés, la trace peut altérer considérablement les performances.
Colonnes de la classe d'événements CursorClose
| 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 base de données 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 Générateur de profils SQL 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é = 78 | 27 | Non |
| EventSequence | int | Séquence de la classe d’événements CursorClose dans le lot. | 51 | Non |
| GroupID | int | ID du groupe de charges de travail où l'événement Trace SQL se déclenche. | 66 | Oui |
| Poignée | int | Handle de l'objet référencé dans l'événement. | 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 |
| 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 (connexion de sécurité SQL Server ou informations d’identification de connexion Microsoft Windows sous la forme domain\username). | 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 | Oui |
| NTUserName | nvarchar | Nom d'utilisateur Windows. | 6 | Oui |
| RequestID | int | Identification de la demande qui a fermé le curseur. | 49 | Oui |
| ServerName | nvarchar | Nom de l’instance de SQL Server en cours de suivi. | 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 Login1 et exécutez une instruction 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 qui décrit la transaction en cours. | 50 | Oui |