diff options
author | igorpopov1407 <igorpopov1407@yandex-team.com> | 2023-01-19 11:39:01 +0300 |
---|---|---|
committer | igorpopov1407 <igorpopov1407@yandex-team.com> | 2023-01-19 11:39:01 +0300 |
commit | de33f7fc5e19916ec9c67ce6c739b07b7c90d589 (patch) | |
tree | 815858e668e81945bc141e4cf81d599d7fcdafbb | |
parent | 904aca748e104713e53a1a12c29a743ee05d6271 (diff) | |
download | ydb-de33f7fc5e19916ec9c67ce6c739b07b7c90d589.tar.gz |
changed tables logic, rewrited intro and notes
Тикет:
Таблицы приведены в соответствие с разделом «История перегруженных партиций», отредактированы разделы «Введение» и «Замечания».
9 files changed, 197 insertions, 195 deletions
diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/intro_db.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/intro_db.md index 1a98169674..5e320902a0 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/intro_db.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/intro_db.md @@ -1,12 +1,14 @@ # Системные таблицы базы данных -Для возможности внутренней интроспекции состояния базы данных пользователю предоставляется возможность осуществлять запросы в специальные служебные таблицы (system views). Эти таблицы доступны из корня дерева базы данных и используют системный префикс пути `.sys`. +Вы можете отправлять запросы в специальные служебные таблицы (system views), чтобы следить за состоянием базы данных. Эти таблицы доступны из корня дерева базы данных и используют системный префикс пути `.sys`. -В описаниях доступных полей далее по тексту колонка **Ключ** содержит индекс поля первичного ключа соответствующей таблицы. +Индекс поля первичного ключа соответствующей таблицы содержится в описаниях доступных полей далее по тексту. -Системные таблицы содержат следующую информацию: +Системные таблицы содержат: * [Детальные данные об отдельных партициях таблиц БД](#partitions). * [Топы запросов по определенным характеристикам](#top-queries). * [Подробная информация о запросах](#query-metrics). * [История перегруженных партиций](#top-overload-partitions). + +{% include [notes](notes.md) %} diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/notes.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/notes.md index 839a17496c..bb8de470c0 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/notes.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/notes.md @@ -1,4 +1,5 @@ -## Замечания +{% note info %} -Следует иметь в виду, что обращение к системным таблицам имеет скорее аналитический характер нагрузки, и поэтому частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Нагрузка порядка 1-2 rps вполне допустима. +Обращение к системным таблицам имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS. +{% endnote %} diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_example_yql.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_example_yql.md index 432e1cf0c1..af8c100f86 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_example_yql.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_example_yql.md @@ -1,22 +1,24 @@ - Топ-5 самых загруженных партиций среди всех таблиц базы данных - ```sql - SELECT - Path, - PartIdx, - CPUCores - FROM `.sys/partition_stats` - ORDER BY CPUCores DESC - LIMIT 5 - ``` + Топ-5 самых загруженных партиций среди всех таблиц базы данных: - Список таблиц базы с размерами и нагрузкой в моменте - ```sql - SELECT - Path, - COUNT(*) as Partitions, - SUM(RowCount) as Rows, - SUM(DataSize) as Size, - SUM(CPUCores) as CPU - FROM `.sys/partition_stats` - GROUP BY Path - ```
\ No newline at end of file + > ```sql + > SELECT + > Path, + > PartIdx, + > CPUCores + > FROM `.sys/partition_stats` + > ORDER BY CPUCores DESC + > LIMIT 5 + > ``` + + Список таблиц базы с размерами и нагрузкой в моменте: + + > ```sql + > SELECT + > Path, + > COUNT(*) as Partitions, + > SUM(RowCount) as Rows, + > SUM(DataSize) as Size, + > SUM(CPUCores) as CPU + > FROM `.sys/partition_stats` + > GROUP BY Path + > ```
\ No newline at end of file diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_header.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_header.md index 554ed98f38..1f653e5f1c 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_header.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_header.md @@ -1,37 +1,37 @@ ## Партиции {#partitions} -* **partition_stats** +Следующая системная таблица хранит детализированную информацию об отдельных [партициях](../../../concepts/datamodel/table.md#partitioning) всех таблиц базы данных: -Системная таблица, предоставляющая детализированную информацию об отдельных партициях всех таблиц базы данных. Содержит информацию о моментальных метриках, таких как нагрузка на CPU или количество транзакций, находящихся в процессе исполнения, а также кумулятивные счётчики операций различного характера над партицией (например, общее количество прочитанных строк). Предназначена в первую очередь для выявления различных неравномерностей в нагрузке на партицию таблицы или размерах данных партиции таблицы. +* `partition_stats` — cодержит информацию о моментальных метриках и кумулятивные счетчики операций. К первым относятся, например, данные о нагрузке на CPU или количестве выполняемых [транзакций](../../../concepts/transactions.md). Ко вторым — общее количество прочитанных строк. -Структура таблицы: +Предназначена для выявления различных неравномерностей в нагрузке на партицию или отображения размера данных в ней. -| **Поле** | **Тип** | **Ключ** | **Значение** | -|---|---|---|---| -| OwnerId | Uint64 | 0 | Идентификатор SchemeShard, обслуживающего таблицу -| PathId | Uint64 | 1 | Идентификатор пути в SchemeShard -| PartIdx | Uint64 | 2 | Порядковый номер партиции -| DataSize | Uint64 | | Приблизительный размер партиции в байтах -| RowCount | Uint64 | | Приблизительное количество строк -| IndexSize | Uint64 | | Размер индекса партиции в таблетке -| CPUCores | Double | | Моментальное значение нагрузки на партицию (доля ядра) -| TabletId | Uint64 | | Идентификатор таблетки, обслуживающей партицию -| Path | Utf8 | | Полный путь к таблице -| NodeId | Uint32 | | Идентификатор ноды, на которой в данный момент обслуживается партиция -| StartTime | Timestamp | | Последний момент запуска таблетки, обслуживающей партицию -| AccessTime | Timestamp | | Последний момент чтения из партиции -| UpdateTime | Timestamp | | Последний момент записи в партицию -| RowReads | Uint64 | | Количество точечных чтений с момента старта таблетки партиции -| RowUpdates | Uint64 | | Количество записанных строк с момента старта -| RowDeletes | Uint64 | | Количество удалённых строк с момента старта -| RangeReads | Uint64 | | Количество чтений диапазонов строк с момента старта -| RangeReadRows | Uint64 | | Количество строк, прочитанных в диапазонах с момента старта -| InFlightTxCount | Uint64 | | Количество транзакций, находящихся в процессе исполнения -| ImmediateTxCompleted | Uint64 | | Количество завершившихся одношардовых транзакций с момента старта -| CoordinatedTxCompleted | Uint64 | | Количество завершившихся координируемых транзакций с момента старта -| TxRejectedByOverload | Uint64 | | Количество транзакций, отменённых по причине слишком высокой нагрузки (с момента старта) -| TxRejectedByOutOfStorage | Uint64 | | Количество транзакций, отменённых из-за нехватки места (с момента старта) +Кумулятивные поля (`RowReads`, `RowUpdates` и т.д.) хранят накопленные значения с момента последнего старта таблетки, обслуживающей партицию. -Ограничения: +Структура таблицы: -* кумулятивные поля (RowReads, RowUpdates и т.д.) хранят накопленные значения с момента последнего старта таблетки, обслуживающей партицию +Поле | Описание +--- | --- +`OwnerId` | Идентификатор SchemeShard, обслуживающего таблицу.<br>Тип: `Uint64`.<br>Ключ: `0`. +`PathId` | Идентификатор пути в SchemeShard.<br>Тип: `Uint64`.<br>Ключ: `1`. +`PartIdx` | Порядковый номер партиции.<br>Тип: `Uint64`.<br>Ключ: `2`. +`DataSize` | Приблизительный размер партиции в байтах.<br>Тип: `Uint64`. +`RowCount` | Приблизительное количество строк.<br>Тип: `Uint64`. +`IndexSize` | Размер индекса партиции в таблетке.<br>Тип: `Uint64`. +`CPUCores` | Double Моментальное значение нагрузки на партицию (доля ядра) +`TabletId` | Идентификатор таблетки, обслуживающей партицию.<br>Тип: `Uint64`. +`Path` | Полный путь к таблице.<br>Тип: `Utf8`. +`NodeId` | Идентификатор ноды, на которой в данный момент обслуживается партиция.<br>Тип: `Uint32`. +`StartTime` | Последний момент запуска таблетки, обслуживающей партицию.<br>Тип: `Timestamp`. +`AccessTime` | Последний момент чтения из партиции.<br>Тип: `Timestamp`. +`UpdateTime` | Последний момент записи в партицию.<br>Тип: `Timestamp`. +`RowReads` | Количество точечных чтений с момента старта таблетки партиции.<br>Тип: `Uint64`. +`RowUpdates` | Количество записанных строк с момента старта.<br>Тип: `Uint64`. +`RowDeletes` | Количество удалённых строк с момента старта.<br>Тип: `Uint64`. +`RangeReads` | Количество чтений диапазонов строк с момента старта.<br>Тип: `Uint64`. +`RangeReadRows` | Количество строк, прочитанных в диапазонах с момента старта.<br>Тип: `Uint64`. +`InFlightTxCount` | Количество транзакций, находящихся в процессе исполнения.<br>Тип: `Uint64`. +`ImmediateTxCompleted` | Количество завершившихся одношардовых транзакций с момента старта.<br>Тип: `Uint64`. +`CoordinatedTxCompleted` | Количество завершившихся координируемых транзакций с момента старта.<br>Тип: `Uint64`. +`TxRejectedByOverload` | Количество транзакций, отменённых по причине слишком высокой нагрузки (с момента старта).<br>Тип: `Uint64`. +`TxRejectedByOutOfStorage` | Количество транзакций, отменённых из-за нехватки места (с момента старта).<br>Тип: `Uint64`. diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_example_yql.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_example_yql.md index ba8eb803b2..043c1029f2 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_example_yql.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_example_yql.md @@ -1,27 +1,27 @@ - Топ-10 запросов за последние 6 часов по общему количеству записанных строк в минутном интервале - - ```sql - SELECT - SumUpdateRows, - Count, - QueryText, - IntervalEnd - FROM `.sys/query_metrics_one_minute` - ORDER BY SumUpdateRows DESC LIMIT 10 - ``` + Топ-10 запросов за последние 6 часов по общему количеству записанных строк в минутном интервале: + + > ```sql + > SELECT + > SumUpdateRows, + > Count, + > QueryText, + > IntervalEnd + > FROM `.sys/query_metrics_one_minute` + > ORDER BY SumUpdateRows DESC LIMIT 10 + > ``` Недавние запросы, прочитавшие больше всего байт за минуту: - - ```sql - SELECT - IntervalEnd, - SumReadBytes, - MinReadBytes, - SumReadBytes / Count as AvgReadBytes, - MaxReadBytes, - QueryText - FROM `.sys/query_metrics_one_minute` - WHERE SumReadBytes > 0 - ORDER BY IntervalEnd DESC, SumReadBytes DESC - LIMIT 100 - ```
\ No newline at end of file + + > ```sql + > SELECT + > IntervalEnd, + > SumReadBytes, + > MinReadBytes, + > SumReadBytes / Count as AvgReadBytes, + > MaxReadBytes, + > QueryText + > FROM `.sys/query_metrics_one_minute` + > WHERE SumReadBytes > 0 + > ORDER BY IntervalEnd DESC, SumReadBytes DESC + > LIMIT 100 + > ```
\ No newline at end of file diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_header.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_header.md index c0cf0b3163..15b86d4602 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_header.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_header.md @@ -1,45 +1,48 @@ ## Подробная информация о запросах {#query-metrics} -* **query_metrics_one_minute** +Следующая системная таблица хранит подробную информацию о запросах: -Подробная информация о запросах, разбитая по минутным интервалам. Каждая строка таблицы содержит информацию о множестве случившихся за интервал запросов с одинаковым текстом. Поля таблицы предоставляют минимальное, максимальное и суммарное значение по каждой отслеживаемой характеристике запроса. В пределах интервала запросы отсортированы по убыванию суммарного потраченного процессорного времени. +* `query_metrics_one_minute` — данные разбиты по минутным интервалам, содержит до 256 запросов за последние 6 часов. -Структура таблицы: - -| **Поле** | **Тип** | **Ключ** | **Значение** | -|---|---|---|---| -| IntervalEnd | Timestamp | 0 | Момент закрытия минутного интервала -| Rank | Uint32 | 1 | Ранг запроса в пределах интервала (по полю SumCPUTime) -| QueryText | Utf8 | | Текст запроса -| Count | Uint64 | | Количество запусков запроса -| SumDuration | Interval | | Общая длительность запросов -| MinDuration | Interval | | Минимальная длительность запроса -| MaxDuration | Interval | | Максимальная длительность запроса -| SumCPUTime | Uint64 | | Общее затраченное процессорное время -| MinCPUTime | Uint64 | | Минимальное затраченное процессорное время -| MaxCPUTime | Uint64 | | Максимальное затраченное процессорное время -| SumReadRows | Uint64 | | Общее количество прочитанных строк -| MinReadRows | Uint64 | | Минимальное количество прочитанных строк -| MaxReadRows | Uint64 | | Максимальное количество прочитанных строк -| SumReadBytes | Uint64 | | Общее количество прочитанных байт -| MinReadBytes | Uint64 | | Минимальное количество прочитанных байт -| MaxReadBytes | Uint64 | | Максимальное количество прочитанных байт -| SumUpdateRows | Uint64 | | Общее количество записанных строк -| MinUpdateRows | Uint64 | | Минимальное количество записанных строк -| MaxUpdateRows | Uint64 | | Максимальное количество записанных строк -| SumUpdateBytes | Uint64 | | Общее количество записанных байт -| MinUpdateBytes | Uint64 | | Минимальное количество записанных байт -| MaxUpdateBytes | Uint64 | | Максимальное количество записанных байт -| SumDeleteRows | Uint64 | | Общее количество удалённых строк -| MinDeleteRows | Uint64 | | Минимальное количество удалённых строк -| MaxDeleteRows | Uint64 | | Максимальное количество удалённых строк -| SumRequestUnits | Uint64 | | Общее количество использованных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options) -| MinRequestUnits | Uint64 | | Минимальное количество использованных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options) -| MaxRequestUnits | Uint64 | | Максимальное количество использованных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options) +Каждая строка таблицы содержит информацию о множестве случившихся за интервал запросов с одинаковым текстом. Поля таблицы предоставляют минимальное, максимальное и суммарное значение по каждой отслеживаемой характеристике запроса. В пределах интервала запросы отсортированы по убыванию суммарного потраченного процессорного времени. Ограничения: * текст запроса ограничен 4 килобайтами; -* таблица содержит историю за последние 6 часов; -* в пределах интервала представлена информация о не более чем 256 различных запросах; -* статистика может быть неполной, если база испытывает сильную нагрузку +* статистика может быть неполной, если база испытывает сильную нагрузку. + +Структура таблицы: + +Поле | Описание +---|--- +`IntervalEnd` | Момент закрытия минутного интервала.<br>Тип: `Timestamp`.<br>Ключ: `0`. +`Rank` | Ранг запроса в пределах интервала (по полю SumCPUTime).<br>Тип: `Uint32`.<br>Ключ: `1`. +`QueryText` | Текст запроса.<br>Тип: `Utf8`. +`Count` | Количество запусков запроса.<br>Тип: `Uint64`. +`SumDuration` | Общая длительность запросов.<br>Тип: `Interval`. +`Count` | Количество запусков запроса.<br>Тип: `Uint64`. +`SumDuration` | Общая длительность запросов.<br>Тип: `Interval`. +`MinDuration` | Минимальная длительность запроса.<br>Тип: `Interval`. +`MaxDuration` | Максимальная длительность запроса.<br>Тип: `Interval`. +`SumCPUTime` | Общее затраченное процессорное время.<br>Тип: `Uint64`. +`MinCPUTime` | Минимальное затраченное процессорное время.<br>Тип: `Uint64`. +`MaxCPUTime` | Максимальное затраченное процессорное время.<br>Тип: `Uint64`. +`SumReadRows` | Общее количество прочитанных строк.<br>Тип: `Uint64`. +`MinReadRows` | Минимальное количество прочитанных строк.<br>Тип: `Uint64`. +`MaxReadRows` | Максимальное количество прочитанных строк.<br>Тип: `Uint64`. +`SumReadBytes` | Общее количество прочитанных байт.<br>Тип: `Uint64`. +`MinReadBytes` | Минимальное количество прочитанных байт.<br>Тип: `Uint64`. +`MaxReadBytes` | Максимальное количество прочитанных байт.<br>Тип: `Uint64`. +`SumUpdateRows` | Общее количество записанных строк.<br>Тип: `Uint64`. +`MinUpdateRows` | Минимальное количество записанных строк.<br>Тип: `Uint64`. +`MaxUpdateRows` | Максимальное количество записанных строк.<br>Тип: `Uint64`. +`SumUpdateBytes` | Общее количество записанных байт.<br>Тип: `Uint64`. +`MinUpdateBytes` | Минимальное количество записанных байт.<br>Тип: `Uint64`. +`MaxUpdateBytes` | Максимальное количество записанных байт.<br>Тип: `Uint64`. +`SumDeleteRows` | Общее количество удалённых строк.<br>Тип: `Uint64`. +`MinDeleteRows` | Минимальное количество удалённых строк.<br>Тип: `Uint64`. +`MaxDeleteRows` | Максимальное количество удалённых строк.<br>Тип: `Uint64`. +`SumRequestUnits` | Общее количество использованных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options).<br>Тип: `Uint64`. +`MinRequestUnits` | Минимальное количество использованных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options).<br>Тип: `Uint64`. +`MaxRequestUnits` | Максимальное количество использованных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options).<br>Тип: `Uint64`. + diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_example_yql.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_example_yql.md index cf2957ef11..ba6c6dd68e 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_example_yql.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_example_yql.md @@ -1,30 +1,30 @@ - Топ запросов по времени выполнения за последнюю минуту, когда случались запросы + Топ запросов по времени выполнения за последнюю минуту их отправки: - ```sql - PRAGMA AnsiInForEmptyOrNullableItemsCollections; - $last = ( - SELECT - MAX(IntervalEnd) - FROM `.sys/top_queries_by_duration_one_minute` - ); - SELECT - IntervalEnd, - Rank, - QueryText, - Duration - FROM `.sys/top_queries_by_duration_one_minute` - WHERE IntervalEnd IN $last - ``` + > ```sql + > PRAGMA AnsiInForEmptyOrNullableItemsCollections; + > $last = ( + > SELECT + > MAX(IntervalEnd) + > FROM `.sys/top_queries_by_duration_one_minute` + > ); + > SELECT + > IntervalEnd, + > Rank, + > QueryText, + > Duration + > FROM `.sys/top_queries_by_duration_one_minute` + > WHERE IntervalEnd IN $last + > ``` - Запросы, прочитавшие больше всего байт, в разбивке по минутам + Запросы, прочитавшие больше всего байт, в разбивке по минутам: - ```sql - SELECT - IntervalEnd, - QueryText, - ReadBytes, - ReadRows, - Partitions - FROM `.sys/top_queries_by_read_bytes_one_minute` - WHERE Rank = 1 - ```
\ No newline at end of file + > ```sql + > SELECT + > IntervalEnd, + > QueryText, + > ReadBytes, + > ReadRows, + > Partitions + > FROM `.sys/top_queries_by_read_bytes_one_minute` + > WHERE Rank = 1 + > ```
\ No newline at end of file diff --git a/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_header.md b/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_header.md index 98151b00d6..65050989ee 100644 --- a/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_header.md +++ b/ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_header.md @@ -1,54 +1,50 @@ ## Топы запросов {#top-queries} -* **top_queries_by_duration_one_minute** -* **top_queries_by_duration_one_hour** -* **top_queries_by_read_bytes_one_minute** -* **top_queries_by_read_bytes_one_hour** -* **top_queries_by_cpu_time_one_minute** -* **top_queries_by_cpu_time_one_hour** +Следующие системные таблицы хранят данные для анализа потока пользовательских запросов: -Группа системных таблиц для анализа потока пользовательских запросов. Таблицы позволяют видеть ограниченную по времени историю запросов, разбитую на интервалы. В пределах одного интервала времени сохраняется топ-5 запросов по определённой характеристике. В настоящее время доступны минутные и часовые интервалы, а топ может быть построен по полному времени исполнения запроса (самые медленные), по количеству прочитанных из таблицы байт (самые широкие) и по общему затраченному процессорному времени (самые тяжёлые). +* `top_queries_by_duration_one_minute` — данные разбиты на минутные интервалы, содержит топ-5 запросов с наибольшим полным временем исполнения за последние 6 часов; +* `top_queries_by_duration_one_hour` — данные разбиты на часовые интервалы, содержит топ-5 запросов с наибольшим полным временем исполнения за последние 2 недели; +* `top_queries_by_read_bytes_one_minute` — данные разбиты на минутные интервалы, содержит топ-5 запросов с наибольшим количеством прочитанных из таблицы байт за последние 6 часов; +* `top_queries_by_read_bytes_one_hour` — данные разбиты на часовые интервалы, содержит топ-5 запросов с наибольшим количеством прочитанных из таблицы байт за последние 2 недели; +* `top_queries_by_cpu_time_one_minute` — данные разбиты на минутные интервалы, содержит топ-5 запросов с наибольшим затраченным процессорным временем за последние 6 часов; +* ` top_queries_by_cpu_time_one_hour` — данные разбиты на часовые интервалы, содержит топ-5 запросов с наибольшим затраченным процессорным временем за последние 2 недели. Различные запуски запроса с одним и тем же текстом дедуплицируются. Топ содержит информацию о конкретном запуске с максимальным значением соответствующей характеристики запроса в пределах одного временного интервала. -Поля, предоставляющие информацию о затраченном процессорном времени (...CPUTime), выражены в микросекундах. - -Структура таблиц: - -| **Поле** | **Тип** | **Ключ** | **Значение** | -|---|---|---|---| -| IntervalEnd | Timestamp | 0 | Момент закрытия минутного или часового интервала -| Rank | Uint32 | 1 | Ранг запроса в топе -| RequestUnits | Uint64 | | Количество затраченных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options) -| QueryText | Utf8 | | Текст запроса -| Duration | Interval | | Полное время исполнения запроса -| EndTime | Timestamp | | Момент окончания исполнения запроса -| Type | String | | Тип запроса ("data", "scan", "script") -| ReadRows | Uint64 | | Количество прочитанных строк -| ReadBytes | Uint64 | | Количество прочитанных байт -| UpdateRows | Uint64 | | Количество записанных строк -| UpdateBytes | Uint64 | | Количество записанных байт -| DeleteRows | Uint64 | | Количество удалённых строк -| DeleteBytes | Uint64 | | Количество удалённых байт -| Partitions | Uint64 | | Количество партиций таблиц, участвовавших в исполнении запроса -| UserSID | String | | Security ID пользователя -| ParametersSize | Uint64 | | Размер параметров запроса в байтах -| CompileDuration | Interval | | Длительность компиляции запроса -| FromQueryCache | Bool | | Использовался ли кэш подготовленных запросов -| CPUTime | Uint64 | | Общее процессорное время, использованное для исполнения запроса (микросекунды) -| ShardCount | Uint64 | | Количество шардов, участвующих в исполнении запроса -| SumShardCPUTime | Uint64 | | Общее процессорное время, затраченное в шардах -| MinShardCPUTime | Uint64 | | Минимальное процесорное время, затраченное в шардах -| MaxShardCPUTime | Uint64 | | Максимальное процессорное время, затраченное в шардах -| ComputeNodesCount | Uint64 | | Количество вычислительных нод, задействованных в исполнении запроса -| SumComputeCPUTime | Uint64 | | Общее процессорное время, затраченное в вычислительных нодах -| MinComputeCPUTime | Uint64 | | Минимальное процессорное время, затраченное в вычислительных нодах -| MaxComputeCPUTime | Uint64 | | Максимальное процессорное время, затраченное в вычислительных нодах -| CompileCPUTime | Uint64 | | Процессорное время, затраченное на компиляцию запроса -| ProcessCPUTime | Uint64 | | Процессорное время, затраченное на общую обработку запроса - -Ограничения: - -* текст запроса ограничен 4 килобайтами; -* таблицы с поминутными интервалами содержат историю за последние 6 часов; -* таблицы c почасовыми интервалами содержат историю за последние 2 недели +Поля, предоставляющие информацию о затраченном процессорном времени (...`CPUTime`), выражены в микросекундах. + +Текст запроса ограничен 4 килобайтами. + +Все таблицы содержат одинаковый набор полей: + +Поле | Описание +--- | --- +`IntervalEnd` | Момент закрытия минутного или часового интервала.<br>Тип: `Timestamp`.<br>Ключ: `0`. +`Rank` | Ранг запроса в топе.<br>Тип: `Uint32`.<br>Ключ: `1`. +`RequestUnits` | Количество затраченных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options) +`QueryText` | Текст запроса.<br>Тип: `Utf8`. +`Duration` | Полное время исполнения запроса.<br>Тип: `Interval`. +`EndTime` | Момент окончания исполнения запроса. <br>Тип: `Timestamp`. +`Type` | Тип запроса ("data", "scan", "script").<br>Тип: `String`. +`ReadRows` | Количество прочитанных строк.<br>Тип: `Uint64`. +`ReadBytes` | Количество прочитанных байт.<br>Тип: `Uint64`. +`UpdateRows` | Количество записанных строк.<br>Тип: `Uint64`. +`UpdateBytes` | Количество записанных байт.<br>Тип: `Uint64`. +`DeleteRows` | Количество удалённых строк.<br>Тип: `Uint64`. +`DeleteBytes` | Количество удалённых байт.<br>Тип: `Uint64`. +`Partitions` | Количество партиций таблиц, участвовавших в исполнении запроса.<br>Тип: `Uint64`. +`UserSID` | Security ID пользователя.<br>Тип: `String`. +`ParametersSize` | Размер параметров запроса в байтах.<br>Тип: `Uint64`. +`CompileDuration` | Длительность компиляции запроса.<br>Тип: `Interval`. +`FromQueryCache` | Использовался ли кэш подготовленных запросов.<br>Тип: `Bool`. +`CPUTime` | Общее процессорное время, использованное для исполнения запроса (микросекунды).<br>Тип: `Uint64`. +`ShardCount` | Количество шардов, участвующих в исполнении запроса.<br>Тип: `Uint64`. +`SumShardCPUTime` | Общее процессорное время, затраченное в шардах.<br>Тип: `Uint64`. +`MinShardCPUTime` | Минимальное процесорное время, затраченное в шардах.<br>Тип: `Uint64`. +`MaxShardCPUTime` | Максимальное процессорное время, затраченное в шардах.<br>Тип: `Uint64`. +`ComputeNodesCount` | Количество вычислительных нод, задействованных в исполнении запроса.<br>Тип: `Uint64`. +`SumComputeCPUTime` | Общее процессорное время, затраченное в вычислительных нодах.<br>Тип: `Uint64`. +`MinComputeCPUTime` | Минимальное процессорное время, затраченное в вычислительных нодах.<br>Тип: `Uint64`. +`MaxComputeCPUTime` | Максимальное процессорное время, затраченное в вычислительных нодах.<br>Тип: `Uint64`. +`CompileCPUTime` | Процессорное время, затраченное на компиляцию запроса.<br>Тип: `Uint64`. +`ProcessCPUTime` | Процессорное время, затраченное на общую обработку запроса.<br>Тип: `Uint64`. diff --git a/ydb/docs/ru/core/troubleshooting/system_views_db.md b/ydb/docs/ru/core/troubleshooting/system_views_db.md index f111ba0dc4..0c8c26a759 100644 --- a/ydb/docs/ru/core/troubleshooting/system_views_db.md +++ b/ydb/docs/ru/core/troubleshooting/system_views_db.md @@ -7,5 +7,3 @@ {% include [query_metrics.md](_includes/system_views/query_metrics.md) %} {% include [top-overload-partitions.md](_includes/system_views/top-overload-partitions.md) %} - -{% include [notes.md](_includes/system_views/notes.md) %} |