// бесплатный инструмент

Просмотрщик плана запроса

Вставьте план выполнения из SQL Server, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse или Oracle и узнайте, что замедляет запрос, почему и что изменить, — замечания по приоритету, дерево операторов и диаграмма плана. Это просмотрщик планов из настольного приложения SQLly, скомпилированный в WebAssembly, поэтому он работает в вашем браузере и ваш план запроса никогда не покидает ваше устройство.

Loading the plan reader…

Совет: нажмите Ctrl+Enter (⌘+Enter на Mac) в поле для анализа. Файлы читаются на этом устройстве средствами браузера; ничего не загружается.

Что делает этот просмотрщик плана выполнения

План запроса — это ответ базы данных на вопрос «как ты это выполнишь?» — какие индексы она читает, как соединяет таблицы, сколько строк ожидает на каждом шаге и куда уходят затраты. Планы плотные, и каждый движок пишет их по-своему. Этот просмотрщик сводит их к одной модели и начинает с главного: ранжированный список проблем человеческим языком, у каждой — чем она вредит и конкретный следующий шаг.

  • Сначала выводы. Полные сканирования, отсутствующие индексы, неявные преобразования, поиск по ключу, переполнения, отсутствующая статистика, перекрестные соединения, цели по строкам и ошибки в оценке числа строк — сначала самые серьезные, с указанием оператора, к которому они относятся, а для предложений о недостающих индексах SQL Server — готовый к рассмотрению CREATE INDEX оператора.
  • Восемь движков, один вид. Планы SQL Server, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse и Oracle читаются одинаково, так что не нужен отдельный инструмент для каждой базы данных.
  • Дерево и диаграмма. Дерево операторов показывает для каждого шага его долю стоимости, а рядом — оценочное и фактическое число строк, с выделением промахов в 10× и больше. Диаграмма раскладывает план сверху вниз, с полосами стоимости, которые легко окинуть взглядом.
  • Пакеты и вставленный вывод. Планы SQL Server с несколькими инструкциями получают переключатель инструкций. Вывод, скопированный из psql, клиента mysql или sqlplus, разворачивается для вас — нет необходимости удалять границы или + сначала продолжения.
  • Приватно. Весь анализ выполняется в вашей вкладке. Планы содержат ваш SQL, имена таблиц и иногда значения параметров; ничего из этого не загружается.

Как получить план выполнения из каждой базы данных

У каждого движка есть два вида планов. оценочный план — это прогноз оптимизатора, и он никогда не выполняет запрос. А фактическую план выполняет запрос и записывает фактическое число строк — единственный способ увидеть, где оптимизатор ошибся. Захват фактического плана выполняет и INSERT, UPDATE, DELETE, поэтому изменения тестовых данных происходят внутри транзакции, которую вы откатываете.

SQL Server и Azure SQL: ShowPlan XML

Фактический план — выполняет запрос и возвращает один документ плана на каждое выражение после результатов:

SET STATISTICS XML ON;
SELECT ... ;   -- your query
SET STATISTICS XML OFF;

Оценочный план — компилируется без выполнения. SET SHOWPLAN_XML должен быть единственным оператором в пакете, отсюда и GO разделители:

SET SHOWPLAN_XML ON;
GO
SELECT ... ;   -- your query
GO
SET SHOWPLAN_XML OFF;

В SSMS включите Включить фактический план выполнения (Ctrl+M) плюс Отобразить предполагаемый план выполнения (Ctrl+L), затем щёлкните правой кнопкой мыши по графическому плану и выберите Сохранить план выполнения как… чтобы получить .sqlplan файл, который вы можете открыть здесь, или Показать XML плана выполнения… чтобы скопировать XML. Планы, уже находящиеся в кэше или в Query Store, тоже работают: sys.dm_exec_query_plan(plan_handle) возвращает XML, а sys.query_store_plan.query_plan сохраняет его как текст. Если вы копируете большой план из сетки результатов SSMS, а просмотрщик сообщает о неполном XML, его обрезала сетка (её лимит XML задаётся в Tools > Options > Query Results > SQL Server > Results to Grid); вместо этого сохраните план в файл.

PostgreSQL: EXPLAIN (FORMAT JSON)

-- Actual plan: runs the query
EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) SELECT ... ;

-- Estimated plan: does not run it
EXPLAIN (FORMAT JSON) SELECT ... ;

