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. Para obter detalhes, consulte Alterações na política de balanceamento.
Em versões anteriores ao MongoDB 6,0, 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 |
---|---|---|
| any | Qualquer valor. |
| 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 } )
Veja também: