Menu

EXPLAIN ANALYZE в PostgreSQL: как читать план запроса

EXPLAIN показывает план, который PostgreSQL выбирает для запроса, а EXPLAIN ANALYZE выполняет запрос и добавляет реальное число строк и время каждого шага. Учимся читать дерево плана и узнавать частые узлы.

На этой странице есть исполняемые редакторы: меняйте, запускайте и сразу видите результат.

EXPLAIN query показывает план, который PostgreSQL выбирает для запроса: дерево шагов (узлов) с оценками стоимости и числа строк. EXPLAIN ANALYZE query к тому же выполняет запрос и добавляет фактическое время, строки и циклы каждого узла. Читайте дерево от самого вложенного узла наружу: внутренние узлы передают свои строки узлу над ними.

Индекса на email нет, поэтому план это Seq Scan: PostgreSQL читает каждую строку и оставляет те, что прошли Filter. Rows Removed by Filter показывает лишнюю работу. Время меняется от запуска к запуску, форма плана важнее чисел.

Как читать одну строку плана

Каждый узел выводит строку такого вида:

Seq Scan on users  (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
ЧастьЗначение
cost=STARTUP..TOTALоценка работы до первой строки и для всех строк, в единицах планировщика (не в миллисекундах)
rows (первое)ожидаемое число строк, которое вернёт узел
widthожидаемый средний размер строки в байтах
actual timeмиллисекунды до первой и до последней строки, за один цикл
rows (фактическое)возвращённые строки, за один цикл
loopsсколько раз выполнился узел; умножайте на него время и строки

Стоимость родителя включает стоимость потомков. Planning Time и Execution Time внизу это итоги для всей команды.

Частые узлы плана

EXPLAIN (COSTS OFF) скрывает числа, так проще увидеть форму плана:

Читайте изнутри. Обе таблицы сканируются, отфильтрованные клиенты попадают в Hash. Hash Join проверяет по нему каждый заказ, а GroupAggregate сверху считает результат. Узлы, которые встречаются чаще всего:

УзелЧто делает
Seq Scanчитает всю таблицу
Index Scanнаходит строки через индекс, затем читает каждую строку из таблицы
Index Only Scanотвечает по индексу, не обращаясь к таблице
Bitmap Index Scan + Bitmap Heap Scanсобирает адреса подходящих строк из индекса, затем читает их в порядке таблицы
Nested Loopдля каждой внешней строки ищет совпадения во внутреннем входе; хорош, когда внешняя сторона маленькая
Hash Join + Hashстроит хеш-таблицу по одному входу и проверяет по ней строки другого
Merge Joinсоединяет два входа, уже отсортированных по ключу соединения
Sort, Incremental Sortсортирует строки для ORDER BY, DISTINCT или merge join
HashAggregate, GroupAggregateGROUP BY через хеш-таблицу или по отсортированному входу
Limitостанавливается после N строк
Gatherсобирает строки от параллельных процессов

Ищем плохие оценки числа строк

Самая полезная проверка в EXPLAIN ANALYZE: сравнить ожидаемые rows с фактическими rows в одном узле. Если они сильно расходятся, планировщик выбрал план по неверным числам, часто потому, что статистики нет или она устарела:

Сканирование фактически возвращает 10 строк, но оценка гораздо выше: таблицу ещё не анализировали. Добавьте ANALYZE tasks; перед EXPLAIN, и оценка приблизится к 10. Autovacuum анализирует таблицы в фоне, но после массовой загрузки запускайте ANALYZE сами (см. VACUUM и autovacuum).

EXPLAIN для изменения данных без сохранения

EXPLAIN ANALYZE выполняет команду, поэтому UPDATE или DELETE меняет строки. Оберните его в транзакцию и откатите:

После отката все 1000 строк на месте.

Ввод-вывод через BUFFERS и другие параметры

EXPLAIN (ANALYZE, BUFFERS) SELECT ...;        -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...;              -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...;      -- row counts without per-node timing overhead

BUFFERS показывает ввод-вывод: узел с большим числом страниц read обращался к диску. В PostgreSQL 17 появились SERIALIZE (стоимость преобразования выходных строк в текст) и MEMORY (память планировщика). Больше разобранных планов в официальном руководстве по EXPLAIN.

Проверяем план настройками планировщика

Чтобы увидеть, какой план PostgreSQL выбрал бы без какого-то метода, отключите этот метод для своей сессии. Делайте так только в экспериментах, никогда в рабочем коде:

При 100 строках планировщик предпочитает Seq Scan; с enable_seqscan = off план показывает Index Scan using items_pkey. Сравните время двух EXPLAIN ANALYZE, чтобы понять, помогает ли индекс. RESET enable_seqscan; возвращает значение по умолчанию.

Часто задаваемые вопросы

Чем EXPLAIN отличается от EXPLAIN ANALYZE?

EXPLAIN только строит план запроса и показывает оценки. EXPLAIN ANALYZE ещё и выполняет его и добавляет фактическое время, число строк и число циклов каждого узла, поэтому работает столько же, сколько сам запрос.

Что означает cost в плане PostgreSQL?

Cost это оценка планировщика в условных единицах, масштабированных так, что последовательное чтение одной страницы стоит 1 (seq_page_cost). Она полезна для сравнения планов одного запроса, но это не время в миллисекундах.

Меняет ли EXPLAIN ANALYZE данные?

Да, для INSERT, UPDATE, DELETE и MERGE изменение выполняется по-настоящему. Запускайте его между BEGIN и ROLLBACK, чтобы измерить и не сохранить результат.

Почему выбран Seq Scan, хотя индекс есть?

Потому что планировщик считает его дешевле: таблица маленькая, запрос возвращает большую долю строк или условие не может использовать индекс. Ещё его может сбить устаревшая статистика, это исправляет ANALYZE.

Иллюстрация языков программирования Coddy

Учитесь программировать с Coddy

Начать