balancerStatus (comando de banco de dados)

Definição

balancerStatus

Retorna um documento que contém informações sobre o status do balancer.

You can only issue the balancerStatus against the admin database.

Dica

In mongosh, this command can also be run through the sh.isBalancerRunning() 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(
   {
     balancerStatus: 1
   }
)

documento de saída

A seguir, um exemplo de documento retornado pelo comando:

{
   "mode" : "full",
   "inBalancerRound" : false,
   "numBalancerRounds" : Long(86),
   "ok" : 1
}

Campo	Descrição
`"mode"`	Uma string que especifica se o balancer thread está em execução ou parado. Os valores possíveis são: "completo" A linha do balanceador está funcionando, mas não necessariamente em uma rodada de balanceamento. "OFF" A thread do balanceador está interrompida. Nenhum balanceamento de parte pode ocorrer neste modo.
`"inBalancerRound"`	Um booleano que especifica se o balanceador está em uma rodada de balanceamento. Se `inBalancerRound=true`, agora está distribuindo chunks. `inBalancerRound` pode ser `true` quando `mode=off`. Se você desligar o balanceador enquanto ele estiver em uma rodada de balanceamento, o servidor permitirá que ele termine em vez de interrompê-lo.
`"numBalancerRounds"`	O número de rodadas do balancer que ocorreram desde que os servidores de configuração foram iniciados. Esse valor não é persistente e é redefinido para 0 na reinicialização dos servidores de configuração.

Exemplo

Conecte a uma instância do mongos e emita o seguinte comando:

db.adminCommand( { balancerStatus: 1 } )

Voltar

balancerStart

balancerStop