Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

listShards (comando de banco de dados)

listShards

O comando listShards retorna uma lista dos fragmentos configurados em um cluster fragmentado. listShards está disponível somente em instâncias do mongos e deve ser emitido no banco de dados do admin .

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

O comando tem a seguinte sintaxe:

db.runCommand( { listShards: 1 })

A operação a seguir executa listShards no banco de dados mongos admin :

db.adminCommand({ listShards: 1 })

O documento a seguir é um exemplo da saída de um comando listShards :

{ "shards": [ { "_id": "shard01", "host": "shard01/host1:27018,host2:27018,host3:27018", "state": 1 }, { "_id": "shard02", "host": "shard02/host4:27018,host5:27018,host6:27018", "tags": [ "NYC" ], "state": 1 }, { "_id": "shard03", "host": "shard03/host7:27018,host8:27018,host9:27018", "state": 1 } ], "ok": 1, "$clusterTime" : { "clusterTime" : Timestamp(1510716515, 1), "signature" : { "hash" : BinData(0,"B2ViX7XLzFLS5Fl9XEuFXbwKIM4="), "keyId" : Long("6488045157173166092") } }, "operationTime" : Timestamp(1510716515, 1)}

listShards retorna um documento que inclui:

  • Um campo shards que contém um array de documentos, cada um descrevendo um shard. Cada documento pode conter os seguintes campos:

    Campo
    Descrição

    _id

    O nome do shard.

    host

    O nome do host do shard. Se o shard for um conjunto de réplica, host listará o nome do host de cada instância de mongod no conjunto de réplicas.

    draining

    Se for verdadeiro, indica que removeShard (comando de banco de dados) foi chamado para esse shard e está em processo de drenagem.

    tags

    Uma lista de zonas às quais o fragmento pertence.

    state

    Um campo interno usado durante a sequência addShard (comando de banco de dados) para garantir que todas as etapas e configurações necessárias para adicionar o fragmento ao cluster sejam concluídas.

  • O campo de status ok, o campo operationTime e o campo $clusterTime para a operação. Para obter detalhes sobre esses campos, consulte Resposta.