Docs4dev
Docs
mongodb / v3.6 / reference / reference-command-listShards.html

listShards

在本页面

Definition

  • listShards
    • listShards命令返回分片群集中已配置分片的列表。 listShards仅在mongos实例上可用，并且必须针对admin数据库发出。

该命令采用以下形式：

{ listShards: 1 }

Example

以下操作针对mongos admin数据库运行listShards：

db.adminCommand({ listShards: 1 })

以下文档是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)
}

Output

listShards返回包含以下内容的文档：

  • 一个shards字段，其中包含一系列文档，每个文档描述一个分片。每个文档可能包含以下字段：
Field Description
_id 分片的名称。
host 分片的主机名。如果该分片是副本集，则host列出副本集中每个 mongod 实例的主机名。
draining 如果为 true，则表示已为此分片调用removeShard，并且该分片正在耗尽中。
tags 分片所属的zones列表。
maxSize 分片的最大存储大小configured(兆字节)。这包括分片上的所有数据文件，包括local和admin数据库。如果超过，则该分片将不再接收任何块。
state 在addShard序列期间使用的内部字段，用于确保完成将分片添加到集群所需的所有步骤和配置。
  • 该操作的ok status 字段，operationTime字段和$clusterTime字段。有关这些字段的详细信息，请参见Response。