Accueil › SQL & bases de données › Pourquoi mon index n'est pas utilisé
Pourquoi mon index n'est pas utilisé
Les indexintermediaire
L'index existe, la colonne est bien filtrée, et pourtant le plan affiche Seq Scan. Quatre causes couvrent la quasi-totalité des cas.
1. Le prédicat n'est pas sargable — la colonne est enveloppée :
WHERE date(creee_le) = DATE '2026-09-21' -- ✗
WHERE lower(email) = '[email protected]' -- ✗ (sauf index sur expression)
WHERE client_id::text = '42' -- ✗ conversion sur la colonne
WHERE total + 10 > 100 -- ✗ calcul sur la colonne
2. L'index ne serait pas rentable. Si la requête ramène une grande partie de la table, le parcours séquentiel est le bon choix. Ce n'est pas un problème à corriger.
3. Les statistiques sont fausses. L'optimiseur estime le nombre de lignes à partir d'un échantillon. Après un import massif sans ANALYZE, ses estimations peuvent être fausses d'un facteur 1000 — et son plan avec.
ANALYZE commande;
4. L'index ne correspond pas. Index composite dont le préfixe n'est pas utilisé, index partiel dont la condition n'apparaît pas dans la requête, ordre de tri incompatible.
Le diagnostic passe toujours par le même outil : comparer rows= (estimé) et actual rows= dans EXPLAIN ANALYZE. Un grand écart désigne le coupable.
Les termes à connaître
- Prédicat non sargable
Un prédicat qui empêche l'usage de l'index parce que la colonne n'y apparaît pas seule : fonction appliquée, conversion de type, calcul. Sargable vient de Search ARGument ABLE.
- Conversion implicite
Comparer une colonne à une valeur d'un autre type oblige la base à convertir. Selon le sens de la conversion, l'index devient inutilisable — cas fréquent entre
textetinteger, outimestamptzetdate.- Statistiques
Échantillon des valeurs d'une table, maintenu par
ANALYZE, sur lequel l'optimiseur fonde ses estimations. Périmées, elles conduisent à des plans absurdes bien que l'index existe.- n_distinct et corrélation
Deux statistiques clés visibles dans
pg_stats: le nombre estimé de valeurs distinctes, et la corrélation entre l'ordre logique et l'ordre physique. Elles pèsent lourd dans le choix du plan.- Estimation erronée
Quand
EXPLAIN ANALYZEmontre un grand écart entrerows=estimé etactual rows=, l'optimiseur a raisonné sur des chiffres faux : c'est presque toujours là qu'il faut chercher.- enable_seqscan
Paramètre de diagnostic :
SET enable_seqscan = offforce l'usage d'un index pour comparer les coûts. Outil d'analyse en session, jamais un réglage de production.
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.