Что такое EXPLAIN
На этой странице
EXPLAIN показывает план выполнения, который выбрал планировщик: какие узлы (Seq Scan, Index Scan, Hash Join, Sort…) будут выполнены, в каком порядке и с какой оценкой стоимости и числа строк. EXPLAIN ANALYZE реально выполняет запрос и добавляет фактическое время и число строк для каждого узла, а с BUFFERS — сколько страниц прочитано из кеша и с диска. Главное при чтении плана: план читается изнутри наружу; сравнивайте rows (оценка) и actual rows — большое расхождение означает устаревшую статистику или неудачное условие; ищите самые дорогие узлы, Seq Scan по большим таблицам при выборке немногих строк, Sort с external merge Disk, Nested Loop с большим числом loops. EXPLAIN ANALYZE для UPDATE/DELETE выполняют внутри BEGIN … ROLLBACK.
Вопрос
Что такое EXPLAIN и как читать план запроса?
Варианты
EXPLAIN SELECT ...; -- только план и оценки
EXPLAIN ANALYZE SELECT ...; -- выполнить и показать факт
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- + чтение страниц (в PG 18 BUFFERS включён в ANALYZE по умолчанию)
EXPLAIN (ANALYZE, FORMAT JSON) SELECT ...; -- для визуализаторов
BEGIN;
EXPLAIN ANALYZE DELETE FROM orders WHERE created_at < '2020-01-01';
ROLLBACK; -- изменения не сохранятсяПример плана
EXPLAIN (ANALYZE, BUFFERS)
SELECT u.email, count(*)
FROM users u
JOIN orders o ON o.user_id = u.id
WHERE o.created_at >= now() - interval '7 days'
GROUP BY u.email;HashAggregate (cost=1520.4..1530.4 rows=1000 width=40) (actual time=12.1..12.6 rows=850 loops=1)
Group Key: u.email
-> Hash Join (cost=320.0..1470.4 rows=10000 width=32) (actual time=2.1..10.3 rows=9620 loops=1)
Hash Cond: (o.user_id = u.id)
-> Index Scan using orders_created_at_idx on orders o (... rows=10000) (actual ... rows=9620 loops=1)
Index Cond: (created_at >= (now() - '7 days'::interval))
Buffers: shared hit=210
-> Hash (... rows=10000)
-> Seq Scan on users u (... rows=10000) (actual ... rows=10000 loops=1)
Planning Time: 0.4 ms
Execution Time: 12.9 msКак читать
| Поле | Значение |
|---|---|
cost=a..b | Оценка: стоимость до первой строки .. до последней (условные единицы) |
rows | Оценка числа строк |
actual time=a..b | Фактическое время до первой и последней строки (мс, на один loop) |
actual rows | Фактическое число строк (на один loop) |
loops | Сколько раз выполнялся узел (умножайте время и строки) |
Buffers: shared hit / read | Страницы из кеша / с диска |
Rows Removed by Filter | Сколько строк прочитано и отброшено |
Основные узлы
| Узел | Смысл |
|---|---|
| Seq Scan | Чтение всей таблицы |
| Index Scan / Index Only Scan | Поиск по индексу (без обращения к таблице во втором случае) |
| Bitmap Heap Scan | Много строк через индекс, чтение страниц пачками |
| Nested Loop | Для каждой строки снаружи — поиск внутри (хорошо с индексом и малым числом строк) |
| Hash Join | Хеш-таблица по одной стороне |
| Merge Join | Слияние двух отсортированных потоков |
| Sort | Сортировка (Sort Method: external merge Disk — не хватило work_mem) |
| HashAggregate / GroupAggregate | Группировка |
| Limit | Остановка после n строк |
Сигналы проблем
rows=10в оценке иactual rows=500000— устаревшая статистика (ANALYZE), коррелированные столбцы (расширенная статистика), функция в условии.Seq Scan+Rows Removed by Filter: 999990— не хватает индекса или он не применим.Nested Loopсloops=100000и Seq Scan внутри — нет индекса на столбце соединения.Sort ... Disk— увеличитьwork_memдля запроса или убрать сортировку индексом.- Высокий
Buffers: read— данные не в кеше, возможно, читается лишнее.
Инструменты
- explain.dalibo.com и explain.depesz.com — визуализация.
auto_explain— логировать планы медленных запросов автоматически.pg_stat_statements— найти, какие запросы суммарно дороже всего.
Частые ошибки
- Анализировать только
EXPLAINбезANALYZE— оценки могут быть далеки от реальности. EXPLAIN ANALYZEдляDELETEв проде безROLLBACK.- Тестировать на пустой локальной базе — планы на маленьких таблицах другие.
- Забыть умножить
actual timeнаloops.
Что важно помнить
EXPLAIN— план и оценки,ANALYZE— факт.- Сравнивайте оценку и факт по числу строк.
- Ищите самые дорогие узлы, а не любой Seq Scan.
Мини-шпаргалка
EXPLAIN (ANALYZE, BUFFERS) query.BEGIN; EXPLAIN ANALYZE <DML>; ROLLBACK;.rowsvsactual rows.pg_stat_statements,auto_explain.