Menu Docs

status do balanceador

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.

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

Importante

Este comando não é suportado em instâncias sem servidor. 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

O comando tem a seguinte sintaxe:

db.adminCommand(
{
balancerStatus: 1
}
)

A seguir, um exemplo de documento retornado pelo comando:

{
"mode" : "full",
"inBalancerRound" : false,
"numBalancerRounds" : NumberLong(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.

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

db.adminCommand( { balancerStatus: 1 } )