Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Fragmentação

status do balanceador

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • documento de saída
  • Exemplo

Definição

balancerStatus

Novidade na versão 3.4.

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 assistente 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

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

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" : 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.

Exemplo

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

db.adminCommand( { balancerStatus: 1 } )

Voltar

balancerStart

Próximo

balancerStop