sys.dm_exec_query_statistics_xml (Transact-SQL)

S’applique à : SQL Server 2016 (13.x) et versions ultérieures Azure SQL Database Azure SQL Managed Instance

Renvoie le plan d’exécution de la requête pour les demandes en cours. Utilisez cette vue DMV pour récupérer showplan XML avec des statistiques temporaires.

Syntaxe

sys.dm_exec_query_statistics_xml(session_id)  

Arguments

session_id
L’ID de session exécutant le lot à rechercher. session_id est smallint. session_id peut être obtenu à partir des objets de gestion dynamique suivants :

• sys.dm_exec_requests

• sys.dm_exec_sessions

• sys.dm_exec_connections

Table retournée

Notes

Cette fonction système est disponible à compter de SQL Server 2016 (13.x) SP1. Consultez KB 3190871

Cette fonction système fonctionne sous une infrastructure de profilage de statistiques d’exécution de requêtes standard et légère. Pour plus d’informations, consultez Infrastructure du profilage de requête.

Dans les conditions suivantes, aucune sortie showplan n’est retournée dans la colonne query_plan de la table retournée pour sys.dm_exec_query_statistics_xml :

• Si le plan de requête qui correspond au session_id spécifié n’est plus en cours d’exécution, la colonne query_plan de la table retournée est null. Par exemple, cette condition peut se produire s’il existe un délai entre le moment où le handle de plan a été capturé et lorsqu’il a été utilisé avec sys.dm_exec_query_statistics_xml.

En raison d’une limitation du nombre de niveaux imbriqués autorisés dans le type de données xml, sys.dm_exec_query_statistics_xml ne peut pas retourner les plans de requête qui atteignent ou dépassent 128 niveaux d’éléments imbriqués. Dans les versions antérieures de SQL Server, cette condition empêchait les retours par le plan de requête et générait l’erreur 6335. Dans SQL Server 2005 (9.x) Service Pack 2 et versions ultérieures, la colonne query_plan retourne NULL.

autorisations

Sur SQL Server, requiert l’autorisation VIEW SERVER STATE sur le serveur.
Sur les niveaux Premium de SQL Database, nécessite l’autorisation VIEW DATABASE STATE dans la base de données. Sur les niveaux SQL Database Standard et Basic, nécessite l’Administrateur du serveur ou un compte Administrateur Microsoft Entra.

Autorisations pour SQL Server 2022 (et versions plus récentes)

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

Exemples

R. Examiner les statistiques d’exécution et de plan de requête en direct 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 session_id de la sortie.

SELECT * FROM sys.dm_exec_requests;  
GO  

Ensuite, pour obtenir le plan de requête en direct et les statistiques d’exécution, utilisez le session_id copié avec la fonction système sys.dm_exec_query_statistics_xml.

--Run this in a different session than the session in which your query is running.
SELECT * FROM sys.dm_exec_query_statistics_xml(< copied session_id >);  
GO  

Ou combiné pour toutes les requêtes en cours d’exécution.

--Run this in a different session than the session in which your query is running.
SELECT 
	eqs.query_plan, 
	er.session_id, 
	er.request_id, 
	er.database_id,
	er.start_time,
	er.[status], 
	er.wait_type,
	er.wait_resource, 
	er.last_wait_type,
	(er.cpu_time/1000) AS cpu_time_sec,
	(er.total_elapsed_time/1000)/60 AS elapsed_time_minutes,
	(er.logical_reads*8)/1024 AS logical_reads_KB,
	er.granted_query_memory,
	er.dop,
	er.row_count, 
	er.query_hash, 
	er.query_plan_hash
FROM sys.dm_exec_requests er
	CROSS APPLY sys.dm_exec_query_statistics_xml(session_id) eqs
WHERE er.session_id <> @@spid;
GO

Voir aussi

Indicateurs de trace
Fonctions et vues de gestion dynamique (Transact-SQL)
Vues de gestion dynamique liées aux bases de données (Transact-SQL)