scheme-object as a separate glossary entry

ydb-platform · Jan 15, 2025 · 11484ef · 11484ef
1 parent 7f15536
commit 11484ef
Show file tree

Hide file tree

Showing 4 changed files with 11 additions and 6 deletions.
diff --git a/ydb/docs/ru/core/concepts/datamodel/_includes/dir.md b/ydb/docs/ru/core/concepts/datamodel/_includes/dir.md
@@ -1,3 +1,3 @@
 # Директория
 
-Для удобства организации поддерживается создание [директорий](../../glossary.md#folder) по аналогии с файловой системой, то есть вся база состоит из дерева директорий, а таблицы и другие сущности находятся в листах этого дерева (аналогично файлам файловой системы). В одной директории могут быть несколько поддиректорий и несколько таблиц. Имена у сущностей внутри одной директории уникальны.
+Для удобства организации поддерживается создание [директорий](../../glossary.md#folder) по аналогии с файловой системой, то есть вся база состоит из дерева директорий, а [схемные объекты](../../glossary.md#scheme-object), например, таблицы, находятся в листах этого дерева. В одной директории могут быть несколько поддиректорий и несколько схемных объектов. Имена схемных объектов внутри одной директории уникальны.
diff --git a/ydb/docs/ru/core/concepts/glossary.md b/ydb/docs/ru/core/concepts/glossary.md
@@ -269,12 +269,17 @@
 
 **Секрет** или **secret** — это конфиденциальные метаданные, требующие особого обращения. Например, секреты могут использоваться в определениях [внешних источников данных](#external-data-source) и представляют собой такие сущности, как пароли и токены.
 
+### Объект схемы {#scheme-object}
+
+Схема базы данных состоит из **схемных объектов** или **объектов схемы**, которыми могут быть базы данных, [таблицы](#table) (включая [внешние таблицы](#external-table)), [топики](#topic), [папки](#folder) и т.д.
+
+Для удобства организации, схемные объекты образуют иерархию с помощью [папок](#folder).
+
 ### Папка {#folder}
 
-Как и в файловых системах, **папка**, **каталог**, **folder** или **directory** является контейнером для других сущностей.
-В случае {{ ydb-short-name }}, папки содержат **схемные объекты** или **объекты схемы**, которыми могут быть базы данных, [таблицы](#table) (включая [внешние таблицы](#external-table)), [топики](#topic), другие папки и т.д.
+Как и в файловых системах, **папка**, **каталог**, **folder** или **directory** является контейнером для [схемных объектов](#scheme-object).
 
-Папки организованы в иерархическую структуру, то есть могут содержать подпапки, и такая вложенность может быть произвольной глубины.
+Папки могут содержать подпапки и такая вложенность может быть произвольной глубины.
 
 ### Объект доступа {#access-object}
 

diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/scheme-describe.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/scheme-describe.md
@@ -1,6 +1,6 @@
 # Получение информации об объекте схемы
 
-Получите информацию об [объекте схемы](../../../../concepts/glossary.md#folder):
+Получите информацию об [объекте схемы](../../../../concepts/glossary.md#scheme-object):
 
 ```bash
 {{ ydb-cli }} scheme describe episodes --stats

diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/scheme-ls.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/scheme-ls.md
@@ -1,6 +1,6 @@
 # Список объектов
 
-Команда `scheme ls` позволяет получить список [схемных объектов](../../../../concepts/glossary.md#folder) в базе данных:
+Команда `scheme ls` позволяет получить список [схемных объектов](../../../../concepts/glossary.md#scheme-object) в базе данных:
 
 ```bash
 {{ ydb-cli }} [connection options] scheme ls [path] [-lR1]