status do balanceador

Esta versão da documentação foi arquivada e não é mais suportada. Para atualizar seu sistema do 5.0, consulte osprocedimentos de atualização do MongoDB 6.0 .

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

balancerStop