ApsaraDB for MongoDB:Gerencie o balancer

Como funciona

O balancer monitora a distribuição de dados nos nós de shard e migra os dados automaticamente. O comportamento varia conforme a versão do mecanismo de banco de dados.

Observações de uso

• Suportado apenas para instâncias de cluster com sharding.

• Por padrão, o balancer opera continuamente (janela ativa de 24 horas).

• A migração de chunks consome recursos e pode degradar o desempenho. Programe a janela ativa para horários de baixa demanda.

Verifique o status do balancer

Antes de desativar o balancer, confirme que nenhuma migração está em andamento.

1. Connect to the sharded cluster instance by using the mongo shell.

2. Execute o seguinte comando:

      sh.isBalancerRunning()

3. Interprete o resultado com base no tipo de retorno: Valor de retorno Map Algumas versões do mongo shell retornam um objeto Map. Consulte o campo inBalancerRound conforme documentado em sh.isBalancerRunning().

   Valor de retorno Boolean

   Valor	Significado
   false	O balancer está ocioso. É seguro desativá-lo.
   true	O balancer está migrando chunks. Não o desative para evitar inconsistência de dados.

   **Valor de inBalancerRound**	Significado
   false	O balancer está ocioso. É seguro desativá-lo.
   true	O balancer está migrando chunks. Não o desative para evitar inconsistência de dados.

      {
        mode: 'full',
        inBalancerRound: false,
        numBalancerRounds: Long("1143"),
        ok: 1,
        '$clusterTime': {
          clusterTime: Timestamp({ t: 1639753724, i: 3 }),
          signature: {
            hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0),
            keyId: Long("0")
          }
        },
        operationTime: Timestamp({ t: 1639753724, i: 3 })
      }

Defina uma janela de tempo ativa

Restrinja o balancer a horários específicos para reduzir o impacto no desempenho durante os períodos de pico de uso.

1. Connect to the sharded cluster instance by using the mongo shell.

2. Mude para o banco de dados config:

      use config

3. Configure a janela de tempo ativa. Substitua os espaços reservados pelos seus valores. Exemplo: Execute o balancer diariamente das 01:00 às 03:00:

   Nota

   Os horários seguem o fuso horário local da região da instância.

   Espaço reservado	Descrição	Formato
   <start-time>	Hora de início da janela de tempo ativa	HH:MM (HH: 00--23, MM: 00--59)
   <stop-time>	Hora de término da janela de tempo ativa	HH:MM (HH: 00--23, MM: 00--59)

      db.settings.update(
         { _id: "balancer" },
         { $set: { activeWindow : { start : "<start-time>", stop : "<stop-time>" } } },
         { upsert: true }
      )

      db.settings.update(
         { _id: "balancer" },
         { $set: { activeWindow : { start : "01:00", stop : "03:00" } } },
         { upsert: true }
      )

4. Execute sh.status() para verificar. A saída exibe a janela de tempo ativa:

   

db.settings.update({ _id : "balancer" }, { $unset : { activeWindow : true } })

Ative o balancer

Ativar o balancer inicia imediatamente a migração de dados caso o sharding esteja configurado, o que consome recursos da instância. Realize esse procedimento em horários de baixa demanda.

1. Connect to the sharded cluster instance by using the mongo shell.

2. Mude para o banco de dados config:

      use config

3. Ative o balancer:

      sh.setBalancerState(true)

Desativar o balancer

1. Connect to the sharded cluster instance by using the mongo shell.

2. Mude para o banco de dados config:

      use config

3. Verifique se o balancer está migrando dados. Interprete o valor de retorno conforme descrito em Check the balancer status.

   • Se o resultado for false (ou inBalancerRound: false para valores de retorno Map), prossiga para a próxima etapa.

   • Caso o resultado seja true (ou inBalancerRound: true), aguarde a conclusão da migração. Desativar o balancer durante uma migração pode causar inconsistência de dados.

      sh.isBalancerRunning()

4. Quando o balancer estiver ocioso, desative-o:

      sh.stopBalancer()

Referências

• Connect to a sharded cluster instance by using the mongo shell

• sh.isBalancerRunning() -- Documentação oficial do MongoDB

Perguntas frequentes