Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de données SQL dans Microsoft Fabric
Empêche Microsoft SQL Server d'exécuter des instructions Transact-SQL. Au lieu de cela, SQL Server renvoie des informations détaillées sur la façon dont les instructions seraient exécutées (un plan de requête) et fournit des estimations des exigences en ressources pour les instructions et les lignes attendues (estimation de la cardinalité).
Conventions de la syntaxe Transact-SQL
Syntaxe
SET SHOWPLAN_ALL { ON | OFF }
Notes
Le paramètre de SET SHOWPLAN_ALL est défini au moment de l’exécution ou de l’exécution et non au moment de l’analyse.
Si SET SHOWPLAN_ALL a la valeur ON, SQL Server retourne des informations sur l’exécution de chaque instruction sans toutefois l’exécuter ; les instructions Transact-SQL ne sont pas exécutées. Une fois cette option activée, des informations sur toutes les instructions Transact-SQL consécutives sont retournées, jusqu'à ce que l'option soit désactivée (OFF). Par exemple, si une CREATE TABLE instruction est exécutée alors qu’elle SET SHOWPLAN_ALL est ACTIVÉE, SQL Server renvoie un message d’erreur provenant d’une instruction SELECT ultérieure impliquant cette même table, informant les utilisateurs que la table spécifiée n’existe pas. Par conséquent, les prochaines références à cette table échoueront. Lorsque SET SHOWPLAN_ALL c’est désactivé, SQL Server exécute les instructions sans générer de rapport.
L’option SET SHOWPLAN_ALL est conçue pour être utilisée avec des applications capables de gérer ses résultats. À utiliser SET SHOWPLAN_TEXT pour retourner une sortie lisible pour les applications de l’invite de commande Win32 de Microsoft, telles que l’utilitaire osql.
SET SET SHOWPLAN_TEXT et SETSET SHOWPLAN_ALL ne peuvent pas être spécifiés à l’intérieur d’une procédure stockée ; elles doivent être les seules instructions d’un lot.
SET SHOWPLAN_ALLrenvoie l’information sous forme d’un ensemble de lignes qui forment un arbre hiérarchique représentant les étapes suivies par le processeur de requêtes SQL Server lors de l’exécution de chaque instruction. Chaque instruction reflétée dans la sortie contient une ligne unique comportant le texte de l'instruction, suivie de plusieurs lignes contenant les détails des étapes d'exécution. Le tableau suivant illustre les colonnes figurant dans les résultats.
| Nom de la colonne | Description |
|---|---|
| StmtText | Pour les lignes qui ne sont pas du type PLAN_ROW, cette colonne contient le texte de l’instruction Transact-SQL. Pour les lignes de type PLAN_ROW, cette colonne contient une description de l'opération. Cette colonne contient l'opérateur physique et peut, en option, contenir l'opérateur logique. Elle peut également être suivie d'une description qui est déterminée par l'opérateur physique. Pour plus d’informations, consultez Guide de référence des opérateurs Showplan logiques et physiques. |
| StmtId | Numéro de l'instruction dans le traitement courant. |
| NodeId | ID du nœud dans la requête courante. |
| Parent | ID du nœud de l'étape parente. |
| PhysicalOp | Algorithme d'implémentation physique du nœud. Pour les lignes de type PLAN_ROWS uniquement. |
| LogicalOp | Opérateur algébrique relationnel représenté par ce nœud. Pour les lignes de type PLAN_ROWS uniquement. |
| Argument | Fournit des informations supplémentaires sur l'opération en cours. Le contenu de cette colonne est fonction de l'opérateur physique. |
| DefinedValues | Contient la liste des valeurs introduites par cet opérateur, séparées par des virgules. Il peut s'agir d'expressions calculées présentes dans la requête courante (par exemple, dans la liste SELECT ou la clause WHERE), ou de valeurs internes introduites par le processeur de requêtes pour le traitement de cette requête. Ces valeurs définies peuvent ensuite être référencées à un autre endroit de la requête. Pour les lignes de type PLAN_ROWS uniquement. |
| EstimateRows | Estimation du nombre de lignes de résultats produites par cet opérateur. Pour les lignes de type PLAN_ROWS uniquement. |
| EstimateIO | Estimation du coût* des E/S pour cet opérateur. Pour les lignes de type PLAN_ROWS uniquement. |
| EstimateCPU | Estimation du coût* UC pour cet opérateur. Pour les lignes de type PLAN_ROWS uniquement. |
| AvgRowSize | Estimation de la taille moyenne (en octets) de la ligne transmise par le biais de cet opérateur. |
| TotalSubtreeCost | Estimation du coût* (cumulatif) de cette opération et des opérations enfants. |
| OutputList | Contient la liste des colonnes projetées par l'opération en cours, séparées par des virgules. |
| Warnings | Contient la liste des messages d'erreur (séparés par des virgules) relatifs à l'opération en cours. Les messages d'avertissement peuvent inclure la chaîne « NO STATS: () » avec une liste de colonnes. Ce message signifie que l'optimiseur de requêtes a tenté de prendre une décision en se basant sur les statistiques de cette colonne, mais aucune statistique n'était disponible. Par conséquent, l'optimiseur de requête a dû faire une estimation et a pu sélectionner un plan de requête inapproprié. Pour plus d’informations sur la création ou la mise à jour des statistiques de colonnes (qui aident l’optimiseur de requêtes à choisir un plan de requête plus efficace), voir UPDATE STATISTICS. Cette colonne peut parfois inclure la chaîne « MISSING JOIN PREDICATE » qui indique qu'une jointure (portant sur des tables) est réalisée sans prédicat de jointure. Lorsqu'un prédicat de jointure est supprimé accidentellement, l'exécution d'une requête peut prendre beaucoup plus de temps que prévu, et retourner un jeu de résultats énorme. Si cet avertissement s'affiche, vérifiez que tout prédicat de jointure manquant a été intentionnellement supprimé. |
| Type | Type de nœud. Pour le nœud parent de chaque requête, c’est le type de Transact-SQL instruction (par exemple, SELECT, INSERT, EXECUTE, etc.). Pour les sous-nœuds représentant des plans d'exécution, il s'agit du type PLAN_ROW. |
| Parallel |
0 = L’opérateur n’est pas exécuté en parallèle. 1 = L’opérateur est exécuté en parallèle. |
| EstimateExecutions | Estimation du nombre de fois que cet opérateur sera exécuté durant l'exécution de la requête courante. |
*Les unités de coût sont basées sur une mesure interne d'heure, et non sur l'horloge murale. Elles permettent de déterminer le coût relatif d'un plan par rapport à d'autres plans.
Autorisations
Pour utiliser SETSET SHOWPLAN_ALL, vous devez disposer d’autorisations suffisantes pour exécuter les instructions sur lesquelles SETSET SHOWPLAN_ALL est exécuté, et vous devez avoir l’autorisation SHOWPLAN pour toutes les bases de données contenant des objets référencés.
Pour les instructions SELECT, INSERT, UPDATE, DELETE, EXEC stored_procedure et EXEC user_defined_function , pour produire un Showplan, l’utilisateur doit :
disposer des autorisations appropriées pour exécuter les instructions Transact-SQL ;
Disposer de l'autorisation SHOWPLAN sur toutes les bases de données contenant les objets référencés par les instructions Transact-SQL, par exemple des tables, des vues, etc.
Pour toutes les autres instructions, telles que DDL, USE database_name, SETDECLARE, SQL dynamique, etc., seules les permissions appropriées pour exécuter les instructions Transact-SQL sont nécessaires.
Exemples
Les deux instructions qui suivent utilisent les SET SHOWPLAN_ALL paramètres pour montrer comment SQL Server analyse et optimise l’utilisation des index dans les requêtes.
La première requête utilise l'opérateur de comparaison Égal à (=) dans la clause WHERE sur une colonne indexée. La valeur Clustered Index Seek est insérée dans la colonne LogicalOp et le nom de l’index est inséré dans la colonne Argument.
La seconde requête utilise l'opérateur LIKE dans la clause WHERE. Cela oblige SQL Server à utiliser une analyse d'index cluster et à rechercher les données répondant à la condition spécifiée par la clause WHERE. Cette requête place la valeur Clustered Index Scan dans la colonne LogicalOp et le nom de l’index dans la colonne Argument. La valeur de filtrage est insérée dans la colonne LogicalOp et la condition de la clause WHERE est placée dans la colonne Argument.
Les valeurs des colonnes EstimateRows et TotalSubtreeCost sont plus petites pour la première requête indexée, ce qui indique qu’elle est traitée beaucoup plus rapidement que la requête non indexée, tout en utilisant moins de ressources.
USE AdventureWorks2022;
GO
SET SHOWPLAN_ALL ON;
GO
-- First query.
SELECT BusinessEntityID
FROM HumanResources.Employee
WHERE NationalIDNumber = '509647174';
GO
-- Second query.
SELECT BusinessEntityID, EmergencyContactID
FROM HumanResources.Employee
WHERE EmergencyContactID LIKE '1%';
GO
SET SHOWPLAN_ALL OFF;
GO
Voir aussi
SET Instructions (Transact-SQL)
SET SHOWPLAN_TEXT (Transact-SQL)
SET SHOWPLAN_XML (Transact-SQL)