moveChunk

定义

moveChunk

内部管理命令。 在 分片 之间 移动 数据段。使用 管理员数据库moveChunk mongos时，通过 实例发出 命令。使用以下形式：

提示

在 mongosh 中，该命令也可通过 sh.moveChunk() 辅助方法运行。

辅助方法对 mongosh 用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

db.adminCommand( { moveChunk : <namespace> ,
                 find : <query> ,
                 to : <string>,
                 forceJumbo: <boolean>,
                 _secondaryThrottle : <boolean>,
                 writeConcern: <document>,
                 _waitForDelete : <boolean> } )

或者：

db.adminCommand( { moveChunk : <namespace> ,
                 bounds : <array> ,
                 to : <string>,
                 forceJumbo: <boolean>,
                 _secondaryThrottle : <boolean>,
                 writeConcern: <document>,
                 _waitForDelete : <boolean> } )

moveChunk 命令拥有以下字段：

字段	类型	说明
moveChunk	字符串	数据块 所在 collection的 命名空间 。指定集合的完整命名空间，包括数据库名称。
find	文档	分片键的等值匹配，用于指定要移动的数据段的分片键值。 指定bounds字段或find字段，但不能同时指定两者。 请勿使用find字段来选择使用哈希分片键的集合中的数据段。
bounds	阵列	要移动的特定数据块的边界。该数组必须由两个文档组成，这两个文档指定要移动的数据段的下分片键值和上分片键值。 指定bounds字段或find字段，但不能同时指定两者。 使用bounds选择使用哈希分片键的collection中的数据块。
to	字符串	数据段的目标分片的名称。
forceJumbo	布尔	可选。 一个标志，用于确定该命令是否可以移动过大而无法迁移的数据块。该数据段可能会也可能不会标记为jumbo。 如果为true ，则该命令可以移动数据块。 如果为false ，则该命令无法移动数据块。 默认为 false。 警告： 带有forceJumbo=true的moveChunk命令会阻止对集合的读取和写入操作。 此选项会导致分片迁移数据段，即使数据段大于配置的数据段大小。 该集合在迁移期间保持不可用状态。 要在没有这么长的阻塞期的情况下迁移这些大数据段，请参阅平衡超出大小限制的范围。
_secondaryThrottle	布尔	可选。 对于WiredTiger ，默认为false 。 如果true ，则默认情况下，数据段迁移期间的每个文档移动都会传播到至少一个从节点，然后负载均衡器才会继续处理下一个文档。 这相当于 写关注（write{ w: 2 } concern）的。 使用writeConcern选项指定不同的写关注（write concern）。 如果为false ，负载均衡器不会等待复制到从节点，而是继续处理下一个文档。 有关更多信息，请参阅辅助限制。
writeConcern	文档	可选。 一个表达写关注（write concern）的文档，在数据块迁移期间， _secondaryThrottle将使用该写关注（write concern）来等待从节点。 writeConcern 需要_secondaryThrottle: true 。
_waitForDelete	布尔	可选。 用于测试目的的内部选项。 默认值为false 。 如果设置为true ，则moveChunk操作的删除阶段会阻塞。

bounds的值采用以下形式：

[ { hashedField : <minValue> } ,
  { hashedField : <maxValue> } ]

数据块迁移部分描述了数据块如何在 MongoDB 上的分片之间移动。

兼容性

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

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

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

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

Considerations

仅在特殊情况下使用moveChunk ，例如为初始数据摄取或大批量导入操作准备分片集群。 在大多数情况下，允许负载均衡器在分片集群中创建和均衡数据段。 有关更多信息，请参阅在分片集群中创建范围。

行为

errmsg: "The collection's metadata lock is already taken."