Menu Docs

balancerStart

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 utilizar o 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().

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

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> } )
Campo
Tipo
Descrição

balancerStart

any

Qualquer valor.

maxTimeMS

inteiro

Opcional. Limite de tempo para habilitar o balanceador.

O padrão é 60.000 milissegundos.

Alterado na versão 3.4: Se estiver usando o shell 3.4 mongo com clusters fragmentados de versão anterior, o parâmetro especifica a quantidade de tempo para aguardar o início da rodada de balanceamento.

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

db.adminCommand( { balancerStart: 1 } )