moveRange

在此页面上

定义

兼容性
语法
命令字段
Considerations
示例

定义

moveRange: 6.0 版本中的新功能。
在分片之间移动个范围。moveRangemongos使用管理员数据库时，通过实例运行命令。

兼容性

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

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
    waitForDelete: <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

仅在以下情况下使用moveRange ：

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

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

提示

另请参阅：

在分片集群中创建范围

示例

以下示例使用具有以下内容的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)`中的所有文档移至接收分片。

后退

movePrimary

来年

mergeChunks

定义

兼容性

注意

语法

命令字段

Considerations

提示

另请参阅：

示例

同时指定min 和max

指定min 但不指定max

指定max 但不指定min

同时指定`min` 和`max`

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

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