sh.startBalancer()

Definição

sh.startBalancer(timeout, interval)

Alterado na versão 4.2.

Inicia o balanceador em um cluster fragmentado. A partir do MongoDB 4.2, 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 de banco de dados 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. 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.
interval	inteiro	Opcional. A frequência (em milissegundos) com a qual verificar se uma rodada de balanceamento começou. Alterado na versão 3.4: Aplicável somente ao usar o shell mongo versão 3.4 com clusters fragmentados de versão anterior.

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

A partir do MongoDB 3.4, o método { mongo shell sh.startBalancer() é um invólucro 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.