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, GroupAggregate | GROUP 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.