-- Measure a data change without keeping it
BEGIN;
EXPLAIN (ANALYZE, FORMAT JSON) UPDATE ... ;
ROLLBACK;

Просмотрщик читает формат JSON, а не стандартный текстовый вывод PostgreSQL. Вставить прямо из psql можно — QUERY PLAN заголовок и + в конце каждой строки удаляются — или выполните psql -XqAt -c "EXPLAIN (ANALYZE, FORMAT JSON) ..." для чистого вывода. Для планов запросов, которые выполняло ваше приложение, auto_explain может их логировать с помощью auto_explain.log_format = json.

MySQL: EXPLAIN FORMAT=JSON и EXPLAIN ANALYZE

-- Estimated plan as JSON: does not run the query
EXPLAIN FORMAT=JSON SELECT ... ;

-- Actual plan (MySQL 8.0.18 and later): runs the query
EXPLAIN ANALYZE SELECT ... ;

Оба распознаются, и просмотрщик различает их по форме. Границы таблиц клиента mysql, \G строчные баннеры и колонтитулы вида «1 row in set» вырезаются при вставке. Свежие версии MySQL умеют выдавать и второй JSON-формат (explain_json_format_version = 2); средство просмотра читает оригинал, поэтому выполните SET explain_json_format_version = 1; сначала, если ваш сервер использует версию 2 по умолчанию.

MariaDB: EXPLAIN и ANALYZE FORMAT=JSON

-- Estimated plan: does not run the query
EXPLAIN FORMAT=JSON SELECT ... ;

-- Actual plan with r_rows, r_loops and timings: runs the query
ANALYZE FORMAT=JSON SELECT ... ;

SQLite: EXPLAIN QUERY PLAN

EXPLAIN QUERY PLAN SELECT ... ;

