Affichage des plans d'exécution à l'aide des options Showplan SET (Transact-SQL)
Les options d'instruction SET de Transact-SQL destinées à afficher des informations de plans d'exécution produisent un résultat au format XML et texte. Ces options sont énumérées et décrites dans cette rubrique.
Options d'instruction SET Showplan
Les options d'instruction SET de Transact-SQL énumérées ci-dessous vous permettent d'afficher un plan d'exécution de requêtes :
Notes
Les options SHOWPLAN_XML, SHOWPLAN_ALL et SHOWPLAN_TEXT SET produisent un ensemble de lignes pour chaque traitement. Les options STATISTICS XML et STATISTICS PROFILE SET produisent un ensemble de lignes pour chacune des requêtes incluses dans un traitement.
SET SHOWPLAN_XML ON
Cette instruction empêche SQL Server d'exécuter les instructions Transact-SQL. Au lieu de cela, Microsoft SQL Server retourne des informations de plan d'exécution indiquant comment les instructions seront exécutées dans un document XML correctement mis en forme. Pour plus d'informations, consultez SET SHOWPLAN_XML (Transact-SQL).
SET SHOWPLAN_TEXT ON
Suite à l'exécution de cette instruction SET, SQL Server retourne des informations de plan d'exécution pour chaque requête sous forme de texte. Les instructions ou traitements Transact-SQL ne sont pas exécutés. Pour plus d'informations, consultez SET SHOWPLAN_TEXT (Transact-SQL).
SET SHOWPLAN_ALL ON
Cette instruction est similaire à l'instruction SET SHOWPLAN_TEXT, à la différence que les résultats sont présentés de façon plus détaillée que ceux de SHOWPLAN_TEXT. Pour plus d'informations, consultez SET SHOWPLAN_ALL (Transact-SQL).
SET STATISTICS XML ON
Retourne des informations d'exécution pour chaque instruction exécutée, en plus de l'ensemble de résultats habituellement retourné par l'instruction. Le résultat consiste en un ensemble de documents XML correctement formés. SET STATISTICS XML ON produit un document de sortie XML pour chaque instruction qui s'exécute. La différence entre SET SHOWPLAN_XML ON et SET STATISTICS XML ON réside dans le fait que cette dernière option SET exécute l'instruction ou le traitement Transact-SQL. Les résultats de SET STATISTICS XML ON incluent par ailleurs des informations sur le nombre de lignes réellement traitées par les divers opérateurs et le nombre d'opérateurs exécutés. Pour plus d'informations, consultez SET STATISTICS XML (Transact-SQL).
SET STATISTICS PROFILE ON
Retourne les informations concernant l'exécution de chaque instruction exécutée, en plus de l'ensemble de résultats habituellement retourné par l'instruction. Les deux options d'instruction SET fournissent des résultats sous forme de texte. La différence entre SET SHOWPLAN_ALL ON et SET STATISTICS PROFILE ON réside dans le fait que cette dernière option SET exécute l'instruction ou le traitement Transact-SQL. Les résultats de SET STATISTICS PROFILE ON incluent par ailleurs des informations sur le nombre de lignes réellement traitées par les divers opérateurs et le nombre d'opérateurs exécutés. Pour plus d'informations, consultez SET STATISTICS PROFILE (Transact-SQL).
SET STATISTICS IO ON
Affiche des informations sur le niveau d'activité générée sur le disque par les instructions Transact-SQL une fois celles-ci exécutées. Cette option SET produit une sortie texte. Pour plus d'informations, consultez SET STATISTICS IO (Transact-SQL).
SET STATISTICS TIME ON
Indique en millisecondes le temps nécessaire à l'analyse, la compilation et l'exécution de chacune des instructions Transact-SQL après leur exécution. Cette option SET produit une sortie texte. Pour plus d'informations, consultez SET STATISTICS TIME (Transact-SQL).
Remarques concernant l'utilisation des options d'instruction Showplan SET
Lorsque vous affichez un plan d'exécution en utilisant les options SHOWPLAN SET, les instructions que vous soumettez au serveur ne sont pas exécutées. Au lieu de cela, SQL Server analyse la requête et affiche, en une série d'opérateurs, la façon dont les instructions auraient été exécutées.
Notes
Étant donné que les instructions ne sont pas exécutées lorsque le plan d'exécution est affiché, les opérations Transact-SQL ne sont pas réellement exécutées. Ainsi, par exemple, si un plan d'exécution comporte une instruction CREATE TABLE, toutes les opérations ultérieures impliquant la table « créée » retournent des erreurs, car le table n'existe pas. Toutefois, il existe deux exceptions à cette règle : les tables temporaires sont créées lors de l'utilisation des options SHOWPLAN SET et les instructions db_name USE sont exécutées et tentent de modifier le contexte de base de données au db_name spécifié lors de l'utilisation des options SHOWPLAN SET.
Lorsque vous affichez un plan d'exécution en utilisant les options STATISTICS SET, les instructions Transact-SQL que vous soumettez au serveur ne sont pas exécutées.
Notes
Les options Showplan SET n'affichent aucune information sur les procédures stockées chiffrées ou les déclencheurs.
Options SET appelées à être désapprouvées dans des versions futures de Showplan
Dans une future version de SQL Server, les options Showplan SET suivantes seront désapprouvées. Nous invitons ainsi les utilisateurs à adopter les nouveaux modes le plus tôt possible. Le tableau suivant répertorie les options Showplan SET appelées à être désapprouvées, ainsi que les nouvelles options SET que nous invitons les utilisateurs à utiliser.
Option SET désapprouvée |
Utiliser la nouvelle option SET |
|---|---|
SET SHOWPLAN_TEXT |
SET SHOWPLAN_XML |
SET SHOWPLAN_ALL |
SET SHOWPLAN_XML |
SET STATISTICS PROFILE |
SET STATISTICS XML |