Formations — 1 037 leçons en français

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 text et integer, ou timestamptz et date.

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 ANALYZE montre un grand écart entre rows= estimé et actual 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 = off force l'usage d'un index pour comparer les coûts. Outil d'analyse en session, jamais un réglage de production.

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.