balancerStatus (comando de banco de dados)

Definição

balancerStatus

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

Você só pode enviar balancerStatus no banco de dados admin.

Dica

Em mongosh, esse comando também pode ser executado por meio do método auxiliar sh.isBalancerRunning().

Os métodos auxiliares são práticos para os usuários mongosh, mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a praticidade não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Compatibilidade

Esse comando 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

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