moveCollection

定义

moveCollection

8.0版本新增。

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

兼容性

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

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

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

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

限制

不能将moveCollection用于：

• 时间序列集合。

• Queryable Encryption集合。

语法

该命令具有以下语法：

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

命令字段

该命令接受以下字段：

Considerations

• moveCollection 只能在分分片的集群上运行。

• moveCollection 只能移动未分片的集合。

• moveCollection 一次只能移动一个集合。

• moveCollection 最短持续时间为5分钟。

• 在moveCollection运行后， Atlas Search索引需要重新构建。

• 在moveCollection完成之前，您无法进行拓扑结构更改，例如添加或删除分片或在嵌入式和专用配置服务器之间进行转换。

• 当moveCollection正在进行时，您无法对正在移动的集合运行以下操作：

  • collMod

  • convertToCapped

  • createIndexes

  • db.collection.createIndexes()

  • drop

  • db.collection.drop()

  • dropIndexes

  • db.collection.dropIndex()

  • renameCollection

  • db.collection.renameCollection()

• moveCollection正在进行时，您无法对集群运行以下操作：

  • addShard

  • removeShard

  • db.createCollection()

  • dropDatabase

  • transitionToDedicatedConfigServer

  • transitionFromDedicatedConfigServer

• 在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() 输出。

了解详情

• 可移动集合

• sh.moveCollection()