status do balanceador
Definição
balancerStatus
Retorna um documento que contém informações sobre o status do balancer.
Você só pode emitir o
balancerStatus
contra o banco de dadosadmin
.Dica
Em
mongosh
, esse comando também pode ser executado por meio do método assistentesh.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 |
---|---|
| Uma string que especifica se o balancer thread está em execução ou parado. Os valores possíveis são:
|
| Um booleano que especifica se o balanceador está em uma rodada de balanceamento. Se
|
| 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 } )