balancerStart
Nesta página
Definição
balancerStart
Inicia o balancer thread. O comando não espera pelo início de uma rodada de balanceamento.
Dica
No
mongosh
, este comando também pode ser executado pelo método assistente dosh.startBalancer()
.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 habilita a divisão automática para o cluster fragmentado. Para desabilitar a divisão automática quando o balanceador estiver habilitado, você pode utilizar o
sh.disableAutoSplit()
.
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
Você só pode emitir o balancerStart
contra o banco de dados admin
em uma instância mongos
.
O comando tem a seguinte sintaxe:
db.adminCommand( { balancerStart: 1, maxTimeMS: <number> } )
Campos de comando
Campo | Tipo | Descrição |
---|---|---|
balancerStart | any | Qualquer valor. |
maxTimeMS | inteiro | Opcional. Limite de tempo para habilitar o balanceador. O padrão é 60.000 milissegundos. |
Exemplo
Para iniciar o thread do balanceador, conecte-se a uma instância mongos
e emita o seguinte comando:
db.adminCommand( { balancerStart: 1 } )