sys.dm_exec_requests (Transact-SQL)

  • Article

Retourne des informations sur chaque demande qui s'exécute dans SQL Server.

[!REMARQUE]

Pour exécuter du code externe à SQL Server (par exemple, des procédures stockées étendues et des requêtes distribuées), un thread doit s'exécuter en dehors du contrôle du planificateur non préemptif. Pour ce faire, un processus de travail passe en mode préemptif. Les valeurs temporelles retournées par cette vue de gestion dynamique n'incluent pas le temps passé en mode préemptif.

Nom de la colonne

Type de données

Description

session_id

smallint

ID de la session à laquelle cette demande est liée. N'accepte pas la valeur NULL.

request_id

int

ID de la demande. Unique dans le contexte de la session. N'accepte pas la valeur NULL.

start_time

datetime

Horodateur lors la réception de la demande. N'accepte pas la valeur NULL.

status

nvarchar(30)

Statut de la demande. Valeurs possibles :

  • Arrière-plan

  • En cours d'exécution

  • Exécutable

  • En état de veille

  • Suspendu

N'accepte pas la valeur Null.

command

nvarchar(32)

Identifie le type de commande en cours de traitement. Les types de commandes courants comprennent notamment :

  • SELECT

  • INSERT

  • UPDATE

  • DELETE

  • BACKUP LOG

  • BACKUP DATABASE

  • DBCC

  • FOR

Le texte de la demande peut être récupéré à l'aide de sys.dm_exec_sql_text avec le sql_handle correspondant pour la demande. Des processus système internes définissent la commande en fonction du type de tâche à exécuter. Il peut s'agir des tâches suivantes :

  • LOCK MONITOR

  • CHECKPOINTLAZY

  • WRITER

N'accepte pas la valeur NULL.

sql_handle

varbinary(64)

Table de hachage du texte SQL de la demande. Autorise la valeur Null.

statement_start_offset

int

Nombre de caractères dans le lot ou la procédure stockée en cours d'exécution où commence l'instruction en cours d'exécution. Cette valeur peut être utilisée avec les fonctions de gestion dynamique sql_handle, statement_end_offset et sys.dm_exec_sql_text pour récupérer l'instruction en cours d'exécution de la demande. Autorise la valeur Null.

statement_end_offset

int

Nombre de caractères dans le lot ou la procédure stockée en cours d'exécution où se termine l'instruction en cours d'exécution. Cette valeur peut être utilisée avec les fonctions de gestion dynamique sql_handle, statement_end_offset et sys.dm_exec_sql_text pour récupérer l'instruction en cours d'exécution de la demande. Autorise la valeur Null.

plan_handle

varbinary(64)

Table de hachage du plan pour l'exécution SQL. Autorise la valeur Null.

database_id

smallint

ID de la base de données dans laquelle la requête s'exécute. N'accepte pas la valeur NULL.

user_id

int

ID de l'utilisateur qui a envoyé la demande. N'accepte pas la valeur NULL.

connection_id

uniqueidentifier

ID de la connexion à laquelle la demande est parvenue. Autorise la valeur Null.

blocking_session_id

smallint

ID de la session qui bloque la demande. Si cette colonne est NULL, la demande n'est pas bloquée, ou les informations de session de la session bloquant la demande ne sont pas disponibles (ou ne peuvent pas être identifiées).

-2 = La ressource qui bloque la demande appartient à une transaction distribuée orpheline.

-3 = La ressource qui bloque la demande appartient à une transaction de récupération différée.

-4 = L'ID de session du propriétaire du verrou qui bloque la demande n'a pas pu être déterminé pour le moment en raison de transitions d'état de verrou interne.

wait_type

nvarchar(60)

Si la demande est actuellement bloquée, cette colonne retourne le type d'attente. Autorise la valeur NULL.

Pour plus d'informations sur les types d'attentes, consultez sys.dm_os_wait_stats (Transact-SQL).

wait_time

