Formations — 1 037 leçons en français

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 :

  1. rows= contre actual rows= — un grand écart signale des statistiques fausses, et explique presque tous les mauvais plans.
  2. 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.
  3. 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 ANALYZE sur un UPDATE modifie 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) et shared 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.

Lire l'explication détaillée et faire le quiz →

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.