balancerStop
Nesta página
Definição
balancerStop
Disables the balancer in a sharded cluster. If a balancing round is in progress, the operation waits for balancing to complete.
You can only issue the
balancerStop
against theadmin
database on amongos
instance.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 auxiliarsh.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.A partir do MongoDB 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação.
In MongoDB versions earlier than 6.1, the command disables auto-splitting for the sharded cluster. To enable auto-splitting when the balancer is disabled, you can use
sh.enableAutoSplit()
.
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
Importante
Este comando não é suportado em instâncias sem servidor. Para obter mais informações, consulte Comandos não suportados.
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> } )
Campos de comando
Campo | Tipo | Descrição |
---|---|---|
| any | Any value. |
| inteiro | Limite de tempo para desativar o balanceador. O padrão é 60.000 milissegundos. |
Exemplo
To stop the balancer thread, connect to a mongos
instance
and issue the following command:
db.adminCommand( { balancerStop: 1 } )