listShards (comando de banco de dados)

Definição

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 .

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:

db.runCommand(
  {
    listShards: 1
  }
)

Campos de comando

O comando utiliza os seguintes campos:

Campo	Tipo	Descrição
`listShards`	inteiro	`1` solicita uma lista de fragmentos configurados.
`filter`	documento	Especifica um filtro para os fragmentos em documentos de retorno. Novidades na versão 8.3.:
`filter.draining`	booleano	Filtros retornam documents com base na drenagem de fragmentos. Quando definido como `true`, o comando retorna uma array dos fragmentos que estão sendo drenados pelo balanceador. Quando definido como `false`, o comando retorna uma array de todos os fragmentos que não estão sendo drenados pelo balanceador. Ao não ser definido, o comando retorna todos os fragmentos, independentemente de seu status de drenagem. Novidades na versão 8.3.:

Campos de 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`	Nome do fragmento.
`host`	Nome de 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 `true`, indica que os comandos `startShardDraining` ou `removeShard` foram chamados para esse fragmento e ele está em processo de drenagem.
`tags`	Lista de zonas às quais o fragmento pertence.
`state`	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.

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

Voltar

isdbgrade

mesclarAllChunksOnShard