balancerStop (comando de banco de dados)

Definição

balancerStop

Desabilita o balanceador em um cluster fragmentado. Se uma rodada de balanceamento estiver em andamento, a operação aguardará a conclusão do balanceamento.

You can only issue the balancerStop command against the admin database on a mongos instance.

A partir do MongoDB 7.0, interromper o balanceador também desativará o AutoMerger para o cluster fragmentado.

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.

Dica

In mongosh, this command can also be run through the sh.stopBalancer() helper method.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

• 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

Sintaxe

O comando tem a seguinte sintaxe:

db.adminCommand(
   {
     balancerStop: 1,
     maxTimeMS: <number>
   }
)

Exemplo

Para interromper o thread do balanceador, conecte-se a uma instância mongos e emita o seguinte comando:

db.adminCommand( { balancerStop: 1 } )

Saiba mais

• sh.stopBalancer()

• balancerStart