Menu Docs

sh.stopBalancer()

sh.stopBalancer(timeout, interval)

Alterado na versão 6.1.

Disables the balancer in a sharded cluster.

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.

In MongoDB versions earlier than 6.0.3, sh.stopBalancer() also disables auto-splitting for the sharded cluster.

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.

The method can take the following options:

Parâmetro
Tipo
Descrição

timeout

inteiro

Optional. Time limit for disabling the balancer.

Defaults to 60000 milliseconds.

interval

inteiro

Optional. The interval (in milliseconds) at which to check if the balancing round has stopped.

If you omit both options, MongoDB disables the balancer indefinitely.

Importante

Leaving the balancer disabled for extended periods of time can lead to unbalanced shards, which degrade cluster performance. Only disable the balancer if necessary, and ensure that you re-enable the balancer when maintenance is complete.

You can only run sh.stopBalancer() on a mongos instance. sh.stopBalancer() errors if run on mongod instance.

The mongosh shell method is a wrapper around the balancerStop command.

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

Importante

Este comando não é suportado em clusters M0, M2 e M5 . 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

If a balancing round is in progress, the operation waits for balancing to complete.