sh.stopBalancer()

Definição

sh.stopBalancer(timeout, interval)

Alterado na versão 6.0.

Desabilita o balanceador em um cluster fragmentado.

A partir do MongoDB 6.0.3, a divisão automática de chunks não é executada. Isso se deve às melhorias no balanceamento das políticas. Os comandos de divisão automática ainda existem, mas não executam uma operação. Para obter detalhes, consulte Balanceamento de alterações na política.

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 do banco 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	Limite de tempo para desativar o balanceador. O padrão é 60.000 milissegundos.
interval	inteiro	O intervalo (em milissegundos) no qual verificar se o 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()