balancerStop
Nesta página
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
contra o banco de banco de dadosadmin
em uma instânciamongos
.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.
Nas versões MongoDB anteriores a 6.1, o comando desabilita a divisão automática para o cluster fragmentado. Para habilitar a divisão automática quando o balanceador estiver desabilitado, você pode utilizar o
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 |
---|---|---|
balancerStop | any | Qualquer valor. |
maxTimeMS | inteiro | Limite de tempo para desativar o balanceador. O padrão é 60.000 milissegundos. |
Exemplo
Para interromper o thread do balanceador, conecte-se a uma instância mongos
e emita o seguinte comando:
db.adminCommand( { balancerStop: 1 } )