sh.unshardCollection
定义
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对集合进行取消分片时,会将集合数据从当前分片移动到此特定分分片。 |
兼容性
此方法可用于以下环境中托管的部署:
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
重要
此命令不能在共享实例或无服务器实例上运行。 有关更多信息,请参阅不支持的命令。
Considerations
sh.unshardCollection()
只能在分分片的集群上运行。sh.unshardCollection()
只能对分分片的集合进行操作。sh.unshardCollection()
一次只能对一个集合进行操作。sh.unshardCollection()
最短持续时间为5分钟。您必须在
sh.unshardCollection()
运行后重建Atlas Search索引。在
sh.unshardCollection()
完成之前,您无法进行拓扑结构更改,例如添加或删除分片或在嵌入式配置服务器和专用配置服务器之间转换。当
sh.unshardCollection()
正在进行时,您无法对正在取消分片的集合运行以下操作:unshardCollection
正在进行时,您无法对集群运行以下操作:在
sh.unshardCollection()
正在进行时进行的索引构建可能会静默失败。正在进行
sh.unshardCollection()
时,请勿创建索引。如果正在进行索引构建,请勿调用
sh.unshardCollection()
。
要求
在对集合取消分片之前,请确保满足以下要求:
您的应用程序可以允许受影响的集合块进行两秒钟的写入。 在写入受阻期间,应用程序的延迟会增加。
您的数据库符合这些资源要求:
确保分片集合移动到的分片具有足够的存储空间用于集合及其索引。 目标分分片需要至少
( Collection storage size + Index Size ) * 2
字节可用。确保 I/O容量低于50 %。
确保 CPU 负载低于80 %。
示例
此示例将app
数据库上名为inventory
的集合取消分片到shard02
分分片。
sh.unshardCollection( "app.inventory", "shard02" )
要获取可用分分片ID 的列表,请运行sh.status()
。 有关详细信息,请参阅sh.status() 输出。