You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: ydb/docs/ru/core/dev/system-views.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
-
# Системные таблицы базы данных
1
+
# Системные представления базы данных
2
2
3
-
Вы можете отправлять запросы в специальные служебные таблицы (system views), чтобы следить за состоянием базы данных. Эти таблицы доступны из корня дерева базы данных и используют системный префикс пути `.sys`.
3
+
Вы можете отправлять запросы в специальные служебные представления (system views), чтобы следить за состоянием базы данных. Эти представления доступны из корня дерева базы данных и используют системный префикс пути `.sys`.
4
4
5
-
Индекс поля первичного ключа соответствующей таблицы содержится в описаниях доступных полей далее по тексту.
5
+
Индекс поля первичного ключа соответствующего представления содержится в описаниях доступных полей далее по тексту.
6
6
7
-
Системные таблицы содержат:
7
+
Системные представления содержат:
8
8
9
9
*[Детальные данные об отдельных партициях таблиц БД](#partitions).
10
10
*[Топы запросов по определенным характеристикам](#top-queries).
@@ -13,21 +13,21 @@
13
13
14
14
{% note info %}
15
15
16
-
Обращение к системным таблицам имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
16
+
Обращение к системным представлениям имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
17
17
18
18
{% endnote %}
19
19
20
20
## Партиции {#partitions}
21
21
22
-
Следующая системная таблица хранит детализированную информацию об отдельных [партициях](../concepts/datamodel/table.md#partitioning) всех таблиц базы данных:
22
+
Следующее системное представление хранит детализированную информацию об отдельных [партициях](../concepts/datamodel/table.md#partitioning) всех таблиц базы данных:
23
23
24
24
*`partition_stats` — cодержит информацию о моментальных метриках и кумулятивные счетчики операций. К первым относятся, например, данные о нагрузке на CPU или количестве выполняемых [транзакций](../concepts/transactions.md). Ко вторым — общее количество прочитанных строк.
25
25
26
26
Предназначена для выявления различных неравномерностей в нагрузке на партицию или отображения размера данных в ней.
27
27
28
28
Кумулятивные поля (`RowReads`, `RowUpdates` и т.д.) хранят накопленные значения с момента последнего старта таблетки, обслуживающей партицию.
29
29
30
-
Структура таблицы:
30
+
Структура представления:
31
31
32
32
Поле | Описание
33
33
--- | ---
@@ -84,7 +84,7 @@ GROUP BY Path
84
84
85
85
## Топы запросов {#top-queries}
86
86
87
-
Следующие системные таблицы хранят данные для анализа потока пользовательских запросов:
87
+
Следующие системные представления хранят данные для анализа потока пользовательских запросов:
88
88
89
89
*`top_queries_by_duration_one_minute` — данные разбиты на минутные интервалы, содержит топ-5 запросов с наибольшим полным временем исполнения за последние 6 часов;
90
90
*`top_queries_by_duration_one_hour` — данные разбиты на часовые интервалы, содержит топ-5 запросов с наибольшим полным временем исполнения за последние 2 недели;
@@ -99,7 +99,7 @@ GROUP BY Path
99
99
100
100
Текст запроса ограничен 4 килобайтами.
101
101
102
-
Все таблицы содержат одинаковый набор полей:
102
+
Все представления содержат одинаковый набор полей:
103
103
104
104
Поле | Описание
105
105
--- | ---
@@ -168,18 +168,18 @@ WHERE Rank = 1
168
168
169
169
## Подробная информация о запросах {#query-metrics}
170
170
171
-
Следующая системная таблица хранит подробную информацию о запросах:
171
+
Следующая системное представление хранит подробную информацию о запросах:
172
172
173
173
*`query_metrics_one_minute` — данные разбиты по минутным интервалам, содержит до 256 запросов за последние 6 часов.
174
174
175
-
Каждая строка таблицы содержит информацию о множестве случившихся за интервал запросов с одинаковым текстом. Поля таблицы предоставляют минимальное, максимальное и суммарное значение по каждой отслеживаемой характеристике запроса. В пределах интервала запросы отсортированы по убыванию суммарного потраченного процессорного времени.
175
+
Каждая строка представления содержит информацию о множестве случившихся за интервал запросов с одинаковым текстом. Поля представления предоставляют минимальное, максимальное и суммарное значение по каждой отслеживаемой характеристике запроса. В пределах интервала запросы отсортированы по убыванию суммарного потраченного процессорного времени.
176
176
177
177
Ограничения:
178
178
179
179
* текст запроса ограничен 4 килобайтами;
180
180
* статистика может быть неполной, если база испытывает сильную нагрузку.
181
181
182
-
Структура таблицы:
182
+
Структура представления:
183
183
184
184
Поле | Описание
185
185
---|---
@@ -243,14 +243,14 @@ LIMIT 100
243
243
244
244
## История перегруженных партиций {#top-overload-partitions}
245
245
246
-
Следующие системные таблицы хранят историю моментов высокой нагрузки на отдельные партиции таблиц БД:
246
+
Следующие системные представления хранят историю моментов высокой нагрузки на отдельные партиции таблиц БД:
247
247
248
248
*`top_partitions_one_minute` — данные разбиты на минутные интервалы, содержит историю за последние 6 часов;
249
249
*`top_partitions_one_hour` — данные разбиты на часовые интервалы, содержит историю за последние 2 недели.
250
250
251
-
В таблицы попадают партиции с пиковой нагрузкой более 70 % (`CPUCores` > 0,7). В пределах одного интервала партиции ранжированы по пиковому значению нагрузки.
251
+
В представления попадают партиции с пиковой нагрузкой более 70 % (`CPUCores` > 0,7). В пределах одного интервала партиции ранжированы по пиковому значению нагрузки.
252
252
253
-
Обе таблицы содержат одинаковый набор полей:
253
+
Оба представления содержат одинаковый набор полей:
254
254
255
255
Поле | Описание
256
256
--- | ---
@@ -268,7 +268,7 @@ LIMIT 100
268
268
269
269
### Примеры запросов
270
270
271
-
Следующий запрос выводит партиции с потреблением CPU более 70% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к таблице`.sys/top_partitions_one_minute`, которая содержит данные за последние 6 часов с разбиением по часовым интервалам:
271
+
Следующий запрос выводит партиции с потреблением CPU более 70% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к представлению`.sys/top_partitions_one_minute`, которая содержит данные за последние 6 часов с разбиением по часовым интервалам:
272
272
273
273
```yql
274
274
SELECT
@@ -285,7 +285,7 @@ ORDER BY IntervalEnd desc, CPUCores desc
285
285
286
286
*`"YYYY-MM-DDTHH:MM:SS.UUUUUUZ"` — время в зоне UTC 0 (`YYYY` — год, `MM` — месяц, `DD` — число, `hh` — часы, `mm` — минуты, `ss` — секунды, `uuuuuu` — микросекунды). Например, `"2023-01-26T13:00:00.000000Z"`.
287
287
288
-
Следующий запрос выводит партиции с потреблением CPU более 90% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к таблице`.sys/top_partitions_one_hour`, которая содержит данные за последние 2 недели с разбиением по минутным интервалам:
288
+
Следующий запрос выводит партиции с потреблением CPU более 90% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к представлению`.sys/top_partitions_one_hour`, которая содержит данные за последние 2 недели с разбиением по минутным интервалам:
Copy file name to clipboardExpand all lines: ydb/docs/ru/core/devops/manual/system-views.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,27 +1,27 @@
1
-
# Системные таблицы кластера
1
+
# Системные представления кластера
2
2
3
-
Для возможности внутренней интроспекции состояния кластера пользователю предоставляется возможность осуществлять запросы в специальные служебные таблицы (system views). Эти таблицы доступны из корневой директории кластера и используют системный префикс пути `.sys`.
3
+
Для возможности внутренней интроспекции состояния кластера пользователю предоставляется возможность осуществлять запросы в специальные служебные представления (system views). Эти представления доступны из корневой директории кластера и используют системный префикс пути `.sys`.
4
4
5
-
Пользователи облачных баз данных обычно не имеют доступа к системным таблицам кластера, так как за его поддержку и своевременную диагностику отвечает команда облака.
5
+
Пользователи облачных баз данных обычно не имеют доступа к системным представлениям кластера, так как за его поддержку и своевременную диагностику отвечает команда облака.
6
6
7
-
В описаниях доступных полей далее по тексту колонка **Ключ** содержит индекс поля первичного ключа соответствующей таблицы.
7
+
В описаниях доступных полей далее по тексту колонка **Ключ** содержит индекс поля первичного ключа соответствующего представления.
8
8
9
9
{% note info %}
10
10
11
-
Аналогичные системные таблицы существуют и для происходящего внутри конкретной базы данных, они описаны в [отдельной статье для DBA](../../dev/system-views.md).
11
+
Аналогичные системные представления существуют и для происходящего внутри конкретной базы данных, они описаны в [отдельной статье для DBA](../../dev/system-views.md).
12
12
13
13
{% endnote %}
14
14
15
15
## Distributed Storage
16
16
17
-
Информация о работе распределённого хранилища содержится в нескольких взаимосвязанных таблицах, каждая из которых отвечает за описание своей сущности, а именно:
17
+
Информация о работе распределённого хранилища содержится в нескольких взаимосвязанных представлениях, каждая из которых отвечает за описание своей сущности, а именно:
18
18
19
19
* PDisk
20
20
* VSlot
21
21
* Group
22
22
* Storage Pool
23
23
24
-
Кроме этого, есть отдельная таблица, которая показывает статистику использования количества групп в разных пулах хранилища и возможности роста этих пулов.
24
+
Кроме этого, есть отдельное представление, которая показывает статистику использования количества групп в разных пулах хранилища и возможности роста этих пулов.
25
25
26
26
### ds_pdisks
27
27
@@ -60,7 +60,7 @@
60
60
| Status | String || Состояние запущенного VDisk в данном VSlot (INIT_PENDING, REPLICATING, READY, ERROR) |
61
61
| Kind | String || Предустановленная настройка режима работы VDisk (Default, Log, ...) |
62
62
63
-
Стоит заметить, что кортеж (NodeId, PDiskId) формируют внешний ключ к таблице`ds_pdisks`, а (GroupId) -- к таблице`ds_groups`.
63
+
Стоит заметить, что кортеж (NodeId, PDiskId) формируют внешний ключ к представлению`ds_pdisks`, а (GroupId) -- к представлению`ds_groups`.
64
64
65
65
### ds_groups
66
66
@@ -80,7 +80,7 @@
80
80
| PutUserDataLatency | Interval || 90 процентиль времени выполнения запроса PutUserData |
81
81
| GetFastLatency | Interval || 90 процентиль времени выполнения запроса GetFast |
82
82
83
-
В данной таблице кортеж (BoxId, StoragePoolId) формирует внешний ключ к таблице`ds_storage_pools`.
83
+
В данном представлении кортеж (BoxId, StoragePoolId) формирует внешний ключ к представлению`ds_storage_pools`.
84
84
85
85
### ds_storage_pools
86
86
@@ -100,7 +100,7 @@
100
100
101
101
### ds_storage_stats
102
102
103
-
В отличие от других таблиц, показывающих физические сущности, таблица`ds_storage_stats` показывает агрегированную информацию о хранилище.
103
+
В отличие от других представлений, показывающих физические сущности, `ds_storage_stats` показывает агрегированную информацию о хранилище.
Обращение к системным таблицам имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
120
+
Обращение к системным представлениям имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
0 commit comments