balancerStart

Definição

balancerStart

Novidade na versão 3.4.

Inicia o balancer thread. O comando não espera pelo início de uma rodada de balanceamento.

A partir do MongoDB 4.2, 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 usar sh.disableAutoSplit().

Dica

Em mongosh, esse comando também pode ser executado por meio do método auxiliar sh.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.

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

• 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 recebe o seguinte formulário:

db.adminCommand( { balancerStart: 1, maxTimeMS: <number> } )

Exemplo

Para iniciar o thread do balanceador, conecte-se a uma instância mongos e emita o seguinte comando:

db.adminCommand( { balancerStart: 1 } )