diff options
author | Evgeniy Ivanov <eivanov89@yandex-team.ru> | 2022-02-22 23:21:54 +0300 |
---|---|---|
committer | Evgeniy Ivanov <eivanov89@yandex-team.ru> | 2022-02-22 23:21:54 +0300 |
commit | 908aecdeae722a47011b8a64f7b61ec152bfc1fa (patch) | |
tree | 9185746c474294a8e47414c218cec15b5cafc280 | |
parent | 31b86286f54e3940d5f130127a8745bfef3f2a38 (diff) | |
download | ydb-908aecdeae722a47011b8a64f7b61ec152bfc1fa.tar.gz |
KIKIMR-14345: fix typos in docs
ref:e97d1a3184369b1858c07feb26a682dd41f501f5
12 files changed, 31 insertions, 31 deletions
diff --git a/ydb/docs/ru/core/concepts/_includes/connect.md b/ydb/docs/ru/core/concepts/_includes/connect.md index d7e18572b44..90a3e7dffb6 100644 --- a/ydb/docs/ru/core/concepts/_includes/connect.md +++ b/ydb/docs/ru/core/concepts/_includes/connect.md @@ -16,7 +16,7 @@ Примеры: - `grpc://localhost:7135` - протокол обмена данными без шифрования (gRPC), сервер запущен на том же хосте что и клиент, принимает соединения на порту 7135 -- `grpcs://ydb.somecorp-int.ru` - протокол обмена данными с шифрованием (gRPCs), сервер запущен на хосте ydb.somecorp-int.ru в изолированной корпоративной интрасети компании "SomeCorp", принмимает соединения на порту YDB по-умолчанию 2135 +- `grpcs://ydb.somecorp-int.ru` - протокол обмена данными с шифрованием (gRPCs), сервер запущен на хосте ydb.somecorp-int.ru в изолированной корпоративной интрасети компании "SomeCorp", принмимает соединения на порту YDB по умолчанию 2135 - `grpcs://ydb.serverless.yandexcloud.net:2135` - протокол обмена данными с шифрованием (gRPCs), публичный сервер Serverless YDB Yandex.Cloud ydb.serverless.yandexcloud.net, порт 2135 {% include [overlay/endpoint_example.md](connect_overlay/endpoint_example.md) %} @@ -77,7 +77,7 @@ Примеры: - `/ru-central1/b1g8skpblkos03malf3s/etn01q5ko6sh271beftr` -- база данных Yandex.Cloud с идентификатором `etn01q3ko8sh271beftr` в облаке `b1g8skpbljhs03malf3s`, развернутая в регионе `ru-central1` -- `/local` -- база данных по-умолчанию при самостоятельном развертывании [с использованием Docker](../../getting_started/ydb_docker.md) +- `/local` -- база данных по умолчанию при самостоятельном развертывании [с использованием Docker](../../getting_started/ydb_docker.md) {% include [overlay/database_example.md](connect_overlay/database_example.md) %} diff --git a/ydb/docs/ru/core/concepts/_includes/datamodel/table.md b/ydb/docs/ru/core/concepts/_includes/datamodel/table.md index a765201b0dc..9976b64438b 100644 --- a/ydb/docs/ru/core/concepts/_includes/datamodel/table.md +++ b/ydb/docs/ru/core/concepts/_includes/datamodel/table.md @@ -33,14 +33,14 @@ YDB использует типы данных [YQL]{% if audience != "external" #### AUTO_PARTITIONING_BY_SIZE * Тип: Enum (`ENABLED`, `DISABLED`) -* Значение по-умолчанию: `ENABLED` +* Значение по умолчанию: `ENABLED` Режим автоматического партиционирования по размеру партиции. Если размер партиции превысил значение, заданное параметром [`AUTO_PARTITIONING_PARTITION_SIZE_MB`](#auto_partitioning_partition_size_mb), то она встает в очередь на разделение (split). Если суммарный размер двух или более соседних партиции меньше 50% от значения параметра [`AUTO_PARTITIONING_PARTITION_SIZE_MB`](#auto_partitioning_partition_size_mb), то они встают в очередь на объединение (merge). #### AUTO_PARTITIONING_BY_LOAD * Тип: Enum (`ENABLED`, `DISABLED`) -* Значение по-умолчанию: `DISABLED` +* Значение по умолчанию: `DISABLED` Режим автоматического партиционирования по нагрузке. Если в течение нескольких десятков секунд шард потребляет более 50% CPU, то он ставится в очередь на разделение (split). Если в течение часа суммарная нагрузка на два или более соседних шарда утилизировала менее 35% одного ядра CPU, то они ставятся в очередь на объединение (merge). @@ -51,28 +51,28 @@ YDB использует типы данных [YQL]{% if audience != "external" #### AUTO_PARTITIONING_PARTITION_SIZE_MB * Тип: Uint64 -* Значение по-умолчанию: 2000 MB ( 2ГБ ) +* Значение по умолчанию: 2000 MB ( 2ГБ ) Порог размера партиции в мегабайтах, при превышении которого шард будет разделён, имеет значение при включенном режиме [`AUTO_PARTITIONING_BY_SIZE`](#auto_partitioning_by_size). #### AUTO_PARTITIONING_MIN_PARTITIONS_COUNT * Тип: Uint64 -* Значение по-умолчанию: 1 +* Значение по умолчанию: 1 Объединение партиций (merge) производится только в том случае, если их фактическое количество превышает заданное этим параметром значение. При использовании режима автоматического партиционирования по нагрузке рекомендуется устанавливать отличное от 1 значение данного параметра, чтобы периодический спад нагрузки не приводил к снижению количества партиций ниже необходимого. #### AUTO_PARTITIONING_MAX_PARTITIONS_COUNT * Тип: Uint64 -* Значение по-умолчанию: 50 +* Значение по умолчанию: 50 Разделение партиций (split) производится только в том случае, если их количество не превышает заданное этим параметром значение. При любых включенных режимах автоматического партиционирования рекомендуется устанавливать осмысленное значение этого параметра, а также отслеживать приближение фактического количества партиций к нему, иначе рано или поздно партиции перестанут разделяться при росте данных или нагрузке, что приведет к сбою. #### UNIFORM_PARTITIONS * Тип: Uint64 -* Значение по-умолчанию: Не применимо +* Значение по умолчанию: Не применимо Количество партиций для равномерного начального разделения таблицы. Первая колонка первичного ключа должна иметь тип Uint64 или Uint32. Созданная таблица сразу будет разделена на указанное количество партиций. @@ -81,7 +81,7 @@ YDB использует типы данных [YQL]{% if audience != "external" #### PARTITION_AT_KEYS * Тип: Expression -* Значение по-умолчанию: Не применимо +* Значение по умолчанию: Не применимо Граничные значения ключей для начального разделения на партиции. Представляется списком граничных значений, разделенных запятыми и обрамленными в скобки. Каждое граничное значение может быть либо набором значений ключевых колонок (также разделенных запятыми и обрамленными в скобки), либо единичным значением, если указываются только значения первой ключевой колонки. Примеры: ```(100, 1000)```, ```((100, "abc"), (1000, "cde"))```. diff --git a/ydb/docs/ru/core/deploy/configuration/config.md b/ydb/docs/ru/core/deploy/configuration/config.md index 4ea58a8e936..fa9ef02b47d 100644 --- a/ydb/docs/ru/core/deploy/configuration/config.md +++ b/ydb/docs/ru/core/deploy/configuration/config.md @@ -73,7 +73,7 @@ hosts: В конфигурации хранилища необходимо указать имя типа хранилища и тип отказоустойчивости хранилища (`erasure`), который будет использоваться для инициализации хранилища баз данных. Также необходимо указать, каким типам дисков данный тип хранилища будет соответствовать. Доступны следующие схемы отказоустойчивости хранилища: -* Конфигурация `block-4-2` предполагает развертывание в 8 доменах отказа (по-умолчанию доменом отказа является стойках) и выдерживает отказ не более чем 2 доменов отказа. +* Конфигурация `block-4-2` предполагает развертывание в 8 доменах отказа (по умолчанию доменом отказа является стойках) и выдерживает отказ не более чем 2 доменов отказа. * Конфигурация `mirror-3-dc` предполагает развертывание в 3 ЦОД-ах, в каждом из которых располагается 3 домена отказоустойчивости и выдерживает отказ одного ЦОД-а и еще одного домена отказойстойчивости (стойки) * Конфигурация `none` не предполагает отказоустойчивости, но удобна для функционального тестирования. diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/auth/env_static.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/auth/env_static.md index c6f9a8d7a38..ad404660808 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/_includes/auth/env_static.md +++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/auth/env_static.md @@ -1 +1 @@ -- Иначе, если задано значение переменной окружения `YDB_USER` или `YDB_PASSWORD`, то используется режим аутентификации по логину и паролю. Логин считывается из переменной `YDB_USER`; если он не задан, то выдается ошибка `User password was provided without user name`. Пароль считывается из переменной `YDB_PASSWORD`; если она не задана, то в зависимости от наличия опции командной строки `--no-password` применяется либо пустой пароль, либо пароль будет запрошен интерактивно. +- Если задано значение переменной окружения `YDB_USER` или `YDB_PASSWORD`, то используется режим аутентификации по логину и паролю. Логин считывается из переменной `YDB_USER`; если он не задан, то выдается ошибка `User password was provided without user name`. Пароль считывается из переменной `YDB_PASSWORD`; если она не задана, то в зависимости от наличия опции командной строки `--no-password` применяется либо пустой пароль, либо пароль будет запрошен интерактивно. diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md index 85393c72aa5..b3214ef573e 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md +++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md @@ -1,8 +1,8 @@ # Соединение CLI с базой данных и аутентификация -Большинство команд YDB CLI относятся к операциям над базой данных YDB, и требуют соединения с ней для исполнения. +Большинство команд YDB CLI относится к операциям над базой данных YDB и требует соединения с ней для исполнения. -YDB CLI определяет с какой БД необходимо соединиться, и какой [режим аутентификации](../../../concepts/connect.md#auth-modes) использовать, из следующих источников (в порядке убывания приоритета): +YDB CLI определяет с какой БД необходимо соединиться и какой [режим аутентификации](../../../concepts/connect.md#auth-modes) использовать из следующих источников (в порядке убывания приоритета): 1. Командной строки 2. Профиля, выбранного опцией командной строки `--profile` @@ -36,7 +36,7 @@ YDB CLI определяет с какой БД необходимо соеди ## Параметры из переменных окружения {#env} -Если в командной строке не был явно указан профиль, или в нём не заданы отвечающие за аутентификацию параметры, то YDB CLI пытается определить режим и параметры аутентификации по окружению YDB CLI, по следующему алгоритму: +Если в командной строке не был явно указан профиль, или в нём не заданы отвечающие за аутентификацию параметры, то YDB CLI пытается определить режим и параметры аутентификации по окружению YDB CLI по следующему алгоритму: {% include [env.md](auth/env.md) %} @@ -48,9 +48,9 @@ YDB CLI определяет с какой БД необходимо соеди ### Ошибки до попытки установки соединения с БД -Если все шаги из приведенных в [начале данной статьи](#start) пройдены, но не удалось определить [Эндпоинт](../../../concepts/connect.md#endpoint), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'endpoint'`. +Если все шаги из приведенных в начале данной статьи пройдены, но не удалось определить [Эндпоинт](../../../concepts/connect.md#endpoint), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'endpoint'`. -Если все шаги из приведенных в [начале данной статьи](#start) пройдены, но не удалось определить [Размещение базы данных](../../../concepts/connect.md#database), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'database'`. +Если все шаги из приведенных в начале данной статьи пройдены, но не удалось определить [Размещение базы данных](../../../concepts/connect.md#database), то выполнение команды будет прервано с выдачей сообщения `Missing required option 'database'`. Если режим аутентификации определить удалось, но не удалось определить необходимые дополнительные параметры, то выполнение команды будет прервано с выдачей сообщения, описывающего проблему: @@ -66,4 +66,4 @@ YDB CLI определяет с какой БД необходимо соеди ## Проверка аутентификации {#whoami} -Сервисная команда YDB CLI [`discovery whoami`](../commands/discovery-whoami.md) позволяет проверить, под какой учетной записью вы фактически аутентифицировались на сервере.
\ No newline at end of file +Сервисная команда YDB CLI [`discovery whoami`](../commands/discovery-whoami.md) позволяет проверить, под какой учетной записью вы фактически аутентифицировались на сервере. diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md index fc22adb2f55..8c0988d9b81 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md +++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md @@ -4,7 +4,7 @@ Для того чтобы воспользоваться {{ ydb-short-name }} CLI, ознакомьтесь со статьей [Установка YDB CLI](../install.md). -При соединении с БД вам потребуется аутентифицироваться. Для первого соединения вы можете воспользоваться быстрым рецептом, приведенном в статье [Аутентификация](../../../getting_started/auth.md) в разделе "Начало работы". +При соединении с БД вам потребуется аутентифицироваться. Для первого соединения вы можете воспользоваться быстрым рецептом, приведенным в статье [Аутентификация](../../../getting_started/auth.md) в разделе "Начало работы". Полная информация об определении параметров соединения с БД и аутентификации приведена в статье [Соединение с БД и аутентификация YDB CLI](../connect.md) данного раздела. diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/restore.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/restore.md index f2554201a38..6f0906f1be8 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/restore.md +++ b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/restore.md @@ -21,7 +21,7 @@ Имя параметра | Описание параметра ---|--- -`-p`<br/>`--path` | Путь к директории или таблице, дамп которых нужно сделать.<br/>Значение по-умолчанию — `.`, будет сделан полный дамп БД. +`-p`<br/>`--path` | Путь к директории или таблице, дамп которых нужно сделать.<br/>Значение по умолчанию — `.`, будет сделан полный дамп БД. `-o`<br/>`--output` | Обязательный параметр.<br/>Путь на локальной файловой системе, по которому будут размещены объекты дампа. Директория для дампа не должна существовать, либо быть пустой. `--scheme-only` | Сделать дамп только схемы БД. Возможные значения:<br/><ul><li>`0` — нет;</li><li>`1` — да.</li>Значение по умолчанию — `0`. `--avoid-copy` | Избегать копирования. Возможные значения:<br/><ul><li>`0` — нет;</li><li>`1` — да.</li>Значение по умолчанию — `0`. diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md index 2351ccf92dd..f264ee9edda 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md +++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md @@ -6,8 +6,8 @@ Однако, данная простота может приводить к нежелательному поведению в дальнейшей работе, как только возникнет необходимость работы с несколькими базами данных: -- Активированный профиль применяется неявно, а значит, может примениться по-ошибке когда забыт какой-либо параметр соединения в командной строке. -- Активированный профиль применяется неявно, а значит, может примениться по-ошибке когда допущена описка в имени переменной окружения. +- Активированный профиль применяется неявно, а значит, может примениться по ошибке, когда забыт какой-либо параметр соединения в командной строке. +- Активированный профиль применяется неявно, а значит, может примениться по ошибке, когда допущена описка в имени переменной окружения. - Активированный профиль нельзя применять в скриптах, так как он сохраняется в файле, и его смена в одном окне терминала повлияет на все другие окна, возможно приведя к неожиданной смене БД посередине исполняемого в скрипте цикла. С момента как вам в первый раз потребуется соединиться с какой-либо новой БД, отличной от начальной, рекомендуется деактивировать профиль и всегда выбирать его явно опцией `--profile`. @@ -40,7 +40,7 @@ Please enter your numeric choice: - `1` завершает исполнение, активированным останется текущий активированный профиль. Он отмечен как `(active)` в списке существующих профилей, начинающемся с пункта 3. - `2` деактивирует текущий активированный профиль. Если никакой профиль ранее не был активирован, то ничего не изменится. -- `3` и далее -- активация выбранного профиля. Текущий активированный профиль отмечен как `(active)` +- `3` и далее — активация выбранного профиля. Текущий активированный профиль отмечен как `(active)` При успешной активации профиля исполнение завершается сообщением ``` text @@ -68,7 +68,7 @@ Activate profile "<profile_name>" to use by default? (current active profile is ## Деактивация профиля {#deactivate} -YDB CLI в настоящее время поддерживает деактивацию профиля только в интерактивном режиме, при вызове команды активации без указания профиля (выбор пункта `2` в описанной выше [команде активации](#activate)). +YDB CLI в настоящее время поддерживает деактивацию профиля только в интерактивном режиме при вызове команды активации без указания профиля (выбор пункта `2` в описанной выше [команде активации](#activate)). При необходимости вы можете использовать перенаправление ввода операционной системы для автоматического выбора опции `2` в интерактивном вводе: @@ -76,4 +76,4 @@ YDB CLI в настоящее время поддерживает деактив echo 2 | {{ ydb-cli }} config profile activate ``` -Работоспособность данного способа никак не гарантируется.
\ No newline at end of file +Работоспособность данного способа никак не гарантируется. diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md index 5f43beeb9f8..5ab0663c2e6 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md +++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md @@ -103,7 +103,7 @@ Please enter Path to service account key file (sa-key-file): ``` -1. На последнем шаге вам будет предложено активировать созданный профиль для использования по-умолчанию. Ответьте 'n' (Нет), пока вы не прочитали статью про [Активацию профиля и применение активированного профиля](../activate.md): +1. На последнем шаге вам будет предложено активировать созданный профиль для использования по умолчанию. Ответьте 'n' (Нет), пока вы не прочитали статью про [Активацию профиля и применение активированного профиля](../activate.md): ```text Activate profile "mydb1" to use by default? (current active profile is not set) y/n: n diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/index.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/index.md index 3260c7f11a7..f552ad82575 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/index.md +++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/index.md @@ -1,6 +1,6 @@ # Управление профилями -Профиль -- сохраненная локально именованная конфигурация параметров соединения с БД. Использование профилей позволяет переиспользовать данные о размещении БД и параметрах аутентификации, сделав вызовы CLI существенно короче: +Профиль — сохраненная локально именованная конфигурация параметров соединения с БД. Использование профилей позволяет переиспользовать данные о размещении БД и параметрах аутентификации, сделав вызовы CLI существенно короче: - Вызов команды `scheme ls` без профиля: ``` bash @@ -33,4 +33,4 @@ -
\ No newline at end of file + diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/lexer.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/lexer.md index 3bd229141f1..488f3ba57cf 100644 --- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/lexer.md +++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/lexer.md @@ -10,7 +10,7 @@ ## Режимы совместимости синтаксиса {#lexer-modes} Поддерживаются два режима совместимости синтаксиса: -* Расширенный C++ (по-умолчанию) +* Расширенный C++ (по умолчанию) * ANSI SQL Режим ANSI SQL включается с помощью специального комментария `--!ansi-lexer`, который должен стоять в начале {% if feature_mapreduce %}программы{% else %}запроса{% endif %}. @@ -30,7 +30,7 @@ SELECT 1; -- A single-line comment Some multi-line comment */ ``` -В режиме совместимости синтаксиса C++ (по-умолчанию) многострочный комментарий заканчивается на _ближайшей_ последовательности символов `*/`. +В режиме совместимости синтаксиса C++ (по умолчанию) многострочный комментарий заканчивается на _ближайшей_ последовательности символов `*/`. В режиме совместимости синтаксиса ANSI SQL учитывается вложенность многострочных комментариев: ``` sql @@ -84,7 +84,7 @@ SELECT 1 as "column with "" double quoute"; -- имя колонки будет: SELECT 'string with\n newline, \x0a newline and \' backtick '; ``` -В режиме совместимости синтаксиса С++ (по-умолчанию) разрешается использовать вместо одинарных кавычек двойные: +В режиме совместимости синтаксиса С++ (по умолчанию) разрешается использовать вместо одинарных кавычек двойные: ```yql SELECT "string with\n newline, \x0a newline and \" backtick "; ``` diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/union_all.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/union_all.md index c29f8d70360..8a38fa5f0c3 100644 --- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/union_all.md +++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/union_all.md @@ -29,7 +29,7 @@ UNION ALL SELECT 3 AS z; ``` -В результате выполнения данного запроса в режиме по-умолчанию будет сформирована выборка с тремя колонками x, y, и z. При включенной `PRAGMA PositionalUnionAll;` в выборке будет одна колонка x. +В результате выполнения данного запроса в режиме по умолчанию будет сформирована выборка с тремя колонками x, y, и z. При включенной `PRAGMA PositionalUnionAll;` в выборке будет одна колонка x. ``` yql |