balancerStop (comando de banco de dados)

Definição

balancerStop

Desabilita o balanceador em um cluster fragmentado. Se uma rodada de balanceamento estiver em andamento, a operação aguardará a conclusão do balanceamento.

Você só pode emitir o balancerStop comando no admin banco de dados em uma mongos instância.

A partir do MongoDB,7.0 interromper o balanceador também desativará o AutoMerger para o cluster fragmentado.

Importante

Deixar o balanceador desativado por longos períodos de tempo pode levar a shards desequilibrados, que degradam o desempenho do cluster. Desative o balanceador apenas se necessário e certifique-se de reativar o balanceador quando a manutenção for concluída.

Dica

Em mongosh, esse comando também pode ser executado por meio do método auxiliar sh.stopBalancer().

Os métodos auxiliares são práticos para os usuários mongosh, mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a praticidade não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O comando tem a seguinte sintaxe:

db.adminCommand(
   {
     balancerStop: 1,
     maxTimeMS: <number>
   }
)

Exemplo

Para interromper o thread do balanceador, conecte-se a uma instância mongos e emita o seguinte comando:

db.adminCommand( { balancerStop: 1 } )

Saiba mais

• sh.stopBalancer()

• balancerStart