Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Executar um failover primário/secundário

Última atualização: Jul 20, 2026

Por padrão, uma instância de conjunto de réplicas do ApsaraDB for MongoDB possui três nós: um nó primário e um nó secundário que fornecem endpoints de acesso, além de um nó oculto para alta disponibilidade. Use o ApsaraDB for MongoDB para acionar manualmente um failover primário/secundário em simulados de recuperação de desastres.

Contexto

  • O failover primário/secundário é compatível apenas com instâncias de conjunto de réplicas e cluster fragmentado. Instâncias independentes não oferecem suporte a esse recurso.

  • Essa operação causa uma interrupção transitória de conexão de até 30 segundos. Certifique-se de que sua aplicação ofereça suporte à reconexão automática.

  • A instância deve estar no status Running.

Procedimento

  1. Acesse a página ApsaraDB for MongoDB Replica Set Instances. No topo da página, selecione um grupo de recursos e uma região e clique em ID da instância desejada.

  2. No painel de navegação à esquerda, clique em Service Availability.

  3. Clique em Switch Role.

  4. No painel Switch Role, selecione as duas Roles a alternar e escolha uma opção para Effective Time.

    • Effective Immediately: O failover ocorre imediatamente.

    • Effective Within Maintenance Window: A alternância ocorre durante a janela de manutenção especificada. Use a janela atual ou defina uma nova na lista suspensa Change Maintenance Window.

  5. Clique em OK.

    O status da instância muda para Switching Role. Quando o status retornar para Running, o failover estará concluído.

    Nota
    • O status da instância retorna a Running em aproximadamente um minuto.

    • Se sua aplicação se conectar diretamente ao endpoint do nó primário, atualize a string de conexão para o endpoint do novo nó primário após o failover. Caso contrário, as operações de leitura e escrita poderão falhar. Para mais informações, consulte Connect to a replica set instance.

Tópicos relacionados

Why does the high availability system trigger a primary/secondary switchover?

Referência de API

API

Descrição

SwitchDBInstanceHA

Alterna os nós primário e secundário de uma instância do ApsaraDB for MongoDB.