int

Si la demande est actuellement bloquée, cette colonne retourne la durée de l'attente, en millisecondes. N'accepte pas la valeur NULL.

last_wait_type

nvarchar(60)

Si la demande a été bloquée précédemment, cette colonne indique le type de la dernière attente. N'accepte pas la valeur NULL.

wait_resource

nvarchar(256)

Si la demande est actuellement bloquée, cette colonne retourne la ressource attendue par la demande. N'accepte pas la valeur NULL.

open_transaction_count

int

Nombre de transactions ouvertes pour cette demande. N'accepte pas la valeur NULL.

open_resultset_count

int

Nombre de jeux de résultats ouverts pour cette demande. N'accepte pas la valeur NULL.

transaction_id

bigint

ID de la transaction dans laquelle cette demande s'exécute. N'accepte pas la valeur NULL.

context_info

varbinary(128)

Valeur CONTEXT_INFO de la session. Autorise la valeur Null.

percent_complete

real

Le pourcentage de travail terminé pour les commandes suivantes :

  • ALTER INDEX REORGANIZE

  • Option AUTO_SHRINK avec ALTER DATABASE

  • BACKUP DATABASE

  • DBCC CHECKDB

  • DBCC CHECKFILEGROUP

  • DBCC CHECKTABLE

  • DBCC INDEXDEFRAG

  • DBCC SHRINKDATABASE

  • DBCC SHRINKFILE

  • RECOVERY

  • RESTORE DATABASE,

  • ROLLBACK

  • TDE ENCRYPTION

N'accepte pas la valeur Null.

estimated_completion_time

bigint

Interne uniquement. N'accepte pas la valeur Null.

cpu_time

int

Quantité de temps UC (en millisecondes) utilisée par la demande. N'accepte pas la valeur NULL.

total_elapsed_time

int

Temps total écoulé en millisecondes depuis l'arrivée de la demande. N'accepte pas la valeur NULL.

scheduler_id

int

ID du planificateur qui planifie cette demande. N'accepte pas la valeur NULL.

task_address

varbinary(8)

Adresse mémoire de la tâche associée à la demande. Autorise la valeur Null.

reads

bigint

Nombre de lectures effectuées par la demande. N'accepte pas la valeur NULL.

writes

bigint

Nombre d'écritures effectuées par la demande. N'accepte pas la valeur NULL.

logical_reads

bigint

Nombre de lectures logiques effectuées par la demande. N'accepte pas la valeur NULL.

text_size

int

Valeur du paramètre TEXTSIZE pour la demande. N'accepte pas la valeur NULL.

language

nvarchar(128)

Valeur du paramètre de langue pour la demande. Autorise la valeur Null.

date_format

nvarchar(3)

Valeur du paramètre DATEFORMAT pour la demande. Autorise la valeur Null.

date_first

smallint

Valeur du paramètre DATEFIRST pour la demande. N'accepte pas la valeur NULL.

quoted_identifier

bit

1 = QUOTED_IDENTIFIER est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

arithabort

bit

1 = ARITHABORT est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

ansi_null_dflt_on

bit

1 = ANSI_NULL_DFLT_ON est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

ansi_defaults

bit

1 = ANSI_DEFAULTS est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

ansi_warnings

bit

1 = ANSI_WARNINGS est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

ansi_padding

bit

1 = ANSI_PADDING est activé (ON) pour la demande.

Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

ansi_nulls

bit

1 = ANSI_NULLS est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

concat_null_yields_null

bit

1 = CONCAT_NULL_YIELDS_NULL est activé (ON) pour la demande. Sinon, la valeur est 0.

N'accepte pas la valeur NULL.

transaction_isolation_level

smallint

Niveau d'isolation avec lequel la transaction pour cette demande est créée. N'accepte pas la valeur NULL.

lock_timeout

int

Délai d'attente de verrou externe pour la demande, en millisecondes. N'accepte pas la valeur NULL.

