---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/yql/reference/syntax/alter-async-replication.md
  - https://ydb.tech/docs/ru/yql/reference/syntax/alter-async-replication.md
sourcePath: ru/core/yql/reference/syntax/alter-async-replication.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# ALTER ASYNC REPLICATION

Вызов `ALTER ASYNC REPLICATION` изменяет параметры и состояние экземпляра [асинхронной репликации](https://ydb.tech/docs/ru/concepts/async-replication.md).

## Синтаксис {#syntax}

```yql
ALTER ASYNC REPLICATION <name> SET (option = value [, ...])
```

где:

* `name` — имя экземпляра асинхронной репликации.
* `SET (option = value [, ...])` — [параметры](#params) асинхронной репликации.

### Параметры {#params}

* `STATE` — состояние асинхронной репликации. Применимо только совместно с параметром `FAILOVER_MODE` (см. ниже). Возможные значения:
  * `DONE` — [завершение процесса асинхронной репликации](https://ydb.tech/docs/ru/concepts/async-replication.md#done).
* `FAILOVER_MODE` — режим переключения состояния. Применимо только совместно с параметром `STATE`. Возможные значения:
  * `FORCE` — принудительное переключение состояния.
* Настройки для аутентификации в базе-источнике одним из способов:

  <!-- source: ru/yql/reference/syntax/_includes/async_replication_authentification.md -->
    * С помощью [токена](https://ydb.tech/docs/ru/recipes/ydb-sdk/auth-access-token.md):

      * `TOKEN_SECRET_PATH` — [секрет](https://ydb.tech/docs/ru/concepts/datamodel/secrets.md), содержащий токен.

    * С помощью [логина и пароля](https://ydb.tech/docs/ru/recipes/ydb-sdk/auth-static.md):

      * `USER` — имя пользователя.
      * `PASSWORD_SECRET_PATH` — [секрет](https://ydb.tech/docs/ru/concepts/datamodel/secrets.md), содержащий пароль.

    * С помощью [делегированного сервисного аккаунта](https://yandex.cloud/ru/docs/iam/concepts/service-control):

      * `SERVICE_ACCOUNT_ID` — идентификатор сервисного аккаунта.
      * `INITIAL_TOKEN_SECRET_PATH` — [секрет](https://ydb.tech/docs/ru/concepts/datamodel/secrets.md), содержащий токен от сервисного аккаунта. Используется для первоначальной инициализации.
  <!-- endsource: ru/yql/reference/syntax/_includes/async_replication_authentification.md -->

## Примеры {#examples}

Следующий запрос принудительно завершит процесс асинхронной репликации:

```yql
ALTER ASYNC REPLICATION my_replication SET (STATE = "DONE", FAILOVER_MODE = "FORCE");
```

Следующий запрос изменяет секрет:

```yql
ALTER ASYNC REPLICATION my_replication SET (TOKEN_SECRET_PATH = "my_token");
```

## См. также

* [CREATE ASYNC REPLICATION](https://ydb.tech/docs/ru/yql/reference/syntax/create-async-replication.md)
* [DROP ASYNC REPLICATION](https://ydb.tech/docs/ru/yql/reference/syntax/drop-async-replication.md)