Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Alternar funções de nó

Última atualização: Jun 26, 2026

Alterne o nó primário de uma instância do ApsaraDB for MongoDB para colocá-lo na mesma localidade dos seus servidores de aplicação e reduzir a latência de gravação entre zonas.

Posicionamento de zona e latência de gravação

Em um replica set ou sharded cluster, o ApsaraDB for MongoDB designa um nó como primário e os demais como secundários. Todas as operações de gravação são direcionadas ao nó primário — portanto, quando os servidores de aplicação no Elastic Compute Service (ECS) estão em uma zona diferente do nó primário, cada gravação cruza zonas, aumentando a latência e reduzindo o throughput.

Environment for role switchover

Por exemplo, se suas instâncias ECS estão na Zona 2 e o nó primário está na Zona 1, as gravações percorrem o caminho entre zonas a cada requisição. Mover o nó primário para a Zona 2 mantém o tráfego dentro da mesma zona.

A alternância altera apenas as funções dos nós — as zonas e os IDs de função permanecem inalterados. Após a operação, o nó que era secundário continua fisicamente na Zona 2; ele simplesmente passa a ser o primário.

Pré-requisitos

Antes de começar, certifique-se de que:

  • Sua instância do ApsaraDB for MongoDB é do tipo replica set ou sharded cluster.

Agendamento e limitações

  • Desconexão durante a alternância: Cada alternância pode desconectar a instância por até 30 segundos. Programe a operação em períodos de baixo tráfego e garanta que sua aplicação seja capaz de reconectar-se automaticamente à instância.

  • Sharded clusters: Em instâncias do tipo sharded cluster, é possível gerencie a distribuição de zonas apenas dos nós de shard e Configserver.

  • Roles only, not zones: Após a alternância, as zonas dos nós e os IDs de função permanecem inalterados. Somente a designação de primário/secundário é modificada.

Alternar funções no console

  1. Faça login no console do ApsaraDB for MongoDB.

  2. No painel de navegação à esquerda, clique em Replica Set Instances ou Sharded Cluster Instances, conforme o tipo da sua instância.

  3. No canto superior esquerdo da página, selecione o grupo de recursos e a região onde a instância está localizada.

  4. Clique no ID da instância ou clique em More icon na coluna Actions e selecione Manage.

  5. No painel de navegação à esquerda da página de detalhes da instância, clique em Service Availability.

  6. Na seção Zone Distribution, clique em Switch Role no canto superior esquerdo.

    Em instâncias do tipo sharded cluster, acesse a seção Zone Distribution for Shards ou Zone Distribution for Configservers e clique em Switch Role .
  7. No painel Switch Role, configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Role (antes)

    A função do nó antes da alternância.

    Role (depois)

    A função do nó após a alternância.

    Effective At

    Defina quando a alternância será executada. Selecione Effective Immediately para execute imediatamente, ou Effective Within Maintenance Window para agendá-la. Caso escolha Effective Within Maintenance Window, selecione a janela atual ou personalize uma na lista suspensa Change Maintenance Window.

  8. Clique em OK.

Verificar a alternância

Após a conclusão da alternância, confirme que as funções dos nós foram alteradas conforme o esperado:

  1. Na página Service Availability, verifique a seção Zone Distribution.

  2. Confirme que o nó na zona de destino agora aparece como primário e que o antigo nó primário aparece como secundário.