sh.stopBalancer()

Definição

sh.stopBalancer(timeout, interval)

Alterado na versão 6.1.

Desabilita 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.

Nas versões do MongoDB anteriores a 6.0.3, sh.stopBalancer() também desabilita 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 balancerStop.

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 desativar o balancer. O padrão é 60.000 milissegundos.
interval	inteiro	Opcional. O intervalo (em milissegundos) no qual verificar se a rodada de balanceamento parou.

Se você omitir ambas as opções, o MongoDB desativará o balanceador indefinidamente.

Importante

Deixar o balanceador desativado por longos períodos de tempo pode levar a shards desequilibrados, que degradam o desempenho do cluster. Desative o balanceador apenas se necessário e certifique-se de reativar o balanceador quando a manutenção for concluída.

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

O método mongosh shell é um wrapper que envolve o comando balancerStop .

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

Se uma rodada de balanceamento estiver em andamento, a operação aguarda a conclusão do balanceamento.

Saiba mais

• sh.enableBalancing()

• sh.disableBalancing()

• sh.getBalancerState()

• sh.isBalancerRunning()

• sh.setBalancerState()

• sh.startBalancer()

• sh.waitForBalancer()

• sh.waitForBalancerOff()