Plans de requête

en cours

Transformez 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

CapturerCe que cela faitExé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
ProfilUne capture réelle avec des détails supplémentaires (buffers, verbose). SELECT uniquement.Oui
Ouvrir / CollerCharger un .sqlplan/.json/.xml plan, ou un depuis le presse-papiers - rien n'est exécuté.Non
Réel vs estimé. Un plan réel a été exécuté, donc ses nombres de lignes montrent ce qui s'est passé et peuvent révéler où les estimations étaient fausses. Un plan estimé évite l'exécution, ce qui en fait le point de départ le plus sûr pour une instruction lourde ou destructrice. SQLly avertit chaque fois qu'une capture va exécuter la requête.

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 INDEX instruction.
  • É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.

SQLly
Diagramme graphique du plan d'exécution de SQLlyDiagramme graphique du plan d'exécution de SQLly
Le diagramme du plan graphique : nœuds opérateurs avec barres de coût reliés par des arêtes fléchées, avec les détails du nœud sélectionné ci-dessous.

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

MoteurRéelEstimé
SQL ServerSET STATISTICS XMLSET SHOWPLAN_XML
PostgreSQLEXPLAIN (ANALYZE, FORMAT JSON)EXPLAIN (FORMAT JSON)
MySQL 8EXPLAIN ANALYZEEXPLAIN FORMAT=JSON
MariaDBANALYZE FORMAT=JSONEXPLAIN FORMAT=JSON
SQLiteEXPLAIN QUERY PLAN (estimation uniquement - jamais exécuté)
libSQL / TursoEXPLAIN QUERY PLAN (estimation uniquement - plan de SQLite via le réseau)
DuckDBEXPLAIN ANALYZEEXPLAIN
ClickHouse- (sans EXPLAIN ANALYZE)EXPLAIN json = 1, avec les parties et les granules de chaque index élagués
OracleSTATISTICS_LEVEL = ALL, relu à partir de V$SQL_PLAN_STATISTICS_ALLEXPLAIN 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.