sh.startBalancer()

Definição

sh.startBalancer(timeout, interval)

Alterado na versão 6.0.

Inicia o balanceador em um cluster fragmentado.

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.

Nas versões do MongoDB anteriores a 6.0 sh.startBalancer() também ativa a divisão automática para o cluster fragmentado.

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação para comandos de banco de dados nem drivers específicos de linguagem, como Node.js.

Para o comando do banco de dados, consulte o comando balancerStart.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

O método pode usar as seguintes opções:

Parâmetro	Tipo	Descrição
timeout	inteiro	Opcional. Limite de tempo para habilitar o balanceador. O padrão é 60.000 milissegundos.
interval	inteiro	Opcional. A frequência (em milissegundos) com a qual verificar se uma rodada de balanceamento começou.

Você só pode executar sh.startBalancer() em uma instância do mongos . sh.startBalancer() erros se executados na instância mongod .

Compatibilidade

Esse método 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

Comportamento

O método shell mongosh sh.startBalancer() é um wrapper em torno do comando balancerStart . Dessa forma, o método não espera o início do balanceamento.

Em versões anteriores, o método aguardava o início do balanceamento.