deadlock_priority

int

Paramètre DEADLOCK_PRIORITY de la demande. N'accepte pas la valeur NULL.

row_count

bigint

Nombre de lignes retournées au client par cette demande. N'accepte pas la valeur NULL.

prev_error

int

Dernière erreur générée pendant l'exécution de la demande. N'accepte pas la valeur NULL.

nest_level

int

Niveau d'imbrication actuel du code en cours d'exécution sur la demande. N'accepte pas la valeur NULL.

granted_query_memory

int

Nombre de pages allouées à l'exécution d'une requête dans la demande. N'accepte pas la valeur NULL.

executing_managed_code

bit

Indique si une demande spécifique est en train d'exécuter des objets CLR (Common Language Runtime) tels que des routines, des types et des déclencheurs. Cette valeur est définie pour toute la durée pendant laquelle un objet CLR réside dans la pile, même lorsqu'elle exécute Transact-SQL à partir du CLR. N'accepte pas la valeur NULL.

group_id

int

ID du groupe de charge de travail auquel cette requête appartient. N'accepte pas la valeur NULL.

query_hash

binary(8)

La valeur de hachage binaire calculée sur la requête et utilisée pour identifier des requêtes avec une logique similaire. Vous pouvez utiliser le hachage de requête pour déterminer l'utilisation des ressources globale pour les requêtes qui diffèrent uniquement par les valeurs littérales.

query_plan_hash

binary(8)

Valeur de hachage binaire calculée sur le plan d'exécution de requête et utilisée pour identifier des plans d'exécution de requête semblables. Vous pouvez utiliser le hachage de plan de requête pour rechercher le coût cumulatif de requêtes avec les plans d'exécution semblables.

Autorisations

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

[!REMARQUE]

Si l'utilisateur bénéficie de l'autorisation VIEW SERVER STATE sur le serveur, il pourra voir toutes les sessions en cours d'exécution de l'instance de SQL Server ; sinon, il ne verra que la session en cours.

Exemples

A.Recherche du texte de la requête pour un lot en cours d'exécution

L'exemple suivant interroge sys.dm_exec_requests afin de rechercher la requête qui vous intéresse et de copier son sql_handle de la sortie.

SELECT * FROM sys.dm_exec_requests;
GO

Puis, pour obtenir le texte d'instruction, utilisez le sql_handle copié avec la fonction système sys.dm_exec_sql_text(sql_handle).

SELECT * FROM sys.dm_exec_sql_text(< copied sql_handle >);
GO

B.Recherche de tous les verrous maintenus par un lot en cours d'exécution

L'exemple suivant interroge sys.dm_exec_requests pour rechercher le lot qui vous intéresse et copier son transaction_id de la sortie.

SELECT * FROM sys.dm_exec_requests;
GO

Puis, pour rechercher les informations de verrou, utilisez le transaction_id copié avec la fonction système sys.dm_tran_locks.

SELECT * FROM sys.dm_tran_locks 
WHERE request_owner_type = N'TRANSACTION' 
    AND request_owner_id = < copied transaction_id >;
GO

C.Recherche de toutes les demandes bloquées actuellement

L'exemple suivant interroge sys.dm_exec_requests pour rechercher les informations à propos des demandes bloquées.

SELECT session_id ,status ,blocking_session_id
    ,wait_type ,wait_time ,wait_resource 
    ,transaction_id 
FROM sys.dm_exec_requests 
WHERE status = N'suspended';
GO

Voir aussi

Référence

Fonctions et vues de gestion dynamique (Transact-SQL)

Fonctions et vues de gestion dynamique relatives à l'exécution (Transact-SQL)

sys.dm_os_memory_clerks (Transact-SQL)

sys.dm_os_sys_info (Transact-SQL)

sys.dm_exec_query_memory_grants (Transact-SQL)

sys.dm_exec_query_plan (Transact-SQL)

sys.dm_exec_sql_text (Transact-SQL)