Listar fragmentos

Definição

listShards

O comandolistShardsretorna uma lista dos fragmentos configurados em um cluster fragmentado. listShardsestá disponível somente em instâncias do mongose deve ser emitido no banco de banco de dados do admin.

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

• 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:

{ listShards: 1 }

Exemplo

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",
      "maxSize": NumberLong("1024"),
      "state": 1
    }
  ],
  "ok": 1,
  "$clusterTime" : {
     "clusterTime" : Timestamp(1510716515, 1),
     "signature" : {
        "hash" : BinData(0,"B2ViX7XLzFLS5Fl9XEuFXbwKIM4="),
        "keyId" : NumberLong("6488045157173166092")
     }
  },
  "operationTime" : Timestamp(1510716515, 1)
}

Saída

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	Quando verdadeiro, indica que removeShard foi chamado para esse shard e que está em processo de drenagem.
  tags	Uma lista de zonas às quais o fragmento pertence.
  maxSize	O tamanho de armazenamento máximo configurado do shard em megabytes. Isso inclui todos os Data Federation no shard, inclusive os reconhecimento de data center local e admin . Se excedido, esse fragmento não receberá mais partes.
  state	Um campo interno usado durante a sequência addShard 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.