diff options
author | bazeltsev <bazeltsev@yandex-team.ru> | 2022-02-23 16:37:18 +0300 |
---|---|---|
committer | bazeltsev <bazeltsev@yandex-team.ru> | 2022-02-23 16:37:18 +0300 |
commit | 66ffaf701b74c3818cb51e94fe8d87e1adedc19f (patch) | |
tree | fea032a6639b4d5fe18fef17867b7f5e6404020b | |
parent | 5082c890e9fced79ababea01152b594907e4a012 (diff) | |
download | ydb-66ffaf701b74c3818cb51e94fe8d87e1adedc19f.tar.gz |
Исправить ошибки по фидбеку переводчиков - 2
fixed
ref:cee887995377a6e0be57b69d544bb1097f5b0e4d
26 files changed, 43 insertions, 43 deletions
diff --git a/ydb/docs/ru/core/concepts/_includes/secondary_indexes.md b/ydb/docs/ru/core/concepts/_includes/secondary_indexes.md index f110bf78e9..946e7fcb52 100644 --- a/ydb/docs/ru/core/concepts/_includes/secondary_indexes.md +++ b/ydb/docs/ru/core/concepts/_includes/secondary_indexes.md @@ -22,7 +22,7 @@ ## Онлайн-создание вторичного индекса {#index-add} -В {{ ydb-short-name }} доступно создание вторичного индекса, а так же удаление существующего вторичного индекса без остановки обслуживания. Для одной таблицы можно создать только один индекс за раз. +В {{ ydb-short-name }} доступно создание вторичного индекса, а также удаление существующего вторичного индекса без остановки обслуживания. Для одной таблицы можно создать только один индекс за раз. Операция онлайн-создания индекса состоит из следующих шагов: diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/04_fs_backup_1_header.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/04_fs_backup_1_header.md index 10013fb926..788519f346 100644 --- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/04_fs_backup_1_header.md +++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/04_fs_backup_1_header.md @@ -5,4 +5,4 @@ {{ ydb-cli }} -e $YDB_ENDPOINT -d $YDB_DB_PATH tools dump -p $YDB_DB_PATH/backup -o my_backup_of_basic_example/ ``` -Для каждой директории в базе будет создана директория на файловой системе. Для каждой таблицы так же будет создана директория на файловой системе, в которую будет помещён файл с описанием структуры. Данные таблиц будут сохранены в одном или нескольких файлах в формате `csv`, по одной строке в файле для строки таблицы. +Для каждой директории в базе будет создана директория на файловой системе. Для каждой таблицы также будет создана директория на файловой системе, в которую будет помещён файл с описанием структуры. Данные таблиц будут сохранены в одном или нескольких файлах в формате `csv`, по одной строке в файле для строки таблицы. diff --git a/ydb/docs/ru/core/maintenance/embedded_monitoring/ydb_monitoring.md b/ydb/docs/ru/core/maintenance/embedded_monitoring/ydb_monitoring.md index 172480a081..407d5c9de1 100644 --- a/ydb/docs/ru/core/maintenance/embedded_monitoring/ydb_monitoring.md +++ b/ydb/docs/ru/core/maintenance/embedded_monitoring/ydb_monitoring.md @@ -161,7 +161,7 @@ http://<ендпоинт>:8765/monitoring/tenant/healthcheck?name=<tenant-path> * **Tablets/running** — количество работающих таблеток. -На странице тенанта так же имеются следующие вкладки: +На странице тенанта также имеются следующие вкладки: * **HealthCheck** — отчет о проблемах кластера при их наличии; * **Storage** — [список групп хранения](#tenant_storage_page), содержит информацию о том какие VDisk'и на каких узлах и устройствах работают; @@ -212,7 +212,7 @@ http://<ендпоинт>:8765/monitoring/tenant/healthcheck?name=<tenant-path> При выборе любого узла в правой части экрана отобразится информация о состоянии сетевого соединения между этим и другими узлами. -При отметке чекбоксов ID и Racks будут так же отображены ID узлов и их расположение по стойкам. +При отметке чекбоксов ID и Racks будут также отображены ID узлов и их расположение по стойкам. ## Индикаторы состояний {#colored_indicator} diff --git a/ydb/docs/ru/core/maintenance/manual/failure_model.md b/ydb/docs/ru/core/maintenance/manual/failure_model.md index 743ac1b856..e9de7d837f 100644 --- a/ydb/docs/ru/core/maintenance/manual/failure_model.md +++ b/ydb/docs/ru/core/maintenance/manual/failure_model.md @@ -11,7 +11,7 @@ При таком отказе потери данных не происходит, система сохраняет работоспособность, успешно выполняются запросы на чтение и запись. Возможно падение производительности вызванное переносом нагрузки обрабатываемой отказавшими дисками на оставшиеся в строю. -При отказе более одного VDisk'а в группе SelfHeal перестает перевозить VDisk'и. В случае если количество отказавших VDisk'ов находится на грани модели отказа, то рекомендуется восстановить работоспособность хотя бы одного из VDisk'ов, прежде чем начинать [перевоз VDisk'ов](moving_vdisks.md#removal_from_a_broken_device). Так же возможно потребуется более осторожно [перевозить VDisk'и по одному](moving_vdisks.md#moving_vdisk). +При отказе более одного VDisk'а в группе SelfHeal перестает перевозить VDisk'и. В случае если количество отказавших VDisk'ов находится на грани модели отказа, то рекомендуется восстановить работоспособность хотя бы одного из VDisk'ов, прежде чем начинать [перевоз VDisk'ов](moving_vdisks.md#removal_from_a_broken_device). Также возможно потребуется более осторожно [перевозить VDisk'и по одному](moving_vdisks.md#moving_vdisk). ## Количество отказавших VDisk'ов превысило модель отказа {#exceeded_the_failure_model} diff --git a/ydb/docs/ru/core/maintenance/manual/index.md b/ydb/docs/ru/core/maintenance/manual/index.md index 90f2ced2b7..c0bec53147 100644 --- a/ydb/docs/ru/core/maintenance/manual/index.md +++ b/ydb/docs/ru/core/maintenance/manual/index.md @@ -10,7 +10,7 @@ * Окончание свободного места на нескольких физических дисках тоже может остановить запись, которое можно решить [освобождением места](disk_end_space.md) либо [расширением кластера](cluster_expansion.md) блочными устройствами. -Не санкционированный вывод узлов может повлечь за собой выше описанные проблемы, для предотвращения возможных проблем следует правильно [выводить узлы в техническое обслуживание](node_restarting.md). +Несанкционированный вывод узлов может повлечь за собой выше описанные проблемы, для предотвращения возможных проблем следует правильно [выводить узлы в техническое обслуживание](node_restarting.md). Профилактикой тоже будет служить включение [Scrubbing](scrubbing.md) и [SelfHeal](selfheal.md). diff --git a/ydb/docs/ru/core/maintenance/manual/node_restarting.md b/ydb/docs/ru/core/maintenance/manual/node_restarting.md index 35ef9dbe85..a598ead0ae 100644 --- a/ydb/docs/ru/core/maintenance/manual/node_restarting.md +++ b/ydb/docs/ru/core/maintenance/manual/node_restarting.md @@ -32,7 +32,7 @@ При длительном отсутствии стоит перед этим перевезти все VDisk'и с данного узла и дождаться окончания репликации. После окончания репликации узел можно безопасно выключать. -Для отключения динамической узлы так же может потребоваться выполнить мягкий увоз таблеток с узла(Drain), дабы избежать эффекта на работающие запросы. +Для отключения динамической узлы также может потребоваться выполнить мягкий увоз таблеток с узла(Drain), дабы избежать эффекта на работающие запросы. Стоит перейти на страницу [Hive web-viewer](../embedded_monitoring/hive.md). После нажатия на кнопку "View Nodes" отобразится список всех узлов. 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 index 6f3d4ca1fa..e85110ced1 100644 --- 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 @@ -57,7 +57,7 @@ {{ ydb-cli }} --profile db1 scheme ls dir2/dir3 -l ``` -- Получение полной информации по объектам во всех директория базы данных +- Получение полной информации по объектам во всех директориях базы данных ```bash {{ ydb-cli }} --profile db1 scheme ls -lR diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/access_token.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/access_token.md index 8878e85dd9..a63589e9b9 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/access_token.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/access_token.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода аутентификации при помощи токена в разных `Ydb SDK` +Ниже приведены примеры кода аутентификации при помощи токена в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/anonymous.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/anonymous.md index 984c1a1999..d9ba134efd 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/anonymous.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/anonymous.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода анонимной аутентификации в разных `Ydb SDK` +Ниже приведены примеры кода анонимной аутентификации в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/env.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/env.md index 48fba2c1c5..42b4a96650 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/env.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/env.md @@ -7,11 +7,11 @@ Установив одну из следующих переменных окружения, можно управлять способом аутентификации: * `YDB_SERVICE_ACCOUNT_KEY_FILE_CREDENTIALS=<path/to/sa_key_file>` — использовать файл сервисного аккаунта в Яндекс Облаке -* `YDB_ANONYMOUS_CREDENTIALS="1"` — Использовать анонимную аутентификацию. Актуально для тестирования против докер-контейнера с `Ydb` +* `YDB_ANONYMOUS_CREDENTIALS="1"` — Использовать анонимную аутентификацию. Актуально для тестирования против докер-контейнера с {{ ydb-short-name }} * `YDB_METADATA_CREDENTIALS="1"` — использовать сервис метаданных внутри Яндекс Облака (Яндекс функция или виртуальная машина) * `YDB_ACCESS_TOKEN_CREDENTIALS=<access_token>` — использовать аутентификацию с токеном -Ниже приведены примеры кода аутентификации при помощи переменных окружения в разных `Ydb SDK` +Ниже приведены примеры кода аутентификации при помощи переменных окружения в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/index.md index 2763d3c107..632f727147 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/index.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/index.md @@ -2,6 +2,6 @@ {% include [work in progress message](../../_includes/addition.md) %} -`Ydb` поддерживает несколько способов аутентификации подключения к серверной стороне. Каждый из них, как правило, специфичен для конкретной пары окружений: где находится клиентское приложение (в доверенной зоне `Ydb` или вне ее) и серверная часть `Ydb` (докер-контейнер, yandex.Cloud, data cloud, установка на отдельном кластере) +{{ ydb-short-name }} поддерживает несколько способов аутентификации подключения к серверной стороне. Каждый из них, как правило, специфичен для конкретной пары окружений: где находится клиентское приложение (в доверенной зоне {{ ydb-short-name }} или вне ее) и серверная часть {{ ydb-short-name }} (докер-контейнер, yandex.Cloud, data cloud, установка на отдельном кластере) -В данном разделе содержатся рецепты кода с настройкой аутентификации в разных `Ydb SDK`. Общее описание принципов аутентификации в SDK можно прочитать в статье [Аутентификация в SDK](../../../auth.md). +В данном разделе содержатся рецепты кода с настройкой аутентификации в разных {{ ydb-short-name }} SDK. Общее описание принципов аутентификации в SDK можно прочитать в статье [Аутентификация в SDK](../../../auth.md). diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/metadata.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/metadata.md index 8fcd79308a..9ae4b2e2f9 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/metadata.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/metadata.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода аутентификации при помощи переменных окружения в разных `Ydb SDK` +Ниже приведены примеры кода аутентификации при помощи переменных окружения в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/service_account.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/service_account.md index d7294c3ad2..d0c465cff2 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/service_account.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/service_account.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода аутентификации при помощи файла сервисного аккаунта в разных `Ydb SDK` +Ниже приведены примеры кода аутентификации при помощи файла сервисного аккаунта в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/static.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/static.md index 4ddc79af06..0da366a49a 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/static.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/auth/_includes/static.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода аутентификации при помощи логина и пароля в разных `Ydb SDK` +Ниже приведены примеры кода аутентификации при помощи логина и пароля в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/index.md index 42efd60eb0..20ebf855e3 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/index.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/index.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -`Ydb` использует клиентскую балансировку, потому что клиентская балансировка эффективнее, когда на базу данных приходит большой трафик от множества клиентских приложений. -В большинстве случаев она просто работает в Ydb SDK. Однако иногда нужны специфичные настройки клиентской балансировки, например, для уменьшения серверных хопов, сокращения времени запроса или распределения нагрузки по зонам доступности. +{{ ydb-short-name }} использует клиентскую балансировку, потому что клиентская балансировка эффективнее, когда на базу данных приходит большой трафик от множества клиентских приложений. +В большинстве случаев она просто работает в {{ ydb-short-name }} SDK. Однако иногда нужны специфичные настройки клиентской балансировки, например, для уменьшения серверных хопов, сокращения времени запроса или распределения нагрузки по зонам доступности. -В данном разделе содержатся рецепты кода с настройкой клиентской балансировки в разных `Ydb SDK` +В данном разделе содержатся рецепты кода с настройкой клиентской балансировки в разных {{ ydb-short-name }} SDK diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_local.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_local.md index e3e1cdd0da..3b4a04ee79 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_local.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_local.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода установки опции алгоритма балансировки "предпочитать ближайший дата-центр" в разных `Ydb SDK` +Ниже приведены примеры кода установки опции алгоритма балансировки "предпочитать ближайший дата-центр" в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_location.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_location.md index b8c5154400..3cf224ea5b 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_location.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/prefer_location.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода установки опции алгоритма балансировки "предпочитать зону доступности" в разных `Ydb SDK` +Ниже приведены примеры кода установки опции алгоритма балансировки "предпочитать зону доступности" в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/random_choice.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/random_choice.md index b07914f2f3..0df2ef3980 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/random_choice.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/balancing/_includes/random_choice.md @@ -2,9 +2,9 @@ {% include [work in progress message](../../_includes/addition.md) %} -`Ydb SDK` использует алгоритм `random_choice` (равномерную случайную балансировку) по умолчанию. +{{ ydb-short-name }} SDK использует алгоритм `random_choice` (равномерную случайную балансировку) по умолчанию. -Ниже приведены примеры кода принудительной установки алгоритма балансировки "равномерный случайный выбор" в разных `Ydb SDK` +Ниже приведены примеры кода принудительной установки алгоритма балансировки "равномерный случайный выбор" в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/index.md index 3c10c45781..c1a4f4c924 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/index.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/index.md @@ -2,6 +2,6 @@ {% include [work in progress message](../../_includes/addition.md) %} -При диагностике проблем, связанных с Ydb, помогают средства диагностики, такие как логирование, метрики, трассы OpenTracing/Jaeger. Мы настоятельно рекомендуем подключать средства диагностики заранее, пока не случилось проблем. Как минимум при расследовании можно увидеть изменения картины до проблем, во время и после. Это сильно ускоряет расследование происшествия и нашу помощь. +При диагностике проблем, связанных с {{ ydb-short-name }}, помогают средства диагностики, такие как логирование, метрики, трассы OpenTracing/Jaeger. Мы настоятельно рекомендуем подключать средства диагностики заранее, пока не случилось проблем. Как минимум при расследовании можно увидеть изменения картины до проблем, во время и после. Это сильно ускоряет расследование происшествия и нашу помощь. -В данном разделе содержатся рецепты кода с подключением средств диагностики в разных `Ydb SDK` +В данном разделе содержатся рецепты кода с подключением средств диагностики в разных {{ ydb-short-name }} SDK diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/jaeger.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/jaeger.md index 679d3d0465..7a97178a82 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/jaeger.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/jaeger.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода включения трассировки в Jaeger в разных `Ydb SDK` +Ниже приведены примеры кода включения трассировки в Jaeger в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/logs.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/logs.md index e08d3ee8f5..e666f05d78 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/logs.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/logs.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода включения логгирования в разных `Ydb SDK` +Ниже приведены примеры кода включения логгирования в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/prometheus.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/prometheus.md index 3b9e3a6989..614e7391fc 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/prometheus.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/debug/_includes/prometheus.md @@ -2,7 +2,7 @@ {% include [work in progress message](../../_includes/addition.md) %} -Ниже приведены примеры кода включения метрик в Prometheus в разных `Ydb SDK` +Ниже приведены примеры кода включения метрик в Prometheus в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/_includes/go.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/_includes/go.md index 5f042b15c7..9c2fbefdb8 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/_includes/go.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/_includes/go.md @@ -1,4 +1,4 @@ -В `Ydb Go SDK` корректная обработка ошибок закреплена в нескольких программных интерфейсах: +В {{ ydb-short-name }} Go SDK корректная обработка ошибок закреплена в нескольких программных интерфейсах: * Основная логика обработки ошибок реализуется функцией-помощником `retry.Retry` Подробности выполнения повторных запросов максимально скрыты. Пользователь может влиять на логику работы функции `retry.Retry` двумя способами: @@ -7,7 +7,7 @@ Пользователь передает свою функцию в `retry.Retry`, которая по своей сигнатуре должна возвращать ошибку. В случае, если из пользовательской функции вернулся `nil`, то повторные запросы прекращаются. - В случае, если из пользовательской функции вернулась ошибка, `Ydb Go SDK` пытается идентифицировать эту ошибку и в зависимости от нее выполняет повторные попытки. + В случае, если из пользовательской функции вернулась ошибка, {{ ydb-short-name }} Go SDK пытается идентифицировать эту ошибку и в зависимости от нее выполняет повторные попытки. {% cut "Пример кода, использующего функцию `retry.Retry`:" %} ```go @@ -54,8 +54,8 @@ } ``` {% endcut %} -* Сервис для работы с табличными запросами `db.Table()` сразу предоставляет программный интерфейс `table.Client`, который использует пакет `retry`, а также следит за временем жизни сессий `Ydb`. +* Сервис для работы с табличными запросами `db.Table()` сразу предоставляет программный интерфейс `table.Client`, который использует пакет `retry`, а также следит за временем жизни сессий {{ ydb-short-name }}. Пользователю доступны две публичных функции: `db.Table().Do(ctx, op)` (`op` предоставляет сессию) и `db.Table().DoTx(ctx, op)` (`op` предоставляет транзакцию). - Как и в предыдущем случае пользователь может влиять на логику выполнения повторных запросов через контекст и признак идемпотентности, а `Ydb Go SDK` интерпретирует возвращаемые из `op` ошибки. -* Запросы к остальным сервисам `Ydb` (`db.Scripting()`, `db.Scheme()`, `db.Coordination()`, `db.Ratelimiter()`, `db.Discovery()`) также используют внутри себя функцию `retry.Retry` для выполнения повторных запросов. + Как и в предыдущем случае пользователь может влиять на логику выполнения повторных запросов через контекст и признак идемпотентности, а {{ ydb-short-name }} Go SDK интерпретирует возвращаемые из `op` ошибки. +* Запросы к остальным сервисам {{ ydb-short-name }} (`db.Scripting()`, `db.Scheme()`, `db.Coordination()`, `db.Ratelimiter()`, `db.Discovery()`) также используют внутри себя функцию `retry.Retry` для выполнения повторных запросов. diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/index.md index 2d336da3aa..b7dcdd0159 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/index.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/retry/index.md @@ -2,14 +2,14 @@ {% include [work in progress message](../_includes/addition.md) %} -`Ydb` является распределенной СУБД с автоматическим масштабированием под нагрузку. +{{ ydb-short-name }} является распределенной СУБД с автоматическим масштабированием под нагрузку. На серверной стороне могут проводиться работы, серверные стойки или целые дата-центры могут быть временно отключены. -В связи с этим допускаются некоторые ошибки при работе с `Ydb`. +В связи с этим допускаются некоторые ошибки при работе с {{ ydb-short-name }}. В зависимости от типа ошибки следует по разному реагировать на них. -`Ydb SDK` для обеспечения высокой доступности предоставляют встроенные средства выполнения повторных попыток, +{{ ydb-short-name }} SDK для обеспечения высокой доступности предоставляют встроенные средства выполнения повторных попыток, в которых учтены типы ошибок и закреплена реакция на них. -Ниже приведены примеры кода использования встроенных в `Ydb SDK` средств выполнения повторных попыток: +Ниже приведены примеры кода использования встроенных в {{ ydb-short-name }} SDK средств выполнения повторных попыток: {% list tabs %} diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md index 57d7bc22eb..388dca88f1 100644 --- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md +++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md @@ -4,11 +4,11 @@ Размер пула сессий на клиенте влияет на потребление ресурсов (память, процессор) на серверной стороне {{ ydb-short-name }}. Простая математика: если `1000` клиентов одной базы данных имеют по `1000` сессий, то на серверной стороне создается `100000` акторов (воркеров, исполнителей сессий). Если не лимитировать количество сессий на клиенте, то можно получить "задумчивый" кластер в полу-аварийном состоянии. -По умолчанию в `Ydb SDK` установлен лимит в `50` сессий. -Хорошая рекомендация - устанавливать лимит на количество сессий на клиенте в минимальное-необходимое для штатной работы клиентского приложения. Следует иметь в виду, что сессия однопоточная что на серверной стороне, что на клиентской. Соответственно, если для расчетной нагрузки приложению необходимо выполнять `1000` одновременных запросов (`inflight`) в `Ydb` - значит следует установить лимит в `1000` сессий. -Тут надо отличать расчетный `RPS` (requests per second, запросов в секунду) и `inflight`. В первом случае это общее количество выполненных запросов к `Ydb` за `1` секунду. Например, для `RPS`=`10000` и средним `latency` (задержка исполнения запроса) в `100`мс достаточно установить лимит в `1000` сессий. То есть каждая сессия за расчетную секунду выполнит в среднем `10` последовательных запросов. +По умолчанию в {{ ydb-short-name }} SDK установлен лимит в `50` сессий. +Хорошая рекомендация - устанавливать лимит на количество сессий на клиенте в минимальное-необходимое для штатной работы клиентского приложения. Следует иметь в виду, что сессия однопоточная что на серверной стороне, что на клиентской. Соответственно, если для расчетной нагрузки приложению необходимо выполнять `1000` одновременных запросов (`inflight`) в {{ ydb-short-name }} - значит следует установить лимит в `1000` сессий. +Тут надо отличать расчетный `RPS` (requests per second, запросов в секунду) и `inflight`. В первом случае это общее количество выполненных запросов к {{ ydb-short-name }} за `1` секунду. Например, для `RPS`=`10000` и средним `latency` (задержка исполнения запроса) в `100`мс достаточно установить лимит в `1000` сессий. То есть каждая сессия за расчетную секунду выполнит в среднем `10` последовательных запросов. -Ниже приведены примеры кода установки лимита на пул сессий в разных `Ydb SDK` +Ниже приведены примеры кода установки лимита на пул сессий в разных {{ ydb-short-name }} SDK {% list tabs %} diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/list.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/list.md index 9ef7c60c11..6b25c5fb66 100644 --- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/list.md +++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/list.md @@ -414,7 +414,7 @@ FROM my_table; `ListTakeWhile` выдает список от начала, пока предикат истинный, далее список заканчивается. `ListSkipWhile` пропускает отрезок списка от начала, пока предикат истинный, далее выдает остаток список не обращая внимания на предикат. -`ListTakeWhileInclusive` выдает список от начала, пока предикат истинный, далее список заканчивается, но так же включает элемент, на котором сработал останавливающий предикат. +`ListTakeWhileInclusive` выдает список от начала, пока предикат истинный, далее список заканчивается, но также включает элемент, на котором сработал останавливающий предикат. `ListSkipWhileInclusive` пропускает отрезок списка от начала, пока предикат истинный, далее выдает остаток список не обращая внимания на предикат, но не включая элемент, на котором сработал предикат, а начинает со следующего за ним. Обязательные аргументы: |