sys.dm_exec_query_plan (Transact-SQL)

Syntaxe

sys.dm_exec_query_plan ( plan_handle )

Arguments

• plan_handle
  Identifie de façon univoque un plan de requête pour un traitement en cache ou en cours d'exécution.

  plan_handle est de type varbinary(64). plan_handle peut être obtenu à partir des objets de gestion dynamique suivants :

  sys.dm_exec_cached_plans

  sys.dm_exec_query_stats

  sys.dm_exec_requests

Table renvoyée

Notes

Aucune sortie du plan d'exécution n'est retournée dans la colonne query_plan de la table retournée pour l'objet pour sys.dm_exec_query_plan dans les conditions suivantes :

• Si le plan de requête spécifié au moyen de l'argument plan_handle a été supprimé de la mémoire cache des plans, la valeur de la colonne query_plan de la table retournée est null. Ceci peut se produire par exemple s'il existe un délai entre le moment où le descripteur de plan est capturé et le moment de son utilisation avec sys.dm_exec_query_plan.

• Certaines instructions Transact-SQL ne sont pas mises en mémoire cache, par exemple les instructions d'opérations en bloc ou les instructions contenant des littéraux de chaîne dont la taille est supérieure à 8 Ko. Il est impossible de récupérer pour de telles instructions des plans d'exécution XML à l'aide de sys.dm_exec_query_plan sauf si le traitement est en cours d'exécution car elles n'existent pas dans la mémoire cache.

• Si une procédure stockée ou un traitement Transact-SQL contient un appel à une fonction définie par l'utilisateur ou un appel à du code SQL dynamique, par exemple via la commande EXEC (string), le plan d'exécution XML compilé pour cette fonction définie par l'utilisateur n'est pas inclus dans la table retournée par sys.dm_exec_query_plan pour la procédure stockée ou le traitement. Vous devez donc procéder à un appel distinct à sys.dm_exec_query_plan pour le descripteur de plan correspondant à la fonction définie par l'utilisateur.

Lorsqu'une requête ad hoc utilise un paramétrage simple ou forcé, la colonne query_plan contient uniquement le texte de l'instruction, pas le plan de requête réel. Pour retourner le plan de requête, appelez sys.dm_exec_query_plan pour le descripteur de plan de la requête paramétrée préparée. Vous pouvez déterminer si la requête a été paramétrée par le référencement de la colonne sql de la vue sys.syscacheobjects ou le texte de colonne de la vue de gestion dynamique sys.dm_exec_sql_text. Pour plus d'informations sur le paramétrage, consultez Paramétrage simple et Paramétrage forcé.

En raison d'une limite dans le nombre autorisé des niveaux imbriqués dans le type de données xml, sys.dm_exec_query_plan ne peut pas retourner des plans de requête qui correspondent ou sont supérieurs à 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 Service Pack 2 et versions ultérieures, la colonne query_plan retourne NULL. Vous pouvez faire appel à la fonction de gestion dynamique sys.dm_exec_text_query_plan (Transact-SQL) pour retourner la sortie du plan de requête au format texte.

Autorisations

Pour exécuter sys.dm_exec_query_plan, l'utilisateur doit être membre du rôle de serveur fixe sysadmin ou disposer de l'autorisation VIEW SERVER STATE sur le serveur.

Exemples

Les exemples suivants montrent l'utilisation de la vue de gestion dynamique sys.dm_exec_query_plan.

Pour afficher des plans d'exécution XML, exécutez les requêtes suivantes dans l'éditeur de requêtes de SQL Server Management Studio, puis cliquez sur ShowPlanXML dans la colonne query_plan de la table renvoyée par l'objet sys.dm_exec_query_plan. Le plan d'exécution XML s'affiche dans le volet de résumé de Management Studio. Pour enregistrer le plan d'exécution XML dans un fichier, cliquez avec le bouton droit de la souris sur ShowPlanXML dans la colonne query_plan, sélectionnez Enregistrer les résultats sous, puis nommez le fichier selon le format <file_name>.sqlplan ; par exemple, MyXMLShowplan.sqlplan

A. Récupération du plan de requête mis en mémoire cache pour un traitement ou une requête Transact-SQL à exécution lente

USE master;
GO
exec sp_who;
GO

USE master;
GO
SELECT * FROM sys.dm_exec_requests
WHERE session_id = 54;
GO

USE master;
GO
SELECT * FROM sys.dm_exec_query_plan (0x06000100A27E7C1FA821B10600);
GO

B. Récupération de chaque plan de requête à partir de la mémoire cache des plans

USE master;
GO
SELECT * FROM sys.dm_exec_cached_plans cp CROSS APPLY sys.dm_exec_query_plan(cp.plan_handle);
GO

C. Récupération dans la mémoire cache des plans de chaque plan de requête pour lequel le serveur a regroupé des statistiques de requête

USE master;
GO
SELECT * FROM sys.dm_exec_query_stats qs CROSS APPLY sys.dm_exec_query_plan(qs.plan_handle);
GO

D. Récupération d'informations sur les cinq premières requêtes d'après le temps processeur moyen

SELECT TOP 5 total_worker_time/execution_count AS [Avg CPU Time],
Plan_handle, query_plan 
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_query_plan(qs.plan_handle)
ORDER BY total_worker_time/execution_count DESC;
GO

Voir aussi

Référence

Concepts

Autres ressources