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/en/core/concepts/glossary.md
+14Lines changed: 14 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -165,6 +165,20 @@ A **column family** or **column group** is a feature that allows storing a subse
165
165
166
166
**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).
167
167
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
+
168
182
### Topic {#topic}
169
183
170
184
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.
Copy file name to clipboardExpand all lines: ydb/docs/ru/core/concepts/glossary.md
+15-1Lines changed: 15 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -159,6 +159,20 @@
159
159
160
160
**Время жизни**, **time to live** или **TTL** — это механизм для автоматического удаления старых строк из таблицы асинхронно в фоновом режиме. Он описан в отдельной статье [{#T}](ttl.md).
161
161
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
+
162
176
### Топик {#topic}
163
177
164
178
**Очередь сообщений** используется для надёжной асинхронной связи между различными системами посредством передачи сообщений. {{ ydb-short-name }} предоставляет инфраструктуру, обеспечивающую семантику "exactly once" (ровно один раз) в таких коммуникациях. С её использованием можно добиться гарантии отсутствия потерянных сообщений и случайных дубликатов.
@@ -596,4 +610,4 @@ MiniKQL — это язык низкого уровня. Конечные пол
596
610
597
611
### KiKiMR {#kikimr}
598
612
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). Оно всё ещё может встречаться в исходном коде, старых статьях и видео и т.д.
Copy file name to clipboardExpand all lines: ydb/docs/ru/core/dev/system-views.md
+17-17Lines changed: 17 additions & 17 deletions
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 недели с разбиением по минутным интервалам:
0 commit comments