balancerStop
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 dadosadmin
em uma instânciamongos
.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. Para obter detalhes, consulte Alterações na política de balanceamento.
Em versões do MongoDB anteriores à 6.0, 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()
.
Sintaxe
O comando tem a seguinte sintaxe:
db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )
Campos de comando
Campo | Tipo | Descrição |
---|---|---|
balancerStop | qualquer | 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 } )