moveRange（数据库命令）

定义

moveRange: 6.0版本新增。
Moves ranges between shards. Run the moveRange command with a mongos instance while using the admin database.
提示
In mongosh, this command can also be run through the sh.moveRange() 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 Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

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

语法

该命令具有以下语法：

db.adminCommand(
  {
    moveRange: <namespace>,
    toShard: <ID of the recipient shard>,
    min: <min key of the range to move>, // conditional
    max: <max key of the range to move>, // conditional
    forceJumbo: <bool>, // optional
    writeConcern: <write concern>, // optional
    secondaryThrottle: <bool> // optional
  }
)

命令字段

该命令接受以下字段：

字段	类型	说明
`toShard`	字符串	接收分片的 ID。
`min`	key	要移动范围的最小键。如果不指定`max` ，则为必填项。如果未指定`min` ，则给定数据段`C` ，其中`max`是`C`的独占上边界或`C`包含分片键`max` ，则`min`通过以下方式确定: 如果`min(C)`和`max`之间范围的数据大小小于每个collection的数据块大小或默认数据块大小，则选择该数据块的`min`值，因为`min` = `min(C)` 。否则，键`min` > `min(C)` ，其中`min`取决于配置的数据块大小。
`max`	key	要移动范围的最大键。如果不指定`min` ，则为必填项。如果不指定`max` ，则给定包含分片键`min`的数据块`C` ，则按以下方式确定`max` ：如果`min`和`max(C)`之间范围的数据大小小于每个collection的数据块大小或默认数据块大小，则选择该数据块的最大值为`max` = `max(C)` 。否则，密钥`max` < `max(C)` ，其中`max`取决于配置的数据块大小。
forceJumbo	布尔	可选。确定命令是否可以移动过大而无法迁移的范围的标志。该范围可能会也可能不会标记为jumbo。如果为`true` ，则该命令可以移动范围。如果为`false` ，则该命令无法移动范围。默认为 `false`。警告：附带 `forceJumbo=true` 的 `moveRange` 命令会阻止集合上的写入操作。此选项会导致分片迁移数据段，即使数据段大于配置的数据块大小。在迁移期间，该集合仍然不可写入。要在没有这么长的阻塞期的情况下迁移这些大数据段，请参阅平衡超出大小限制的范围。
`writeConcern`	文档	可选。具有写关注（write concern）的文档。默认值为`w: majority` 。
`secondaryThrottle`	布尔	可选。如果`true` ，则数据块迁移期间的每个文档移动都会传播到至少一个从节点，然后负载均衡器才会继续处理下一个文档。这相当于`{ w: 2 }`的写关注（write concern）。使用`writeConcern`选项指定不同的写关注（write concern）。如果为`false` ，负载均衡器不会等待复制到从节点，而是继续处理下一个文档。有关更多信息，请参阅辅助限制。

范围迁移部分描述了范围如何在 MongoDB 上的分片之间移动。

Considerations

Only use the moveRange in scenarios like:

初始数据摄取
大批量导入操作

在大多数情况下，允许负载均衡器在分片集群中创建和平衡范围。

提示

在分片集群中创建范围

示例

以下示例使用具有以下内容的collection：

片键 x
已配置数据块大小为 128 MB
有边界的数据块： [x: 0, x: 100)

同时指定`min` 和`max`

下表列出将min和max设置为各种值的结果：

`min`	`max`	结果
`0`	`100`	将范围内的所有文档移至接收分片。
`10`	`30`	创建三个子范围： `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` 将`[x: 10, x: 30)`中的所有文档移至接收分片。
`0`	`20`	创建两个子范围： `[x: 0, x: 20)` `[x: 20, x: 100)` 将`[x: 0, x: 20)`中的所有文档移至接收分片。
`40`	`100`	创建两个子范围： `[x: 0, x: 40)` `[x: 40, x: 100)` 将`[x: 40, x: 100)`中的所有文档移至接收分片。

指定 `min` 但不指定 `max`

下表列出了将min设置为各种值的结果：

`min`	键范围内的数据量	结果
`0`	键`x: 0`和`x: 100`之间包含的大小小于 128 MB。	将范围内的所有文档移至接收分片。
`10`	键`x: 0`和`x: 100`之间包含的大小小于 128 MB。	创建两个子范围： `[x: 0, x: 10)` `[x : 10, x: 100)` 将`[x: 10, x: 100)`中的所有文档移至接收分片。
`10`	键`x: 10`和`x: 30`之间包含 128 MB。	创建三个子范围： `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` 将`[x: 10, x: 30)`中的所有文档移至接收分片。

指定 `max` 但不指定 `min`

下表列出了将max设置为各种值的结果：

`max`	键范围内的数据量	结果
`100`	键`x: 0`和`x: 100`之间包含的大小小于 128 MB。	将范围内的所有文档移至接收分片。
`10`	键`x: 0`和`x: 100`之间包含的大小小于 128 MB。	创建两个子范围： `[x: 0, x: 10)` `[x : 10, x: 100)` 将`[x: 0, x: 10)`中的所有文档移至接收分片。
`30`	键`x: 10`和`x: 30`之间包含 128 MB。	创建三个子范围： `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` 将`[x: 10, x: 30)`中的所有文档移至接收分片。

moveRange（数据库命令）

定义

兼容性

语法

命令字段

Considerations

示例

同时指定min 和max

指定 min 但不指定 max

指定 max 但不指定 min

同时指定`min` 和`max`

指定 `min` 但不指定 `max`

指定 `max` 但不指定 `min`