Skip to content

Commit f26ad0d

Browse files
authored
Merge 2a7ab80 into cf4d487
2 parents cf4d487 + 2a7ab80 commit f26ad0d

File tree

7 files changed

+36
-36
lines changed

7 files changed

+36
-36
lines changed

ydb/docs/ru/core/changelog-server.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -288,4 +288,4 @@
288288
* Добавлена поддержка сжатия при экспорте данных в S3.
289289
* Добавлен audit log для DDL statements.
290290
* Поддержана аутентификация со статическими учетными данными.
291-
* Добавлены системные таблицы для диагностики производительности запросов.
291+
* Добавлены системные представления для диагностики производительности запросов.

ydb/docs/ru/core/concepts/_includes/scan_query.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111

1212
{% note info %}
1313

14-
Через интерфейс *Scan Queries* можно выполнять запросы к [системным таблицам](../../dev/system-views.md).
14+
Через интерфейс *Scan Queries* можно выполнять запросы к [системным представлениям](../../dev/system-views.md).
1515

1616
{% endnote %}
1717

ydb/docs/ru/core/dev/system-views.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# Системные таблицы базы данных
1+
# Системные представления базы данных
22

3-
Вы можете отправлять запросы в специальные служебные таблицы (system views), чтобы следить за состоянием базы данных. Эти таблицы доступны из корня дерева базы данных и используют системный префикс пути `.sys`.
3+
Вы можете отправлять запросы в специальные служебные представления (system views), чтобы следить за состоянием базы данных. Эти представления доступны из корня дерева базы данных и используют системный префикс пути `.sys`.
44

5-
Индекс поля первичного ключа соответствующей таблицы содержится в описаниях доступных полей далее по тексту.
5+
Индекс поля первичного ключа соответствующего представления содержится в описаниях доступных полей далее по тексту.
66

7-
Системные таблицы содержат:
7+
Системные представления содержат:
88

