Индексы в Postgres, которые не работают

2 сентября 2026 · Postgres · 9 минут чтения

Самый частый разговор про производительность выглядит так: «индекс же есть, почему seq scan». Индекс действительно есть. Он просто не подходит к этому запросу — и Postgres честно об этом молчит, пока не посмотришь в план.

Ниже пять случаев, которые я встречал в реальном коде, и все они стоили кому-то вечера.

1. Несовпадение типов

Классика: колонка user_id — bigint, а в запросе приходит строка.

-- индекс по user_id (bigint) существует
SELECT * FROM orders WHERE user_id = '12345';

Литерал приводится к bigint, и всё работает. Но если значение приходит из параметра с типом text (а драйвер не сказал иначе), сравнение идёт как bigint = text — с неявным приведением колонки, и индекс перестаёт использоваться. В плане появляется Seq Scan с фильтром.

Лечится приведением на стороне запроса: user_id = $1::bigint, и проверкой типов в слое доступа к данным. В ORM это обычно означает «не передавайте строку туда, где ждут число».

2. Функция от колонки

-- индекс по created_at есть
SELECT count(*) FROM events
WHERE created_at::date = current_date;

Приведение к date превращает колонку в выражение, и обычный индекс по created_at к нему не относится. Варианты: переписать условие как диапазон

WHERE created_at >= current_date
  AND created_at <  current_date + interval '1 day'

или создать индекс по выражению ((created_at::date)). Первое лучше: диапазон использует существующий индекс и работает с любыми планами.

3. Локаль и LIKE

Индекс text_pattern_ops нужен, когда база создана с локалью, отличной от C, а вы ищете по префиксу:

CREATE INDEX idx_users_email_pattern
  ON users (email text_pattern_ops);

Без него WHERE email LIKE 'artem%' может не использовать btree-индекс. Проверяется просто: EXPLAIN покажет Index Scan вместо Seq Scan.

4. Индекс есть, но статистика врёт

Планировщик выбирает между индексом и seq scan по оценке селективности. Если автовакуум отстал, оценка может быть сильно неверной — например, он думает, что под условие попадает половина таблицы, и честно выбирает seq scan.

SELECT relname, last_analyze, last_autoanalyze, n_live_tup
FROM pg_stat_user_tables
WHERE relname = 'orders';

ANALYZE orders;

Иногда после ANALYZE план меняется без единой правки в запросе. Если таблица обновляется пачками, стоит поднять autovacuum_analyze_scale_factor для неё.

5. Условие не покрыто индексом

Составной индекс (status, created_at) помогает запросу WHERE status = 'new' ORDER BY created_at DESC. Но если в запросе появится OR status = 'new' OR status = 'retry', планировщик может уйти в seq scan — особенно когда значений мало и они встречаются часто.

Здесь помогает частичный индекс:

CREATE INDEX idx_orders_active
  ON orders (created_at DESC)
  WHERE status IN ('new', 'retry');

Он меньше, горячее в кэше и точно соответствует запросу.

Как быстро найти такие места

Включите pg_stat_statements и отсортируйте по total_exec_time. Дальше для каждого тяжёлого запроса — EXPLAIN (ANALYZE, BUFFERS) и вопрос: «какой индекс я ожидал здесь увидеть и почему его нет».

SELECT query, calls, total_exec_time, mean_exec_time
FROM pg_stat_statements
ORDER BY total_exec_time DESC
LIMIT 20;

И отдельно проверьте неиспользуемые индексы — они замедляют запись и едят место:

SELECT relname, indexrelname, idx_scan
FROM pg_stat_user_indexes
WHERE idx_scan = 0
ORDER BY pg_relation_size(indexrelid) DESC;

Осторожно с выводами: idx_scan = 0 может означать, что статистика сбрасывалась или запрос выполняется редко (раз в месяц, но важный). Прежде чем удалять — посмотрите pg_stat_reset() и период наблюдения.

Общий вывод простой: индекс — это не галочка в схеме, а контракт с конкретным набором запросов. Меняется запрос — пересматривается и контракт.