aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAidar Samerkhanov <aidarsamer@yandex-team.ru>2022-03-15 19:31:18 +0300
committerAidar Samerkhanov <aidarsamer@yandex-team.ru>2022-03-15 19:31:18 +0300
commitf6fab8fcc19536ea62e2838ed6e45b1a96348d8f (patch)
tree23d112226d050fd4aee1a155a78aaf1337bb31ed
parent1f6055c82d8fe1111236baad5219e8213625193f (diff)
downloadydb-f6fab8fcc19536ea62e2838ed6e45b1a96348d8f.tar.gz
KIKIMR-14342. Add missed column and fix paths in sys views doc.
KIKIMR-14342. Add missed columns to sys views doc. Fix paths in FROM statements in sys views doc. ref:67e9b601c189fedeaac681f031c85fc9a81223b8
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_example_yql.md4
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/partitions_header.md8
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_example_yql.md4
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/query_metrics_header.md5
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_example_yql.md7
-rw-r--r--ydb/docs/ru/core/troubleshooting/_includes/system_views/tops_header.md2
6 files changed, 18 insertions, 12 deletions
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 19e0e7eb55c..432e1cf0c14 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
@@ -4,7 +4,7 @@
Path,
PartIdx,
CPUCores
- FROM `/cluster/path/to/database/.sys/partition_stats`
+ FROM `.sys/partition_stats`
ORDER BY CPUCores DESC
LIMIT 5
```
@@ -17,6 +17,6 @@
SUM(RowCount) as Rows,
SUM(DataSize) as Size,
SUM(CPUCores) as CPU
- FROM `/cluster/path/to/database/.sys/partition_stats`
+ 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 8dde46ff350..f5bdf868a60 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
@@ -2,14 +2,14 @@
* **partition_stats**
-Системная таблица, предоставляющая детализированную информацию об отдельных партициях всех таблиц базы данных. Содержит информацию о моментальных метриках, таких как нагрузка на CPU или количество транзакций в полёте, а также кумулятивные счётчики операций различного характера над партицией (например, общее количество прочитанных строк). Предназначена в первую очередь для выявления различных неравномерностей в нагрузке на партицию таблицы или размерах данных партиции таблицы.
+Системная таблица, предоставляющая детализированную информацию об отдельных партициях всех таблиц базы данных. Содержит информацию о моментальных метриках, таких как нагрузка на CPU или количество транзакций, находящихся в процессе исполнения, а также кумулятивные счётчики операций различного характера над партицией (например, общее количество прочитанных строк). Предназначена в первую очередь для выявления различных неравномерностей в нагрузке на партицию таблицы или размерах данных партиции таблицы.
Структура таблицы:
| **Поле** | **Тип** | **Ключ** | **Значение** |
|---|---|---|---|
-| OwnerId | Uint64 | 0 | Идентификатор скимшарда, обслуживающего таблицу
-| PathId | Uint64 | 1 | Идентификатор пути в скимшарде
+| OwnerId | Uint64 | 0 | Идентификатор SchemeShard, обслуживающего таблицу
+| PathId | Uint64 | 1 | Идентификатор пути в SchemeShard
| PartIdx | Uint64 | 2 | Порядковый номер партиции
| DataSize | Uint64 | | Приблизительный размер партиции в байтах
| RowCount | Uint64 | | Приблизительное количество строк
@@ -26,7 +26,7 @@
| RowDeletes | Uint64 | | Количество удалённых строк с момента старта
| RangeReads | Uint64 | | Количество чтений диапазонов строк с момента старта
| RangeReadRows | Uint64 | | Количество строк, прочитанных в диапазонах с момента старта
-| InFlightTxCount | Uint64 | | Количество транзакций к партиции в моменте
+| InFlightTxCount | Uint64 | | Количество транзакций, находящихся в процессе исполнения
| ImmediateTxCompleted | Uint64 | | Количество завершившихся одношардовых транзакций с момента старта
| CoordinatedTxCompleted | Uint64 | | Количество завершившихся координируемых транзакций с момента старта
| TxRejectedByOverload | 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 934fb2b6d8d..ba8eb803b25 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
@@ -6,7 +6,7 @@
Count,
QueryText,
IntervalEnd
- FROM `/cluster/path/to/database/.sys/query_metrics_one_minute`
+ FROM `.sys/query_metrics_one_minute`
ORDER BY SumUpdateRows DESC LIMIT 10
```
@@ -20,7 +20,7 @@
SumReadBytes / Count as AvgReadBytes,
MaxReadBytes,
QueryText
- FROM `/cluster/path/to/database/.sys/query_metrics_one_minute`
+ FROM `.sys/query_metrics_one_minute`
WHERE SumReadBytes > 0
ORDER BY IntervalEnd DESC, SumReadBytes DESC
LIMIT 100
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 345aac8aa00..a15f4aaf9b3 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
@@ -8,7 +8,7 @@
| **Поле** | **Тип** | **Ключ** | **Значение** |
|---|---|---|---|
-| IntervalEnd | Timestamp | 0 | Момент закрытия минутного или часового интервала
+| IntervalEnd | Timestamp | 0 | Момент закрытия минутного интервала
| Rank | Uint32 | 1 | Ранг запроса в пределах интервала (по полю SumCPUTime)
| QueryText | Utf8 | | Текст запроса
| Count | Uint64 | | Количество запусков запроса
@@ -33,6 +33,9 @@
| 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)
Ограничения:
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 9b2ca3d1509..cf2957ef117 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,17 +1,18 @@
Топ запросов по времени выполнения за последнюю минуту, когда случались запросы
```sql
+ PRAGMA AnsiInForEmptyOrNullableItemsCollections;
$last = (
SELECT
MAX(IntervalEnd)
- FROM `/cluster/path/to/database/.sys/top_queries_by_duration_one_minute`
+ FROM `.sys/top_queries_by_duration_one_minute`
);
SELECT
IntervalEnd,
Rank,
QueryText,
Duration
- FROM `/cluster/path/to/database/.sys/top_queries_by_duration_one_minute`
+ FROM `.sys/top_queries_by_duration_one_minute`
WHERE IntervalEnd IN $last
```
@@ -24,6 +25,6 @@
ReadBytes,
ReadRows,
Partitions
- FROM `/cluster/path/to/database/.sys/top_queries_by_read_bytes_one_minute`
+ 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 e9cb0fee04f..edc49f50ac3 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
@@ -19,6 +19,7 @@
|---|---|---|---|
| IntervalEnd | Timestamp | 0 | Момент закрытия минутного или часового интервала
| Rank | Uint32 | 1 | Ранг запроса в топе
+| RequestUnits | Uint64 | | Количество затраченных [RequestUnits](../../../concepts/serverless_and_dedicated.md#serverless-options)
| QueryText | Utf8 | | Текст запроса
| Duration | Interval | | Полное время исполнения запроса
| EndTime | Timestamp | | Момент окончания исполнения запроса
@@ -28,6 +29,7 @@
| UpdateRows | Uint64 | | Количество записанных строк
| UpdateBytes | Uint64 | | Количество записанных байт
| DeleteRows | Uint64 | | Количество удалённых строк
+| DeleteBytes | Uint64 | | Количество удалённых байт
| Partitions | Uint64 | | Количество партиций таблиц, участвовавших в исполнении запроса
| UserSID | String | | Security ID пользователя
| ParametersSize | Uint64 | | Размер параметров запроса в байтах