Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Configure a primary/secondary switchover for a replica set instance

Última atualização: Jun 26, 2026

As instâncias de replica set do ApsaraDB for MongoDB operam em uma arquitetura de três nós: um nó primário, um nó secundário e um nó oculto. Os nós primário e secundário fornecem endpoints externos; o nó oculto atua como standby para garantir alta disponibilidade. Quando um nó falha, o sistema de alta disponibilidade aciona automaticamente um primary/secondary switchover. Para cenários como simulações de recuperação de desastres, acione o switchover manualmente.

Pré-requisitos

Antes de começar, verifique se você possui:

  • Uma instância de replica set ou sharded cluster (instâncias standalone não suportam primary/secondary switchover devido à sua arquitetura de nó único)

  • Uma instância no estado Running

  • Uma aplicação que suporte reconexão automática (a instância ficará desconectada por até 30 segundos durante o switchover)

Acionar um primary/secondary switchover

  1. Acesse a página Replica Set Instances. Na barra de navegação superior, selecione um grupo de recursos e uma região e, em seguida, clique no ID da instância de destino.

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

  3. Clique em Switch Role.

  4. No painel Switch Role, selecione as funções a alternar em Roles e defina o campo Effective At:

    Opção

    Descrição

    Effective Immediately

    O switchover é iniciado imediatamente.

    Effective Within Maintenance Window

    O switchover é executado dentro da janela de manutenção configurada. Para usar uma janela diferente, selecione uma na lista suspensa Change Maintenance Window.

  5. Clique em OK.

O status da instância muda para Failing Over. Quando retornar ao estado Running, o switchover estará concluído. O processo completo leva aproximadamente um minuto.

Importante

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

Próximas etapas

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.