Plans de requête
en coursTransformez un plan d’exécution en observations utiles, en arbre navigable ou en diagramme facile à suivre.
Un plan de requête, c’est la base de données qui explique comment elle compte répondre à votre requête : quels index elle utilise, comment elle joint et où passe le coût. SQLly transforme cette explication en constats, un opérateur arbre, et un diagramme. Un modèle partagé permet de garder un plan PostgreSQL, un plan SQL Server et un plan ClickHouse ou Oracle lisibles de la même manière.
Capturer un plan
| Capturer | Ce que cela fait | Exécute la requête ? |
|---|---|---|
| Réel (⌘L / le bouton Expliquer) | Exécute la requête et capture le plan avec réel nombres de lignes. | Oui |
| Estimé (menu / palette de commandes) | Demande au moteur son plan sans exécuter - estimations seulement. | Non |
| Profil | Une capture réelle avec des détails supplémentaires (buffers, verbose). SELECT uniquement. | Oui |
| Ouvrir / Coller | Charger un .sqlplan/.json/.xml plan, ou un depuis le presse-papiers - rien n'est exécuté. | Non |
Constats - le plan en termes humains
La vue par défaut n'est pas un mur d'opérateurs - c'est une liste classée de constats, du pire au meilleur. Chacun est écrit en langage clair avec un résumé, un pourquoi, et une action suggérée, souvent avec du SQL prêt à l'emploi que vous pouvez copier ou ouvrir dans un nouvel onglet, plus le détail technique à un clic de dépliage.
- Analyse de table - « Parcourt chaque ligne dans dbo.Orders pour trouver des correspondances. »
- Index manquant - avec un
CREATE NONCLUSTERED INDEXinstruction. - Écart entre estimation et réel - « Estimation de 10 lignes mais 48,2K lues → mettre à jour les statistiques » (plans réels seulement).
- Conversion implicite, recherche par clé, débordement vers tempdb, statistiques manquantes, produit croisé (aucune condition de jointure), objectifs de lignes et spools - chacun avec sa propre explication et solution.
Sous les constats, un Opérateurs la liste affiche chaque opérateur du plus cher au moins cher - « Index Seek — 4 lignes estimées, 91 % du coût, lecture 7 » - avec le détail complet par opérateur (id du nœud, opérateur physique/logique, coût CPU/IO, lignes réelles, avertissements, colonnes de sortie) une fois déplié.
Arbre et diagramme
Arbre la vue est la hiérarchie des opérateurs sous forme d'arborescence indentée et dépliable, chaque ligne montrant l'opérateur, sa part du coût, les lignes estimées, le → actual nombre (surligné quand il diffère), et un ⚠ compteur d'avertissements, avec navigation au clavier.
Diagramme la vue dessine le plan de haut en bas comme un
toile nœud-et-arête. Chaque nœud est une boîte avec le nom de l'opérateur, une cost% · estimated rows → actual ligne, et un
barre de coût dont la longueur suit la part du coût de l'opérateur et passe à l'ambre quand elle porte un avertissement. Les arêtes sont tracées du parent vers l'enfant avec des pointes de flèches ; vous pouvez déplacer le canevas et cliquer sur n'importe quel nœud pour le sélectionner et voir tous ses détails ci-dessous, la même sélection que l'arbre partage.


Lots, plans propres et comparaison
- Lots multi-instructions obtenez une barre d'onglets par instruction - les constats restent regroupés par instruction plutôt que mélangés.
- Plans propres dites-le franchement : « Ce plan semble bon. Aucun problème détecté. » La liste des opérateurs est toujours là quand vous en avez besoin.
- Mode comparaison garde les captures récentes et compare une base de référence à une exécution ultérieure - mettant en évidence les opérateurs qui ont régressé, amélioré, ou ont été ajoutés/supprimés, afin que vous puissiez prouver qu’un changement d’optimisation a réellement aidé.
- Une Explication IA est une action qui remet un résumé condensé du plan à l’assistant pour une explication en langage naturel.
Prise en charge des moteurs
| Moteur | Réel | Estimé |
|---|---|---|
| SQL Server | SET STATISTICS XML | SET SHOWPLAN_XML |
| PostgreSQL | EXPLAIN (ANALYZE, FORMAT JSON) | EXPLAIN (FORMAT JSON) |
| MySQL 8 | EXPLAIN ANALYZE | EXPLAIN FORMAT=JSON |
| MariaDB | ANALYZE FORMAT=JSON | EXPLAIN FORMAT=JSON |
| SQLite | EXPLAIN QUERY PLAN (estimation uniquement - jamais exécuté) | |
| libSQL / Turso | EXPLAIN QUERY PLAN (estimation uniquement - plan de SQLite via le réseau) | |
| DuckDB | EXPLAIN ANALYZE | EXPLAIN |
| ClickHouse | - (sans EXPLAIN ANALYZE) | EXPLAIN json = 1, avec les parties et les granules de chaque index élagués |
| Oracle | STATISTICS_LEVEL = ALL, relu à partir de V$SQL_PLAN_STATISTICS_ALL | EXPLAIN PLAN FOR relu à partir de PLAN_TABLE |
Chaque dialecte est analysé dans le même modèle de plan, donc les constats - scans de tables, parts de coût, estimé vs réel - se lisent de façon cohérente quel que soit le moteur qui a produit le plan. Lorsqu'un moteur n'offre qu'une forme estimée, la commande Réel l'indique et vous renvoie à Estimé ; sur ClickHouse, elle renvoie également à Query Insights pour les lignes, octets et mémoire d'une exécution. Les commandes Redis n'ont aucun plan d'exécution du tout - SLOWLOG GET montre leurs temps d'exécution.