Skip to content

Commit 6c17bb8

Browse files
Sysview is renamed in doc (#12357)
Co-authored-by: anton-bobkov <anton-bobkov@ydb.tech>
1 parent 28f35f7 commit 6c17bb8

File tree

9 files changed

+65
-37
lines changed

9 files changed

+65
-37
lines changed

ydb/docs/en/core/concepts/glossary.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,20 @@ A **column family** or **column group** is a feature that allows storing a subse
165165

166166
**Time to live** or **TTL** is a mechanism for automatically removing old rows from a table asynchronously in the background. It is explained in a separate article [{#T}](ttl.md).
167167

168+
### View {#view}
169+
170+
A **view** logically represents a table formed by a given query. The view itself contains no data. The content of a view is generated every time you SELECT from it. Thus, any changes in the underlying tables are reflected immediately in the view.
171+
172+
There are user-defined and system-defined views.
173+
174+
#### User-defined view {#user-view}
175+
176+
A **user-defined view** is created by a user with the [{#T}](../yql/reference/syntax/create-view.md) statement. For more information, see [{#T}](../concepts/datamodel/view.md).
177+
178+
#### System view {#system-view}
179+
180+
A **system view** is for monitoring the DB status. System views are located in the .sys directory in the root of the database tree. It is explained in a separate article [{#T}](../dev/system-views.md).
181+
168182
### Topic {#topic}
169183

170184
A **topic** is a persistent queue that can be used for reliable asynchronous communications between various systems via message passing. {{ ydb-short-name }} provides the infrastructure to ensure "exactly once" semantics in such communications, which ensures that there are both no lost messages and no accidental duplicates.

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

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

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/concepts/glossary.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,20 @@
159159

160160
**Время жизни**, **time to live** или **TTL** — это механизм для автоматического удаления старых строк из таблицы асинхронно в фоновом режиме. Он описан в отдельной статье [{#T}](ttl.md).
161161

162+
### Представление {#view}
163+
164+
**Представление** или **view** — это способ сохранить запрос и обращаться к его результатам как к настоящей таблице. Само представление не хранит данных, кроме текста запроса. Запрос, хранящийся в представлении, выполняется при каждом SELECT из него, генерируя возвращаемый результат. Любые изменения в таблицах, на которые ссылается представление, немедленно отражаются в результатах чтения из него.
165+
166+
Представления бывают пользовательские и системные.
167+
168+
#### Пользовательские представления {#user-view}
169+
170+
**Пользовательские представления** создаются пользователем с помощью команды [{#T}](../yql/reference/syntax/create-view.md). Они описаны более подробно в [{#T}](../concepts/datamodel/view.md).
171+
172+
#### Системные представления {#system-view}
173+
174+
**Системные представления** предназначены для отслеживания состояния базы данных. Эти таблицы доступны из корня дерева базы данных и используют системный префикс пути `.sys`. Они описаны более подробно в [{#T}](../dev/system-views.md).
175+
162176
### Топик {#topic}
163177

164178
**Очередь сообщений** используется для надёжной асинхронной связи между различными системами посредством передачи сообщений. {{ ydb-short-name }} предоставляет инфраструктуру, обеспечивающую семантику "exactly once" (ровно один раз) в таких коммуникациях. С её использованием можно добиться гарантии отсутствия потерянных сообщений и случайных дубликатов.
@@ -596,4 +610,4 @@ MiniKQL — это язык низкого уровня. Конечные пол
596610

597611
### KiKiMR {#kikimr}
598612

599-
**KiKiMR** — это устаревшее название {{ ydb-short-name }}, использовавшееся до того, как он стал [продуктом с открытым исходным кодом](https://github.com/ydb-platform/ydb) (open source). Оно всё ещё может встречаться в исходном коде, старых статьях и видео и т.д.
613+
**KiKiMR** — это устаревшее название {{ ydb-short-name }}, использовавшееся до того, как он стал [продуктом с открытым исходным кодом](https://github.com/ydb-platform/ydb) (open source). Оно всё ещё может встречаться в исходном коде, старых статьях и видео и т.д.

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

0 commit comments

Comments
 (0)