moveCollection（数据库命令）

定义

moveCollection: 8.0版本新增。
将单个未分片集合移动到不同的分分片。 moveCollectionmongos使用管理员数据库时，通过实例运行。

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

重要

This command is not supported in M0 and Flex clusters. For more information, see Unsupported Commands.

不能将 moveCollection 用于Queryable Encryption集合。

该命令具有以下语法：

db.adminCommand(
  {
    moveCollection: "<database>.<collection>",
    toShard: "<ID of the recipient shard>",
  }
)

注意

使用 listShards 命令检索接收分片的ID 。

该命令接受以下字段：

字段	类型	说明
`moveCollection`	字符串	要移动的数据库和集合名称。
`toShard`	字符串	接收分片的 ID。

moveCollection 只能在分分片的集群上运行。
moveCollection 只能移动未分片的集合。
moveCollection 一次只能移动一个集合。
moveCollection 最短持续时间为5分钟。
writeConcernMajorityJournalDefault 必须为 true。
要移动具有唯一性约束的集合，新索引必须满足任何现有唯一索引的唯一索引要求。
如果要移动的集合使用MongoDB Search，则其搜索索引在 moveCollection 完成后将不可用。您必须手动重建搜索索引。
If the collection you're moving is archived in Atlas Online Archives, the online archive files are marked as Orphaned once the moving operation completes. You can create another online archive for the same database, collection, and fields as the orphaned archive as long as there is no other archive for that same combination in the Active state.
在moveCollection完成之前，您无法进行拓扑结构更改，例如添加或删除分片或在嵌入式和专用配置服务器之间进行转换。
当moveCollection正在进行时，您无法对正在移动的集合运行以下操作：
moveCollection正在进行时，您无法对集群运行以下操作：
在moveCollection正在进行时进行的索引构建可能会静默失败。
- 正在进行moveCollection时，请勿创建索引。
- 如果正在进行索引构建，请勿调用moveCollection 。

在移动集合之前，请确保满足以下要求：

您的应用程序可以允许受影响的集合块进行两秒钟的写入。在写入受阻期间，应用程序的延迟会增加。
您的数据库符合这些资源要求：
- 确保分片集合移动到的分片具有足够的存储空间用于集合及其索引。目标分分片需要至少( Collection storage size + Index Size ) * 2字节可用。
- 确保 I/O容量低于50 %。
- 确保 CPU 负载低于80 %。

重要

数据库不会强制执行这些要求。未能分配足够的资源可能会导致：

如果应用程序存在流量较少的时间段，请尽可能在该时间段对集合执行此操作。

此示例将app数据库上名为inventory的未分片集合移动到shard02分分片。

db.adminCommand(
  {
    moveCollection: "app.inventory",
    toShard: "shard02"
  }
)

要获取可用分分片ID 的列表，请运行sh.status() 。有关详细信息，请参阅sh.status() 输出。