Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

sh.unshardCollection

在此页面上

  • 定义
  • 语法
  • 兼容性
  • Considerations
  • 要求
  • 示例
  • 了解详情
sh.unshardCollection( namespace, shardID )

对现有分分片的集合进行取消分片,并将集合数据移动到单个分片片上。 当您对集合取消分片时,无法将该集合跨多个分片进行分区,并且分片分片键将被删除。

8.0版本新增

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序(例如 Node.js)的相关文档。

有关数据库命令,请参阅 unshardCollection 命令。

如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。

sh.unshardCollection方法要求您指定分片集合数据的分片。 使用unshardCollection命令时,如果未指定目标分分片,集群会自动选择数据分片的分片。

注意

对集合取消分片是一项写入密集型操作,可能会导致oplog增长率加快。 为帮助缓解此问题,请考虑对配置进行以下更改:

  • 要防止oplog无限制增长,请设立固定的oplog大小。

  • 要降低从节点过时的可能性,请增加oplog的大小。

有关更多详细信息,请参阅副本集oplog 。

sh.unshardCollection 通过以下语法实现:

sh.unshardCollection( namespace, shardID )
Parameter
类型
说明
namespace
字符串
指定要取消分片的数据库和集合。
shardID
字符串
指定接收分分片ID。 当MongoDB对集合进行取消分片时,会将集合数据从当前分片移动到此特定分分片。

此方法可用于以下环境中托管的部署:

重要

此命令不能在共享实例或无服务器实例上运行。 有关更多信息,请参阅不支持的命令。

在对集合取消分片之前,请确保满足以下要求:

  • 您的应用程序可以允许受影响的集合块进行两秒钟的写入。 在写入受阻期间,应用程序的延迟会增加。

  • 您的数据库符合这些资源要求:

    • 确保分片集合移动到的分片具有足够的存储空间用于集合及其索引。 目标分分片需要至少( Collection storage size + Index Size ) * 2字节可用。

    • 确保 I/O容量低于50 %。

    • 确保 CPU 负载低于80 %。

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

sh.unshardCollection( "app.inventory", "shard02" )

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

后退

sh.stopBalancer