admin cluster bridge failover

Функциональность Корпоративной СУБД Яндекса

Данная функциональность доступна только в Корпоративной СУБД Яндекса. В open-source версии YDB она отсутствует.

С помощью команды admin cluster bridge failover можно выполнить аварийное отключение pile, когда он недоступен. При необходимости можно указать pile, который станет новым PRIMARY.

Внимание

Команды из этого раздела могут нанести вред вашему кластеру при неправильном использовании. Из-за потенциально опасного характера этих команд ВСЕ глобальные параметры должны быть заданы явно. Профили отключены по умолчанию и используются только при явном указании (--profile <имя-профиля>). Некоторые команды не требуют глобальных опций, которые в противном случае являются обязательными.

Общий вид команды:

ydb [global options...] admin cluster bridge failover [options...]

Просмотр справки по команде:

ydb admin cluster bridge failover --help

Параметры подкоманды

Имя

Описание

--pile <pile>

Имя недоступного pile.

--new-primary <pile>

Имя pile, который должен стать новым PRIMARY pile. Укажите, если недоступный pile был PRIMARY.

Требования

  • Если недоступен текущий PRIMARY, обязательно укажите --new-primary и выберите pile в состоянии SYNCHRONIZED. При отсутствии --new-primary или выборе pile в состоянии, отличном от SYNCHRONIZED, команда вернёт ошибку без каких‑либо изменений.
  • Кластер не перейдёт в невалидное состояние: при нарушении требований команда ничего не изменяет и сообщает об ошибке.
  • Если pile не вышел из строя, но его нужно отключить, используйте плановое отключение — команду takedown.

Примеры

Выполнение аварийного отключения для недоступного pile под названием pile-a:

ydb admin cluster bridge failover --pile pile-a

Выполнение аварийного отключения для недоступного PRIMARY pile и назначение новым PRIMARY синхронизированного pile:

ydb admin cluster bridge failover --pile pile-a --new-primary pile-b

Проверка результата

С помощью команды list проверьте, что недоступный pile переведён в состояние DISCONNECTED и (если был указан --new-primary) выбран новый PRIMARY pile :

ydb admin cluster bridge list

pile-a: DISCONNECTED
pile-b: PRIMARY
Предыдущая
ydb admin cluster bridge switchover
Следующая
ydb admin cluster bridge takedown