列出分片

在此页面上

定义

兼容性
语法
例子
输出

定义

listShards: listShards命令返回分片分片集群中已配置分片的列表。 listShards仅适用于 mongos实例，且必须针对admin数据库发布。

兼容性

此命令可用于以下环境中托管的部署：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

重要

无服务器实例不支持此命令。有关更多信息，请参阅不支持的命令。

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

db.runCommand(
  {
    listShards: 1
  }
)

例子

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

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

输出

listShards 返回一个文档，其中包括：

一个 shards 字段，它包含一个文档数组，每个文档描述一个分片。每个文档可能包含以下字段：

字段	说明
`_id`	分片的名称。
`host`	分片的主机名。如果分片是副本集，则 `host` 列出副本集中每个 mongod 实例的主机名。
`draining`	如果为 true，则表示已为此分片调用了 removeShard，并且正在清空。
`tags`	分片所属区域的列表。
`state`	在 addShard 序列中使用的内部字段，用于确保完成向集群添加分片所需的所有步骤和配置。

操作的 ok 状态字段、operationTime 字段和 $clusterTime 字段。有关这些字段的详细信息，请参阅响应。

后退

isdbgrid

来年

mergeAllChunksOnShard