99
* [Детальные данные об отдельных партициях таблиц БД](#partitions).
1010
* [Топы запросов по определенным характеристикам](#top-queries).
@@ -13,21 +13,21 @@
1313

1414
{% note info %}
1515

16-
Обращение к системным таблицам имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
16+
Обращение к системным представлениям имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
1717

1818
{% endnote %}
1919

2020
## Партиции {#partitions}
2121

22-
Следующая системная таблица хранит детализированную информацию об отдельных [партициях](../concepts/datamodel/table.md#partitioning) всех таблиц базы данных:
22+
Следующее системное представление хранит детализированную информацию об отдельных [партициях](../concepts/datamodel/table.md#partitioning) всех таблиц базы данных:
2323

2424
* `partition_stats` — cодержит информацию о моментальных метриках и кумулятивные счетчики операций. К первым относятся, например, данные о нагрузке на CPU или количестве выполняемых [транзакций](../concepts/transactions.md). Ко вторым — общее количество прочитанных строк.
2525

2626
Предназначена для выявления различных неравномерностей в нагрузке на партицию или отображения размера данных в ней.
2727

2828
Кумулятивные поля (`RowReads`, `RowUpdates` и т.д.) хранят накопленные значения с момента последнего старта таблетки, обслуживающей партицию.
2929

30-
Структура таблицы:
30+
Структура представления:
3131

3232
Поле | Описание
3333
--- | ---
@@ -84,7 +84,7 @@ GROUP BY Path
8484

8585
## Топы запросов {#top-queries}
8686

87-
Следующие системные таблицы хранят данные для анализа потока пользовательских запросов:
87+
Следующие системные представления хранят данные для анализа потока пользовательских запросов:
8888

8989
* `top_queries_by_duration_one_minute` — данные разбиты на минутные интервалы, содержит топ-5 запросов с наибольшим полным временем исполнения за последние 6 часов;
9090
* `top_queries_by_duration_one_hour` — данные разбиты на часовые интервалы, содержит топ-5 запросов с наибольшим полным временем исполнения за последние 2 недели;
@@ -99,7 +99,7 @@ GROUP BY Path
9999

100100
Текст запроса ограничен 4 килобайтами.
101101

102-
Все таблицы содержат одинаковый набор полей:
102+
Все представления содержат одинаковый набор полей:
103103

104104
Поле | Описание
105105
--- | ---
@@ -168,18 +168,18 @@ WHERE Rank = 1
168168

169169
## Подробная информация о запросах {#query-metrics}
170170

171-
Следующая системная таблица хранит подробную информацию о запросах:
171+
Следующая системное представление хранит подробную информацию о запросах:
172172

173173
* `query_metrics_one_minute` — данные разбиты по минутным интервалам, содержит до 256 запросов за последние 6 часов.
174174

175-
Каждая строка таблицы содержит информацию о множестве случившихся за интервал запросов с одинаковым текстом. Поля таблицы предоставляют минимальное, максимальное и суммарное значение по каждой отслеживаемой характеристике запроса. В пределах интервала запросы отсортированы по убыванию суммарного потраченного процессорного времени.
175+
Каждая строка представления содержит информацию о множестве случившихся за интервал запросов с одинаковым текстом. Поля представления предоставляют минимальное, максимальное и суммарное значение по каждой отслеживаемой характеристике запроса. В пределах интервала запросы отсортированы по убыванию суммарного потраченного процессорного времени.
176176

177177
Ограничения:
178178

179179
* текст запроса ограничен 4 килобайтами;
180180
* статистика может быть неполной, если база испытывает сильную нагрузку.
181181

182-
Структура таблицы:
182+
Структура представления:
183183

184184
Поле | Описание
185185
---|---
@@ -243,14 +243,14 @@ LIMIT 100
243243

244244
## История перегруженных партиций {#top-overload-partitions}
245245

246-
Следующие системные таблицы хранят историю моментов высокой нагрузки на отдельные партиции таблиц БД:
246+
Следующие системные представления хранят историю моментов высокой нагрузки на отдельные партиции таблиц БД:
247247

248248
* `top_partitions_one_minute` — данные разбиты на минутные интервалы, содержит историю за последние 6 часов;
249249
* `top_partitions_one_hour` — данные разбиты на часовые интервалы, содержит историю за последние 2 недели.
250250

251-
В таблицы попадают партиции с пиковой нагрузкой более 70 % (`CPUCores` > 0,7). В пределах одного интервала партиции ранжированы по пиковому значению нагрузки.
251+
В представления попадают партиции с пиковой нагрузкой более 70 % (`CPUCores` > 0,7). В пределах одного интервала партиции ранжированы по пиковому значению нагрузки.
252252

253-
Обе таблицы содержат одинаковый набор полей:
253+
Оба представления содержат одинаковый набор полей:
254254

255255
Поле | Описание
256256
--- | ---
@@ -268,7 +268,7 @@ LIMIT 100
268268

269269
### Примеры запросов
270270

271-
Следующий запрос выводит партиции с потреблением CPU более 70% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к таблице `.sys/top_partitions_one_minute`, которая содержит данные за последние 6 часов с разбиением по часовым интервалам:
271+
Следующий запрос выводит партиции с потреблением CPU более 70% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к представлению `.sys/top_partitions_one_minute`, которая содержит данные за последние 6 часов с разбиением по часовым интервалам:
272272

273273
```yql
274274
SELECT
@@ -285,7 +285,7 @@ ORDER BY IntervalEnd desc, CPUCores desc
285285

286286
* `"YYYY-MM-DDTHH:MM:SS.UUUUUUZ"` — время в зоне UTC 0 (`YYYY` — год, `MM` — месяц, `DD` — число, `hh` — часы, `mm` — минуты, `ss` — секунды, `uuuuuu` — микросекунды). Например, `"2023-01-26T13:00:00.000000Z"`.
287287

288-
Следующий запрос выводит партиции с потреблением CPU более 90% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к таблице `.sys/top_partitions_one_hour`, которая содержит данные за последние 2 недели с разбиением по минутным интервалам:
288+
Следующий запрос выводит партиции с потреблением CPU более 90% в указанном интервале времени, с идентификаторами таблеток и их размерами на момент превышения. Запрос выполняется к представлению `.sys/top_partitions_one_hour`, которая содержит данные за последние 2 недели с разбиением по минутным интервалам:
289289

290290
```yql
291291
SELECT

ydb/docs/ru/core/dev/toc_p.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ items:
2626
href: paging.md
2727
- name: Таймауты
2828
href: timeouts.md
29-
- name: Системные таблицы
29+
- name: Системные представления
3030
href: system-views.md
3131
- name: Change Data Capture
3232
href: cdc.md

ydb/docs/ru/core/devops/manual/system-views.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,27 @@
1-
# Системные таблицы кластера
1+
# Системные представления кластера
22

3-
Для возможности внутренней интроспекции состояния кластера пользователю предоставляется возможность осуществлять запросы в специальные служебные таблицы (system views). Эти таблицы доступны из корневой директории кластера и используют системный префикс пути `.sys`.
3+
Для возможности внутренней интроспекции состояния кластера пользователю предоставляется возможность осуществлять запросы в специальные служебные представления (system views). Эти представления доступны из корневой директории кластера и используют системный префикс пути `.sys`.
44

5-
Пользователи облачных баз данных обычно не имеют доступа к системным таблицам кластера, так как за его поддержку и своевременную диагностику отвечает команда облака.
5+
Пользователи облачных баз данных обычно не имеют доступа к системным представлениям кластера, так как за его поддержку и своевременную диагностику отвечает команда облака.
66

7-
В описаниях доступных полей далее по тексту колонка **Ключ** содержит индекс поля первичного ключа соответствующей таблицы.
7+
В описаниях доступных полей далее по тексту колонка **Ключ** содержит индекс поля первичного ключа соответствующего представления.
88

99
{% note info %}
1010

11-
Аналогичные системные таблицы существуют и для происходящего внутри конкретной базы данных, они описаны в [отдельной статье для DBA](../../dev/system-views.md).
11+
Аналогичные системные представления существуют и для происходящего внутри конкретной базы данных, они описаны в [отдельной статье для DBA](../../dev/system-views.md).
1212

1313
{% endnote %}
1414

1515
## Distributed Storage
1616

17-
Информация о работе распределённого хранилища содержится в нескольких взаимосвязанных таблицах, каждая из которых отвечает за описание своей сущности, а именно:
17+
Информация о работе распределённого хранилища содержится в нескольких взаимосвязанных представлениях, каждая из которых отвечает за описание своей сущности, а именно:
1818

1919
* PDisk
2020
* VSlot
2121
* Group
2222
* Storage Pool
2323

24-
Кроме этого, есть отдельная таблица, которая показывает статистику использования количества групп в разных пулах хранилища и возможности роста этих пулов.
24+
Кроме этого, есть отдельное представление, которая показывает статистику использования количества групп в разных пулах хранилища и возможности роста этих пулов.
2525

2626
### ds_pdisks
2727

@@ -60,7 +60,7 @@
6060
| Status | String | | Состояние запущенного VDisk в данном VSlot (INIT_PENDING, REPLICATING, READY, ERROR) |
6161
| Kind | String | | Предустановленная настройка режима работы VDisk (Default, Log, ...) |
6262

63-
Стоит заметить, что кортеж (NodeId, PDiskId) формируют внешний ключ к таблице `ds_pdisks`, а (GroupId) -- к таблице `ds_groups`.
63+
Стоит заметить, что кортеж (NodeId, PDiskId) формируют внешний ключ к представлению `ds_pdisks`, а (GroupId) -- к представлению `ds_groups`.
6464

6565
### ds_groups
6666

@@ -80,7 +80,7 @@
8080
| PutUserDataLatency | Interval | | 90 процентиль времени выполнения запроса PutUserData |
8181
| GetFastLatency | Interval | | 90 процентиль времени выполнения запроса GetFast |
8282

83-
В данной таблице кортеж (BoxId, StoragePoolId) формирует внешний ключ к таблице `ds_storage_pools`.
83+
В данном представлении кортеж (BoxId, StoragePoolId) формирует внешний ключ к представлению `ds_storage_pools`.
8484

8585
### ds_storage_pools
8686

@@ -100,7 +100,7 @@
100100

101101
### ds_storage_stats
102102

103-
В отличие от других таблиц, показывающих физические сущности, таблица `ds_storage_stats` показывает агрегированную информацию о хранилище.
103+
В отличие от других представлений, показывающих физические сущности, `ds_storage_stats` показывает агрегированную информацию о хранилище.
104104

105105
| **Поле** | **Тип** | **Ключ** | **Значение** |
106106
|-------------------------|---------|----------|-------------------------------------------------------------------------------------------------|
@@ -117,6 +117,6 @@
117117

118118
{% note info %}
119119

120-
Обращение к системным таблицам имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
120+
Обращение к системным представлениям имеет скорее аналитический характер нагрузки. Частое обращение к ним в больших базах будет существенно расходовать системные ресурсы. Рекомендуемая нагрузка не более 1-2 RPS.
121121

122122
{% endnote %}

0 commit comments

Comments
 (0)