sh.reshardCollection()

定义

sh.reshardCollection(namespace, key, unique, options)

版本 5.0 中的新增功能。

sh.reshardCollection()方法更改集合的分片键并更改数据的分布。

在对集合重新分片之前，请阅读重新分片要求和重新分片限制。

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序（例如 Node.js）的相关文档。

有关数据库命令，请参阅 reshardCollection 命令。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

sh.reshardCollection()接受以下字段：

字段	类型	说明
namespace	字符串	要分片的集合的命名空间，格式为 "<database>.<collection>"。
key	文档	指定用作分片键的一个或多个新字段的文档。 { <field1>: <1|"hashed">, ... } 将字段值设置为以下任一项： 1用于基于范围的分片 "hashed"指定哈希分片键。 另请参阅分片键索引
unique	布尔	可选。 指定分片键是否有唯一性约束。 仅支持false 。 默认为false 。
options	文档	可选。 包含可选字段的文档，这些字段包括numInitialChunks 、 collation和zones 。

options字段支持以下字段：

字段	类型	说明
numInitialChunks	整型	可选。 指定对集合重新分片时要在集群中所有分片中创建的数据段的初始数量。 默认值为 90。 然后， MongoDB将在集群中创建并均衡数据段。 numInitialChunks 的结果必须小于每个分片的 8192。 如果看到错误“提供的分片键没有足够的关联基数来制作所需数量的数据段”，请使用较低的 numInitialChunks 值对集合重新分片。
collation	文档	可选。如果指定给 reshardCollection 的集合具有默认排序规则，则必须包含附带 { locale : "simple" } 的排序规则文档，否则 reshardCollection 命令将失败。
zones	阵列	可选。 指定集合的区域。 要维护或添加区域，请在大量中指定集合的区域： [ {s min: <document with same shape as shardkey>, max: <document with same shape as shardkey>, zone: <string> | null }, ... ]

兼容性

此方法可用于以下环境中托管的部署：

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

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

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

Considerations

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

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

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

对进程重新分片

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

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

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

分片可以同时是发送分片和接收分片。

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

示例

sh.reshardCollection( "sales.orders", { order_id: 1 } )

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

sh.addShardToZone( "shard2", "NewZone" )
sh.addShardToZone( "shard3", "NewZone" )

sh.reshardCollection(
  "test.scores",
  { "studentId": 1, "testId": 1},
  { zones: [ {
    min: { "studentId": MinKey(), "testId": MinKey() },
    max: { "studentId": MaxKey(), "testId": MaxKey() },
    zone: "NewZone" }
    ]
} )

{
   ok: 1,
   '$clusterTime': {
   clusterTime: Timestamp( { t: 1699484530, i: 54 } ),
   signature: {
   hash: Binary.createFromBase64( "90ApBDrSSi4XnCpV3OWIH4OGO0Y=", 0 ),
   keyId: Long( "7296989036055363606" )
   } },
   operationTime: Timestamp( { t: 1699484530, i: 54 } )
}