SQLite никогда не выполняет оператор для EXPLAIN QUERY PLAN, и его планы не содержат оценок стоимости или количества строк — только шаги, чего достаточно, чтобы заметить SCAN , который должен быть SEARCH. sqlite3 дерево оболочки (QUERY PLAN, |--, `--) читается как есть, так же как и сырые id | parent | notused | detail строки, которые возвращают другие инструменты. В оболочке .eqp on печатает план перед каждым выполняемым вами оператором.

DuckDB: EXPLAIN (FORMAT JSON)

-- Estimated plan
EXPLAIN (FORMAT JSON) SELECT ... ;

-- Actual plan with per-operator rows and timing: runs the query
EXPLAIN (ANALYZE, FORMAT JSON) SELECT ... ;

Вставьте JSON из explain_value столбце. В DuckDB нет единиц стоимости, поэтому на фактическом плане операторы подкрашиваются в зависимости от затраченного времени.

ClickHouse: EXPLAIN json = 1

EXPLAIN json = 1, indexes = 1
SELECT ...
FORMAT TSVRaw;

indexes = 1 добавляет, сколько частей и гранул хранил каждый первичный ключ, ключ партиционирования и skip-индекс; именно по ним просмотрщик замечает чтение, которое ничего не отсекло. FORMAT TSVRaw возвращает JSON без экранирования. В ClickHouse нет EXPLAIN ANALYZE, поэтому его планы всегда являются оценочными.

Oracle Database: DBMS_XPLAN

-- Estimated plan: does not run the query
EXPLAIN PLAN FOR SELECT ... ;
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY);

-- Actual plan: run the query with row-source statistics, then read its cursor
SET SERVEROUTPUT OFF
SET LINESIZE 300
SELECT /*+ GATHER_PLAN_STATISTICS */ ... ;
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY_CURSOR(NULL, NULL, 'ALLSTATS LAST'));

Вставьте весь вывод, включая раздел Predicate Information - просмотрщик прикрепляет каждый access и filter предикат к соответствующей операции. DISPLAY_CURSOR требуется доступ SELECT к V$SESSION, V$SQL, V$SQL_PLAN и V$SQL_PLAN_STATISTICS_ALL, предоставленный напрямую пользователю. Держите SERVEROUTPUT выключенным в SQL*Plus или SQLcl, иначе «последний курсор», который он показывает, будет вызовом вывода, а не вашим запросом, и расширьте LINESIZE чтобы таблица плана не переносилась.

Что означает каждая находка и как её исправить

Выводы ранжируются по степени серьёзности, а затем по доле оператора плана в стоимости инструкции, поэтому первая карточка обычно описывает самую дорогую проблему, которую можно исправить. Каждый вывод называет оператор, из которого он получен, — выберите его, чтобы перейти к нему в дереве.

Отсутствующий индекс

Что это означает. Во время компиляции выражения SQL Server разработал индекс, который сделал бы его более экономичным, и зафиксировал это в плане с оценочным улучшением. Просмотрщик сообщает об этом один раз, на операторе, который читает эту таблицу, и превращает это в CREATE NONCLUSTERED INDEX . Рекомендации с расчётным эффектом 90% и более помечаются как критические.

Как это исправить. Относитесь к инструкции как к черновику. Оптимизатор перечисляет столбцы равенства, затем столбцы неравенства, затем включаемые столбцы, не проверяя уже существующие индексы, — существующий индекс часто можно расширить вместо добавления почти дубликата, а каждый индекс замедляет запись. Убедитесь, что порядок ключевых столбцов подходит и вашим другим запросам, затем создайте индекс и снимите план еще раз. Это заключение верно только для планов SQL Server; другие движки не сохраняют рекомендации по индексам.

Полное сканирование таблицы

Что это означает. Оператор читает каждую строку таблицы (или весь индекс), чтобы найти нужные. Просмотрщик помечает сканирование таблиц и сканирование индексов с остаточным предикатом в SQL Server, PostgreSQL Seq Scan, MySQL и MariaDB access_type: ALL и Table scan on, SQLite SCAN шаги без индекса, сканирования DuckDB без протолкнутого фильтра, чтения ClickHouse, где индексы не отсекли ни одной гранулы, и Oracle TABLE ACCESS FULL.

Как это исправить. Для небольших таблиц и запросов, которым нужны почти все строки, сканирование — правильный выбор. Если фильтр селективный, добавьте индекс по фильтруемым или соединяемым столбцам и убедитесь, что предикат может его использовать: без функции, обёрнутой вокруг столбца (WHERE lower(email) = ... нужен индекс по выражению в PostgreSQL), без ведущего подстановочного знака в LIKE '%x', и совпадающие типы данных. В ClickHouse фильтруйте по префиксу ORDER BY ключ или добавьте индекс пропуска данных.

Ошибка в оценке числа строк

Что это означает. Фактический план прочитал как минимум в 10 раз больше или меньше строк, чем оценивал оптимизатор для этого оператора. Все последующие решения — тип соединения, порядок соединений, выделение памяти — принимались из расчёта на неправильный объём данных, поэтому крупный промах внизу плана часто объясняет медлительность выше по плану. Замечание показывается, только когда у плана есть статистика выполнения. В планах SQL Server оценка сравнивается по всем выполнениям оператора; PostgreSQL приводит оба числа на каждой итерации.

Как это исправить. Начнём со статистики: UPDATE STATISTICS в SQL Server, ANALYZE в PostgreSQL, ANALYZE TABLE в MySQL и MariaDB, DBMS_STATS.GATHER_TABLE_STATS в Oracle. Если числа всё равно сильно расходятся, предикат трудно оценить: коррелированные столбцы (у PostgreSQL CREATE STATISTICS помогает), функция в столбце или локальная переменная в T-SQL, значение которых оптимизатор не может увидеть (OPTION (RECOMPILE) позволяет это).

Неявное преобразование блокирует поиск

Что это означает. SQL Server пришлось преобразовать значения столбца к другому типу перед сравнением, поэтому он не смог искать по индексу этого столбца и вместо этого просканировал его. Классическая причина — nvarchar параметр, сравниваемый со varchar столбцом. Просмотрщик сообщает о предупреждениях SQL Server о преобразовании в плане поиска («Seek Plan»); преобразования, которые влияют только на оценку кардинальности, перечислены отдельно как предупреждения оптимизатора.

Как это исправить. Сделайте сравниваемое значение того же типа, что и столбец: объявите параметр как varchar, задайте тип и длину параметра явно в своём коде доступа к данным, вместо того чтобы драйвер выводил их из строки, или измените столбец, если он действительно должен быть Unicode.

Поиск ключа

Что это означает. SQL Server нашёл строки по некластерному индексу, а затем возвращался к таблице за каждой строкой, чтобы забрать столбцы, которых в индексе нет (Key Lookup или RID Lookup по куче). Для нескольких строк это дёшево, для тысяч дорого, потому что каждое обращение — отдельное чтение.

Как это исправить. Если он выполняется для многих строк, добавьте недостающие столбцы в индекс INCLUDE список так, чтобы он охватывал весь запрос, или выберите меньше столбцов. Для нескольких строк это обычно нормально — план отмечает это как информацию, а не как предупреждение.

Выгрузка в tempdb

Что это означает. Оператор сортировки или хеширования исчерпал память, выделенную SQL Server для выполнения запроса, и записал промежуточные строки в tempdb, что значительно медленнее, чем работа в памяти. Обычно это симптом заниженной оценки количества строк: выделенная память была рассчитана на меньшее количество строк, чем фактически поступило.

Как это исправить. Сначала исправьте оценку (см. пропуск оценки строк), уменьшите количество строк, доходящих до оператора, с помощью более селективного фильтра или удалите ненужное ORDER BY или DISTINCT. Новые версии SQL Server сами корректируют выделение памяти между выполнениями (memory grant feedback); ручной рычаг — MIN_GRANT_PERCENT , подсказка запроса.

Столбцы без статистики

Что это означает. У SQL Server не было статистики по столбцу, который используется в фильтре или соединении, поэтому оценка числа строк там — лишь догадка.

Как это исправить. Убедитесь, что AUTO_CREATE_STATISTICS включен для базы данных, или создайте статистику по указанным столбцам с помощью CREATE STATISTICS.

Нет условия соединения

Что это означает. У соединения нет условия, связывающего два входа, поэтому каждая строка с одной стороны объединяется с каждой строкой с другой: две таблицы по 1000 строк становятся миллионом строк до применения какого-либо фильтра. Почти всегда это отсутствующее или неправильно написанное ON выражение.

Как это исправить. Добавьте условие соединения. Если вы действительно хотите все комбинации, напишите CROSS JOIN чтобы намерение было ясно.

Цель по строкам

Что это означает. TOP, EXISTS, IN или OPTION (FAST n) сказали SQL Server, что ему нужны только первые несколько строк, поэтому он выбрал план, который быстро начинает отдавать строки, — обычно вложенные циклы по индексу, — даже если выполнить его до конца дороже.

Как это исправить. Обычно ничего: это тот план, который нужен для запроса top-N. Если запрос в итоге читает куда больше строк, чем предполагала цель, то именно цель по строкам — причина того, как выглядит план; SQL Server 2016 SP1 и новее принимают OPTION (USE HINT('DISABLE_OPTIMIZER_ROWGOAL')) для сравнения с планом без него.

Spool

Что это означает. SQL Server сохранял промежуточные строки во временной таблице (Table Spool или Index Spool) для повторного использования. Это часто разумная оптимизация, но eager index spool означает, что оптимизатор строит временный индекс при каждом выполнении, потому что постоянного индекса нет.

Как это исправить. Оставьте как есть, если только спул не несёт большую долю стоимости. Для индексного спула создайте индекс, который он строит — какой именно, показывают его столбцы поиска.

Другие предупреждения оптимизатора

Что это означает. Предупреждения, записанные движком, которые не относятся к категориям выше, показываются в формулировках самого движка — например, предупреждение SQL Server о чрезмерном выделении памяти (запрос зарезервировал куда больше памяти, чем использовал, из-за чего голодают параллельные запросы) или преобразование типа, которое может повлиять на оценку кардинальности.

Как это исправить. Прочитайте сведения об операторе. Чрезмерные выделения памяти обычно связаны с завышенной оценкой числа строк или широкими varchar(max) столбцов, которые сортируются; преобразования исправляются так же, как и обнаружение неявного преобразования.

Чтение дерева и диаграммы

  • Данные движутся вверх. Корневой оператор — тот, который возвращает вам строки, — находится наверху. Дочерние узлы кормят его строками, а листья внизу — это места, откуда данные читаются из таблиц и индексов.
  • Доля стоимости. Процент — это оценочная стоимость поддерева оператора по отношению ко всему запросу, та же цифра, которую сообщают SQL Server, PostgreSQL, MySQL и Oracle. Стоимость выражается в единицах оптимизатора, а не в миллисекундах, и включает всё, что ниже оператора; планы DuckDB используют вместо неё время, а у планов SQLite и ClickHouse стоимости нет вовсе.
  • Оценка → фактическое. На реальном плане каждый оператор показывает, чего ожидал оптимизатор и что произошло на самом деле. Расхождение в 10× и больше выделяется, потому что именно там планы дают сбой.
  • Янтарные полосы. На диаграмме полоса под оператором отслеживает его долю стоимости и становится янтарной, когда у этого оператора есть предупреждение.

Веб-просмотрщик и настольное приложение SQLly

Эта страница и панель планов в SQLly используют один и тот же парсер и движок анализа. Настольное приложение добавляет все, что требует живого подключения.

ВозможностьВеб-просмотрщикНастольная версия SQLly
Выводы, дерево операторов и диаграммаДаДа
Откройте или вставьте сохранённый планДаДа
Снимайте фактические или оценочные планы одной комбинацией клавиш-Да, из редактора
Опции EXPLAIN (ANALYZE, BUFFERS, VERBOSE…) запоминаются для каждого соединения-Да
Профиль, который выполняет только SELECT-запросы-Да
Сравните два захвата одного и того же запроса-Да
Откройте предложенный индекс в новой вкладке запросаТолько копироватьДа
Пошаговое объяснение плана с помощью ИИ-Да

Вопросы и ответы о просмотрщике плана запроса

Бесплатен ли этот просмотрщик планов запросов?

Да. Регистрация не нужна, и количество открытых планов не ограничено. Это тот же просмотрщик планов из настольного приложения SQLly, выпущенный как бесплатный веб-инструмент.

Загружается ли мой план выполнения куда-либо?

Нет. Просмотрщик скомпилирован в WebAssembly и работает прямо в вашей вкладке браузера. Вставленный или открытый план читается на вашем устройстве — он никогда не отправляется на сервер, не логируется и не хранится. Планы содержат текст вашего SQL, имена таблиц, а иногда и значения параметров, поэтому это важно.

Какие форматы планов он умеет читать?

SQL Server ShowPlan XML (.sqlplan файлы, SET STATISTICS XML и SET SHOWPLAN_XML вывод), PostgreSQL EXPLAIN (FORMAT JSON) с или без ANALYZE, MySQL EXPLAIN FORMAT=JSON и EXPLAIN ANALYZE, MariaDB EXPLAIN FORMAT=JSON и ANALYZE FORMAT=JSON, SQLite EXPLAIN QUERY PLAN, DuckDB EXPLAIN (FORMAT JSON), ClickHouse EXPLAIN json = 1 и Oracle DBMS_XPLAN вывод. Формат определяется автоматически.

Выполнится ли мой запрос при сборе фактического плана?

Да. SET STATISTICS XML, EXPLAIN ANALYZE, ANALYZE FORMAT=JSON и GATHER_PLAN_STATISTICS все выполняют оператор, включая любые INSERT, UPDATE или DELETE. Используйте оценочную форму (SET SHOWPLAN_XML, EXPLAIN без ANALYZE, EXPLAIN PLAN FOR), когда оператор не должен выполняться, или оберните изменение данных в транзакцию, которую потом откатите.

Почему SQLly не может прочитать мой план PostgreSQL?

Просмотрщик читает JSON-формат плана PostgreSQL, а не формат текста по умолчанию. Выполните EXPLAIN (FORMAT JSON) или EXPLAIN (ANALYZE, FORMAT JSON) и вставьте результат. Вывод, скопированный прямо из psql, включая его QUERY PLAN заголовок и + в конце каждой строки очищается автоматически.

Почему у некоторых движков нет стоимости и числа строк?

Просмотрщик показывает только то, что сообщает движок. У SQLite EXPLAIN QUERY PLAN нет затрат или оценок строк, у ClickHouse нет модели затрат, а у DuckDB нет единиц затрат, поэтому эти планы показывают структуру операторов и сканирования, а не доли затрат. Фактическое количество строк появляется только для планов, снятых со статистикой во время выполнения.

Могу ли я сравнить два плана выполнения?

Не в веб-просмотрщике. Зато Настольное приложение SQLly хранит историю планов, снятых в каждой вкладке запроса, и сравнивает любые два из них, отмечая операторы, которые ухудшились, улучшились, появились или исчезли.

// без копирования и вставки

Сохраняйте, читайте и сравнивайте планы там, где вы пишете SQL

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Нажмите «Explain» в редакторе, чтобы снять фактический или ожидаемый план, прочитать те же выводы, что и на этой странице, и сравнить два запуска, чтобы доказать, что оптимизация сработала.