Accueil › SQL & bases de données › EXPLAIN ANALYZE : lire ce que fait vraiment la base
EXPLAIN ANALYZE : lire ce que fait vraiment la base
Lire un plan d'exécutionintermediaire
EXPLAIN est le seul moyen de savoir ce que fait réellement la base. Le reste est de la conjecture.
EXPLAIN (ANALYZE, BUFFERS)
SELECT c.nom, count(*)
FROM client c JOIN commande cmd ON cmd.client_id = c.id
WHERE cmd.creee_le >= DATE '2026-01-01'
GROUP BY c.id, c.nom;
HashAggregate (cost=25420.12..25520.12 rows=10000 width=40)
(actual time=312.445..315.220 rows=9842 loops=1)
Group Key: c.id
-> Hash Join (cost=289.00..24920.12 rows=100000 width=32)
(actual time=4.221..280.117 rows=98431 loops=1)
Hash Cond: (cmd.client_id = c.id)
-> Seq Scan on commande cmd (… rows=98431 …)
Filter: (creee_le >= '2026-01-01')
-> Hash (… rows=10000 …)
-> Seq Scan on client c (… rows=10000 …)
Planning Time: 0.412 ms
Execution Time: 316.882 ms
Comment le lire : de bas en haut et de l'intérieur vers l'extérieur. Les nœuds les plus indentés s'exécutent en premier et alimentent leur parent.
Ce qu'il faut regarder, dans l'ordre :
rows=contreactual rows=— un grand écart signale des statistiques fausses, et explique presque tous les mauvais plans.actual time×loops— un nœud à 0,005 ms exécuté 50 000 fois coûte 250 ms. Le temps affiché est par exécution.BUFFERS—shared readélevé signifie que les données viennent du disque, pas du cache.
Le cost= n'est pas une durée : c'est une unité arbitraire qui ne sert qu'à comparer deux plans.
Les termes à connaître
- EXPLAIN
Affiche le plan estimé sans exécuter la requête. Rapide et sans risque, mais les chiffres sont des prévisions, pas des mesures.
- EXPLAIN ANALYZE
Exécute la requête et affiche le plan réel avec les temps et les nombres de lignes mesurés. Attention : un
EXPLAIN ANALYZEsur unUPDATEmodifie vraiment les données.- cost=0.00..18334.00
Coût estimé en unités arbitraires : coût pour obtenir la première ligne, puis coût total. Sert à comparer des plans entre eux, pas à prédire une durée.
- rows= et actual rows=
Le nombre de lignes estimé par l'optimiseur, et celui réellement obtenu. Un écart important est le signal principal d'un problème de statistiques.
- BUFFERS
EXPLAIN (ANALYZE, BUFFERS)ajoute les pages lues :shared hit(depuis le cache) etshared read(depuis le disque). C'est la vraie mesure du travail effectué.- loops=
Le nombre de fois qu'un nœud a été exécuté. Les temps affichés sont par exécution : le coût total d'un nœud est
actual time × loops. Source d'erreur de lecture classique.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.