Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Alternância primário/secundário para instância de cluster sharded

Última atualização: Jun 26, 2026

Por padrão, cada shard e ConfigServer em uma instância de cluster sharded do ApsaraDB for MongoDB possui três nós. O sistema aciona automaticamente a alternância primário/secundário em caso de falha no nó. Também é possível acionar manualmente a alternância para cenários como simulações de recuperação de desastres.

Observações de uso

  • A alternância primário/secundário tem suporte apenas em instâncias de replica set e cluster sharded, não sendo compatível com instâncias standalone.

  • Em instâncias de cluster sharded, o shard ou ConfigServer alvo da alternância deve estar no estado Running.

  • Essa operação causa erros transitórios de conexão de até 30 segundos. Execute-a fora dos horários de pico e verifique se sua aplicação possui mecanismo de reconexão.

Procedimento

  1. Acesse a página MongoDB Sharded Cluster 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 à direita do shard ou componente ConfigServer alvo.

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

    • Effective Immediately: a alternância ocorre imediatamente.

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

  5. Clique em OK.

    O status da instância muda para Switching Role. A alternância é concluída quando o status retorna para Running.

    Nota

    A alternância leva aproximadamente um minuto.

  6. Opcional: Para alternar outros componentes shard ou ConfigServer na instância de cluster sharded do ApsaraDB for MongoDB, repita estas etapas.

Tópicos relacionados

Por que o sistema de alta disponibilidade aciona uma alternância primário/secundário?

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.