removeShard（数据库命令）

定义

removeShard

警告

从MongoDB 8.3 开始，removeShard 命令已弃用，并将在未来发布中删除。

分片排干进程已替换为以下命令：

分片耗尽后，您可以使用 commitShardRemoval 命令将其删除。

有关详细信息，请参阅从分片集群中删除分片。

从分片集群中删除分片。当您运行removeShard 时， MongoDB会使用负载均衡器将该分分片移动到集群中的其他分片，从而清空该分片。

注意

必须启用负载均衡器，removeShard 才能完成。如果禁用负载均衡器，则即使您已经将所有数据移出分片，该命令仍处于排干状态并且无法完成。

如果分片具有未分片集合，则必须从分片清空所有未分片集合。从MongoDB 8.0 开始，您可以使用 sh.moveCollection() 移动未分片的集合。有关分片过程的详细信息，请参阅从分片集群中删除分片。

一旦分片被清空， MongoDB就会从集群中删除分片。

注意

如果要将已删除的分片重新添加到分片集群，则必须清除该分片的所有节点的storage.dbPath 以删除该分片的文件，然后才能重新添加。

兼容性

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

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

注意

MongoDB Atlas不支持此命令。请参阅修改Atlas分片集群以在Atlas 集群中添加或删除分片。

语法

该命令具有以下语法：

db.adminCommand(   {     removeShard : <shardToRemove>   })

行为

在分片删除期间没有集群备份

在删除分片期间无法备份集群数据。

并发 `removeShard` 操作

您可以有多个正在进行的removeShard操作。

访问要求

如果已启用authorization ，则必须具有clusterManager角色或任何包含removeShard操作的角色。

数据库迁移要求

分分片集群中的每个数据库都有一个主分片。如果要删除的分片也是集群数据库的主节点 (primary node in the replica set)分片，则必须在迁移该分片的所有数据后，手动将数据库移动到新分片分片。有关更多信息，请参阅movePrimary命令和从分片集群中删除分片。

数据块均衡

当您从集群中删除数据段分布不均匀的分片时，负载均衡器首先从要清空的分片中删除数据段，然后均衡剩余的不均匀数据段分布。

提示

balancerCollectionStatus

写关注

mongos将命令的 removeShard写关注转换为 "majority" 。

Change Streams

删除分分片可能会导致打开的变更流游标关闭，并且关闭的变更流游标可能无法完全恢复。

DDL 操作

如果您在集群执行 DDL 操作（修改集合，如reshardCollection的操作）时运行removeShard ，则removeShard仅在并发 DDL 操作完成后才会执行。

例子

从mongosh开始， removeShard操作类似于以下内容：

db.adminCommand( { removeShard : "bristol01" } )

将bristol01替换为要删除的分片的名称。当您运行removeShard时，该命令会返回一条类似于以下内容的消息：

{   "msg" : "draining started successfully",   "state" : "started",   "shard" : "bristol01",   "note" : "you need to call moveCollection for collectionsToMove and afterwards movePrimary for the dbsToMove",   "dbsToMove" : [      "fizz",      "buzz"   ],   "collectionsToMove" : [      "fizz.coll1",      "buzz.coll1"   ],   "ok" : 1,   "operationTime" : Timestamp(1575398919, 2),   "$clusterTime" : {      "clusterTime" : Timestamp(1575398919, 2),      "signature" : {         "hash" : BinData(0,"Oi68poWCFCA7b9kyhIcg+TzaGiA="),         "keyId" : Long("6766255701040824328")      }   }}

负载均衡器开始将数据块从名为 bristol01 的分片迁移（“排干”）到集群中的其他分片。迁移很慢，以避免给集群带来过度的负载。

如果再次运行该命令， removeShard将返回进程的当前状态。例如，如果操作处于ongoing状态，则命令返回类似于以下内容的输出：

