Browse Source

concepts/connect database location instead of name

concepts/connect database location instead of name

ref:096b6850a7d1b01bc3dfa6199c58b8b11d7db72e
alexv-smirnov 3 years ago
parent
commit
dd30791ade

+ 7 - 7
ydb/docs/ru/core/concepts/_includes/connect.md

@@ -6,7 +6,7 @@
 
 
 1. Эндпоинт
 1. Эндпоинт
 3. Аутентификационная информация
 3. Аутентификационная информация
-2. Имя базы данных
+2. Размещение базы данных
 
 
 ## Эндпоинт {#endpoint}
 ## Эндпоинт {#endpoint}
 
 
@@ -63,13 +63,13 @@
 
 
 При использовании режимов, предусматривающих обращение клиента YDB к IAM, дополнительно может быть задан URL IAM, предоставляющий API выдачи токенов. По-умолчанию в существующих SDK и CLI производится попытка обращения к API IAM Yandex.Cloud, размещенному на `iam.api.cloud.yandex.net:443`.
 При использовании режимов, предусматривающих обращение клиента YDB к IAM, дополнительно может быть задан URL IAM, предоставляющий API выдачи токенов. По-умолчанию в существующих SDK и CLI производится попытка обращения к API IAM Yandex.Cloud, размещенному на `iam.api.cloud.yandex.net:443`.
 
 
-## Имя базы данных {#database}
+## Размещение базы данных {#database}
 
 
-Имя базы данных (`database`) - строка, задающая базу данных, к которой адресован запрос. Имеет структуру [пути к файлу](https://ru.wikipedia.org/wiki/Путь_к_файлу), с использованием символа `/` в качестве разделителя. 
+Размещение базы данных (`database`) - строка, определяющая где на кластере YDB находится база данных, к которой адресован запрос. Имеет структуру [пути к файлу](https://ru.wikipedia.org/wiki/Путь_к_файлу), с использованием символа `/` в качестве разделителя. Начинается всегда с символа `/`.
 
 
-На кластере YDB может быть развернуто множество баз данных, и значения параметра `database` определяются конфигурацией кластера. Как и `endpoint`, для облачных баз данных имя `database` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика. В корпоративных окружениях имена YDB `database` предоставляются командой администраторов, или также могут быть получены в консоли управления внутренним облаком.
+На кластере YDB может быть развернуто множество баз данных, и их размещение определяется конфигурацией кластера. Как и эндпоинт, для облачных баз данных `database` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика.
 
 
-При использовании облачных решений базы данных на кластере YDB создаются и получают имена в режиме самообслуживания, не требуя участия владельца и администраторов кластера.
+При использовании облачных решений базы данных на кластере YDB создаются и размещаются в режиме самообслуживания, не требуя участия владельца и администраторов кластера.
 
 
 {% include [overlay/database.md](connect_overlay/database.md) %}
 {% include [overlay/database.md](connect_overlay/database.md) %}
 
 
@@ -85,9 +85,9 @@
 
 
 {% include [overlay/database_example.md](connect_overlay/database_example.md) %}
 {% include [overlay/database_example.md](connect_overlay/database_example.md) %}
 
 
-## Конфигурация аутентификации на клиенте
+## Конфигурация параметров соединения на клиенте
 
 
-В специализированных статьях описано как определять аутентификационные параметры:
+В специализированных статьях описано как определять параметры соединения на клиенте:
 
 
 * [Соединение с БД и аутентификация в YDB CLI](../../reference/ydb-cli/connect.md)
 * [Соединение с БД и аутентификация в YDB CLI](../../reference/ydb-cli/connect.md)
 * [Аутентификация в YDB SDK](../../reference/ydb-sdk/auth.md)
 * [Аутентификация в YDB SDK](../../reference/ydb-sdk/auth.md)

+ 3 - 3
ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md

@@ -9,7 +9,7 @@ YDB CLI определяет с какой БД необходимо соеди
 3. Переменных окружения
 3. Переменных окружения
 4. Активированного профиля
 4. Активированного профиля
 
 
-Для того чтобы YDB CLI инициировал соединения с БД, в результате исполнения данных шагов должен быть определен [Эндпоинт](../../../concepts/connect.md#endpoint) и [Имя базы данных](../../../concepts/connect.md#database).
+Для того чтобы YDB CLI попробовал соединиться с БД, в результате исполнения данных шагов должен быть определен [Эндпоинт](../../../concepts/connect.md#endpoint) и [Размещение базы данных](../../../concepts/connect.md#database).
 
 
 Если все шаги пройдены, но YDB CLI не определил режим аутентификации, то запросы будут отправляться на сервер YDB без добавления аутентификационных данных. Это может позволить успешно работать с локально развернутыми кластерами YDB, не требующими аутентификации. Для всех доступных по сети баз данных такие запросы будут отклонены сервером с выдачей ошибки аутентификации.
 Если все шаги пройдены, но YDB CLI не определил режим аутентификации, то запросы будут отправляться на сервер YDB без добавления аутентификационных данных. Это может позволить успешно работать с локально развернутыми кластерами YDB, не требующими аутентификации. Для всех доступных по сети баз данных такие запросы будут отклонены сервером с выдачей ошибки аутентификации.
 
 
@@ -24,7 +24,7 @@ YDB CLI определяет с какой БД необходимо соеди
 ```
 ```
 
 
 - `-e, --endpoint <endpoint>` : [Эндпоинт](../../../concepts/connect.md#endpoint) - основной параметр соединения, позволяющий найти сервер YDB в сети. Если порт не указан, применяется 2135. Если протокол не указан, то в публичных сборках YDB CLI применяется gRPCs (с шифрованием).
 - `-e, --endpoint <endpoint>` : [Эндпоинт](../../../concepts/connect.md#endpoint) - основной параметр соединения, позволяющий найти сервер YDB в сети. Если порт не указан, применяется 2135. Если протокол не указан, то в публичных сборках YDB CLI применяется gRPCs (с шифрованием).
-- `-d, --database <database>` : [Имя базы данных](../../../concepts/connect.md#database)
+- `-d, --database <database>` : [Размещение базы данных](../../../concepts/connect.md#database)
 
 
 {% include [auth/options.md](auth/options.md) %}
 {% include [auth/options.md](auth/options.md) %}
 
 
@@ -50,7 +50,7 @@ YDB CLI определяет с какой БД необходимо соеди
 
 
 Если все шаги из приведенных в [начале данной статьи](#start) пройдены, но не удалось определить [Эндпоинт](../../../concepts/connect.md#endpoint), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'endpoint'`.
 Если все шаги из приведенных в [начале данной статьи](#start) пройдены, но не удалось определить [Эндпоинт](../../../concepts/connect.md#endpoint), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'endpoint'`.
 
 
-Если все шаги из приведенных в [начале данной статьи](#start) пройдены, но не удалось определить [Имя базы данных](../../../concepts/connect.md#database), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'database'`.
+Если все шаги из приведенных в [начале данной статьи](#start) пройдены, но не удалось определить [Размещение базы данных](../../../concepts/connect.md#database), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'database'`.
 
 
 Если режим аутентификации определить удалось, но не удалось определить необходимые дополнительные параметры, то выполнение команды будет прервано с выдачей сообщения, описывающего проблему:
 Если режим аутентификации определить удалось, но не удалось определить необходимые дополнительные параметры, то выполнение команды будет прервано с выдачей сообщения, описывающего проблему: