sys.dm_exec_cursors (Transact-SQL)

Article
08/20/2013

Retourne des informations sur les curseurs ouverts dans diverses bases de données.

Syntaxe

dm_exec_cursors (session_id | 0 )

Arguments

session_id | 0
ID de la session. Si session_id est spécifié, cette fonction retourne des informations sur les curseurs dans la session spécifiée.

Si 0 est spécifié, la fonction retourne des informations sur tous les curseurs dans toutes les sessions.

Table retournée

Nom de la colonne	Type de données	Description
session_id	int	ID de la session propriétaire de ce curseur.
cursor_id	int	ID de l'objet curseur.
name	nvarchar(256)	Nom du curseur, défini par l'utilisateur.
propriétés	nvarchar(256)	Spécifie les propriétés du curseur. Les valeurs des propriétés suivantes sont concaténées pour former la valeur de cette colonne : Interface déclaration Type de curseur Accès simultané au curseur Étendue du curseur Niveau d'imbrication du curseur Par exemple, la valeur retournée dans cette colonne peut être la suivante : "TSQL \| Dynamic \| Optimistic \| Global (0)".
sql_handle	varbinary(64)	Descripteur du texte du traitement qui a déclaré le curseur.
statement_start_offset	int	Nombre de caractères dans le traitement ou la procédure stockée en cours d'exécution où les instructions en cours d'exécution commencent. Cette valeur peut être utilisée avec les fonctions de gestion dynamique sql_handle, statement_end_offset et sys.dm_exec_sql_text pour extraire l'instruction en cours d'exécution de la demande.
statement_end_offset	int	Nombre de caractères dans le traitement ou la procédure stockée en cours d'exécution où les instructions en cours d'exécution se terminent. Cette valeur peut être utilisée avec les fonctions de gestion dynamique sql_handle, statement_start_offset et sys.dm_exec_sql_text pour extraire l'instruction en cours d'exécution de la demande.
plan_generation_num	bigint	Numéro de séquence permettant de distinguer les instances de plans après une recompilation.
creation_time	datetime	Heure de création du curseur.
is_open	bit	Indique si le curseur est ouvert.
is_async_population	bit	Spécifie si le thread d'arrière-plan remplit toujours de manière asynchrone un curseur KEYSET ou STATIC.
is_close_on_commit	bit	Spécifie si le curseur a été déclaré à l'aide de CURSOR_CLOSE_ON_COMMIT. 1 = Le curseur est fermé à la fin de la transaction.
fetch_status	int	Retourne le dernier état d'extraction du curseur. Il s'agit de la dernière valeur @@FETCH_STATUS retournée.
fetch_buffer_size	int	Retourne des informations sur la taille du tampon d'extraction. 1 = Curseurs Transact-SQL. Il est possible de définir une valeur supérieure pour les curseurs des API.
fetch_buffer_start	int	Pour les curseurs FAST_FORWARD et DYNAMIC, retourne 0 si le curseur n'est pas ouvert ou s'il est positionné devant la première ligne. Sinon, retourne -1. Pour les curseurs STATIC et KEYSET, retourne 0 si le curseur n'est pas ouvert et -1 si le curseur est positionné au-delà de la dernière ligne. Sinon, retourne le numéro de la ligne où il est positionné.
ansi_position	int	Position du curseur dans le tampon d'extraction.
worker_time	bigint	Temps, en microsecondes, passés par les travaux qui exécutent ce curseur.
reads	bigint	Nombre de lectures effectuées par le curseur.
writes	bigint	Nombre d'écritures effectuées par le curseur.
dormant_duration	bigint	Millisecondes écoulées depuis le début de la dernière requête (ouverture ou extraction) sur ce curseur.

Autorisations

Nécessite l'autorisation VIEW SERVER STATE sur le serveur.

Notes

Le tableau ci-dessous fournit des informations sur l'interface de déclaration du curseur et inclut les valeurs possibles pour la colonne des propriétés.

Propriété	Description
API	Le curseur a été déclaré en utilisant une des API d'accès aux données (ODBC, OLEDB).
TSQL	Le curseur a été déclaré à l'aide de la syntaxe Transact-SQL DECLARE CURSOR.

Le tableau ci-dessous fournit des informations sur le type du curseur et inclut les valeurs possibles pour la colonne des propriétés.

Type	Description
Keyset	Le curseur est déclaré comme Keyset.
Dynamique	Le curseur est déclaré comme dynamique.
Snapshot	Le curseur est déclaré comme instantané ou statique.
Fast_Forward	Le curseur est déclaré comme curseur avant.

Le tableau ci-dessous fournit des informations sur l'accès concurrentiel au curseur et inclut les valeurs possibles pour la colonne des propriétés.

Accès concurrentiel	Description
Read Only	Le curseur est déclaré en lecture seule
Scroll Locks	Le curseur utilise des défilements.
Optimistic	Le curseur utilise l'accès concurrentiel optimiste.

Le tableau ci-dessous fournit des informations sur l'étendue du curseur et inclut les valeurs possibles pour la colonne des propriétés.

Étendue	Description
Local	Spécifie que l'étendue du curseur est locale pour le traitement d'instructions, la procédure stockée ou le déclencheur dans lequel il a été créé.
Global	Spécifie que l'étendue du curseur est globale pour la connexion.

Exemples

A.Détection des anciens curseurs

Cet exemple retourne des informations sur les curseurs ouverts sur le serveur pendant une durée supérieure aux 36 heures spécifiées.

SELECT creation_time, cursor_id, name, c.session_id, login_name 
FROM sys.dm_exec_cursors(0) AS c 
JOIN sys.dm_exec_sessions AS s ON c.session_id = s.session_id 
WHERE DATEDIFF(hh, c.creation_time, GETDATE()) > 36;
GO