reshardCollection（数据库命令）

定义

reshardCollection

版本 5.0 中的新增功能。

The reshardCollection command changes the shard key for a collection and changes the distribution of your data.

提示

In mongosh, this command can also be run through the sh.reshardCollection() helper method.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

兼容性

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

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

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

db.runCommand(
   {
     reshardCollection: "<database>.<collection>",
     key: <shardkey>,
     unique: <boolean>,
     numInitialChunks: <integer>,
     collation: { locale: "simple" },
     zones: [
         {
             min: <document with same shape as shardkey>,
             max: <document with same shape as shardkey>,
             zone: <string> | null
         },
         ...
     ]
   }
)

命令字段

该命令接受以下字段：

Considerations

重新分片期间进行的索引构建可能会静默失败。

• 请勿在重新分片进程创建索引。

• 如果正在进行索引构建，请勿启动重新分片进程。

对进程重新分片

在集合重新分片操作中，分片可以是：

• 发送分片，它目前存储分片集合的数据段。

• 接收分片，它根据分片键和区域存储分片集合的新数据段。

分片可以同时是发送分片和接收分片。除非您使用区域，否则发送分片集与接收分片相同。

配置服务器主节点始终是重新分片协调器，并启动重新分片操作的每个阶段。

例子

db.adminCommand({
  reshardCollection: "sales.orders",
  key: { order_id: 1 }
})

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp(1, 1624887954),
    signature: {
      hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0),
      keyId: 0
    }
  },
  operationTime: Timestamp(1, 1624887947)
}