aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorigorpopov1407 <igorpopov1407@yandex-team.com>2023-01-19 11:39:01 +0300
committerigorpopov1407 <igorpopov1407@yandex-team.com>2023-01-19 11:39:01 +0300
commitde33f7fc5e19916ec9c67ce6c739b07b7c90d589 (patch)
tree815858e668e81945bc141e4cf81d599d7fcdafbb
parent904aca748e104713e53a1a12c29a743ee05d6271 (diff)
downloadydb-de33f7fc5e19916ec9c67ce6c739b07b7c90d589.tar.gz
changed tables logic, rewrited intro and notes
Тикет: Таблицы приведены в соответствие с разделом «История перегруженных партиций», отредактированы разделы «Введение» и «Замечания».
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/intro_db.md8
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/notes.md5
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_example_yql.md44
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_header.md60
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_example_yql.md50
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_header.md77
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_example_yql.md54
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_header.md92
-rw-r--r--ydb/docs/ru/core/troubleshooting/system_views_db.md2
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) %}