{   "msg" : "draining ongoing",   "state" : "ongoing",   "remaining" : {      "chunks" : Long(2),      "dbs" : Long(2),      "jumboChunks" : Long(0),      "collectionsToMove": Long(2)   },   "note" : "you need to call moveCollection for collectionsToMove and afterwards movePrimary for the dbsToMove",   "dbsToMove" : [      "fizz",      "buzz"   ],   "collectionsToMove" : [      "fizz.coll1",      "buzz.coll1"   ],   "ok" : 1,   "operationTime" : Timestamp(1575399086, 1655),   "$clusterTime" : {      "clusterTime" : Timestamp(1575399086, 1655),      "signature" : {         "hash" : BinData(0,"XBrTmjMMe82fUtVLRm13GBVtRE8="),         "keyId" : Long("6766255701040824328")      }   }}

在输出中，remaining 字段包括以下字段：

字段	说明
`chunks`	分片当前剩余的数据段总数。
`dbs`	主分片是分片的数据库总数。这些数据库在 `dbsToMove` 输出字段中指定。
`jumboChunks`	在`chunks`的总数中，该数字是巨型数据。如果 `jumboChunks` 大于 0，则等到分片上只剩下 `jumboChunks`。一旦只剩下巨型块，必须手动清除巨型标志，然后才能完成排干。请参阅清除巨型标志。清除 `jumbo` 标记后，负载均衡器可以迁移这些数据段。有关迁移过程的详细信息，请参阅范围迁移过程。
`collectionsToMove`	需要从分片移动的未分片集合的总数。
`estimatedRemainingBytes`	正在移除的分片上估计剩余字节数。

运行 transitionToDedicatedConfigServer 时，removeShard 输出可能包括以下字段。这些字段仅在负载均衡器将所有数据块和数据库从配置服务器移出后才会出现：

字段	说明
`pendingRangeDeletions`	正在移除的分片上剩余的待处理范围删除数量。
`firstNonEmptyCollection`	正在移除的分片上的第一个非空集合。

继续检查 removeShard 命令的状态（即重新运行该命令），直到剩余数据块的数量为 0。

{   "msg" : "draining ongoing",   "state" : "ongoing",   "remaining" : {      "chunks" : Long(0),             // All chunks have moved      "dbs" : Long(2),      "jumboChunks" : Long(0),      "collectionsToMove": Long(2)   },   "note" : "you need to call moveCollection for collectionsToMove and afterwards movePrimary for the dbsToMove",   "dbsToMove" : [      "fizz",      "buzz"   ],   "collectionsToMove" : [      "fizz.coll1",      "buzz.coll1"   ],   "ok" : 1,   "operationTime" : Timestamp(1575400343, 1),   "$clusterTime" : {      "clusterTime" : Timestamp(1575400343, 1),      "signature" : {         "hash" : BinData(0,"9plu5B/hw4uWAgEmjjBP3syw1Zk="),         "keyId" : Long("6766255701040824328")      }   }}

负载均衡器从分片清空所有数据段后，您可能需要手动将集合和数据库从已清空的分片移出。

如果 removeShard 输出包含 collectionsToMove字段中的集合，则使用 moveCollection 将这些集合移动到排干分片以外的分片或删除集合（这会删除关联的数据文件）。

如果 removeShard 输出包含 dbsToMove字段中的数据库，则对这些数据库使用 movePrimary 或删除数据库（这会删除关联的数据文件）。

注意

为获得最佳性能，请在移动数据库之前移动集合。

在负载均衡器完成将所有数据段移出分片并且您处理完 dbsToMove 和 collectionsToMove 后，removeShard 即可完成。removeShard再次运行会返回类似于以下内容的输出：

{   "msg" : "removeshard completed successfully",   "state" : "completed",   "shard" : "bristol01",   "ok" : 1,   "operationTime" : Timestamp(1575400370, 2),   "$clusterTime" : {      "clusterTime" : Timestamp(1575400370, 2),      "signature" : {         "hash" : BinData(0,"JjSRciHECXDBXo0e5nJv9mdRG8M="),         "keyId" : Long("6766255701040824328")      }   }}