Расположение информации в плане запроса

Графический SVG-план запроса с метриками получают после фактического выполнения запроса — см. Получение графического плана при выполнении запроса через CLI и в UI. Ниже разобраны колонки диаграммы.

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

Отдельные регионы (колонки)

Ниже показан план простого запроса:

SELECT count(*) FROM lineitem

План выводится в виде таблицы: слева — структура стадий, справа — колонки с метриками и графиками.

Query - ...-- структура плана

Самая левая колонка — структура стадий плана. Каждая строка таблицы соответствует одной стадии; операторы внутри стадии — шаги обработки данных (подробнее — в Структуре фактического плана запроса).

Заголовок начинается с общего префикса Query, вторая часть заголовка зависит от типа выполняемого запроса:

• ResultSet (как в примере выше) — запросы с выборкой (SELECT);
• Sink — модифицирующие запросы (INSERT, UPDATE, DELETE);
• Precompute — отдельно выполняемые фрагменты плана, см. Составные структуры.

Rows-- операторная статистика

Стадия состоит из одного или нескольких операторов. Если хотя бы один физический оператор отдаёт статистику, колонка Operators заполнена; у стадий без отчётности по операторам ячейка пуста. Содержимое колонки дополняет картину по структуре стадии и агрегированным метрикам в Stages.

Tasks-- число задач стадии и прогресс их выполнения

В YDB запрос выполняется распределённо: одна и та же стадия может параллельно обрабатываться несколькими задачами на одном или нескольких узлах кластера.

В колонке Tasks указано число задач, запланированных для стадии. При наведении курсора во всплывающей подсказке видно, сколько из них уже завершилось. Слева в той же колонке прогресс показан пунктирной полосой.

Цвет фона колонки отражает интенсивность потребления CPU стадией; см. Потребление CPU.

Statistics-- метрики по стадиям

Колонка Statistics — агрегированные метрики по всем задачам стадии. Часть метрик описана в Визуализация метрик запроса. Общее свойство: это рассчитанные значения в некоторый момент времени (как правило, в конце выполнения запроса).

Одинаковые метрики по разным стадиям приводятся к одному масштабу, чтобы их можно было быстро сравнивать между собой, например, потребление CPU или памяти. Подробнее — Масштаб метрик.

Временная шкала

Колонка с условным названием Timeline (это название не выводится в плане, на этом месте отображаются отметки времени) показывает те же самые величины, что и Statistics, но на всём интервале выполнения запроса. Шаг временной сетки подбирается автоматически. Длительность запроса указана в сером прямоугольнике в правом верхнем углу колонки.

Интерактивные возможности

Откройте план запроса в отдельной вкладке браузера. У крупного запроса план занимает много строк и его удобно упрощать на экране:

• У каждой стадии кнопка сворачивает поддерево, начиная с этой стадии (кнопка меняется на для разворота).
• Кнопка переводит стадию в режим slim: по высоте остаётся одна метрика (Output). Обычный вид возвращается при любом действии на стадии.
• В левом верхнем углу плана кнопка включает режим slim для всех стадий, кнопка возвращает полный вид и разворачивает все поддеревья.