Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
数据库命令
/
分片

列出分片

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 例子
  • 输出

定义

listShards

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

兼容性

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

  • MongoDB Atlas：用于云中 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