listShards（数据库命令）

定义

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" : Long("6488045157173166092")     }  },  "operationTime" : Timestamp(1510716515, 1)}

输出

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

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

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

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

后退

isdbgrid

来年

mergeAllChunksOnShard