removeShardFromZone

在本页面

• Definition

• Syntax

• Behavior

• Example

Definition

• removeShardFromZone
  • 3.4 版的新功能。

removeShardFromZoneManagement 命令删除分片和zone之间的关联。

Syntax

您只能从mongos实例在admin数据库上运行removeShardFromZone。

removeShardFromZone命令具有以下语法：

db.adminCommand(
   {
     removeShardFromZone: <string>,
     zone: <string>
   }
)

该命令包含以下字段：

Field	Type	Description
removeShardFromZone	string	从中删除zone关联的分片的名称。
zone	string	要与shard关联的区域名称。

mongo shell 提供了辅助方法sh.removeShardFromZone()。

Behavior

removeShardFromZone不会删除与区域关联的范围。

要从集群中完全删除区域，必须在与该区域关联的每个分片上运行removeShardFromZone。

如果指定的分片是与该区域关联的最后一个分片，则必须确保没有与该区域关联的剩余分片密钥范围。在运行removeShardFromZone之前，使用updateZoneKeyRange删除与该区域关联的所有现有范围。

有关分片群集中区域的更多信息，请参见zone手册页。

Security

对于实施access control的分片群集，您必须通过以下方式之一进行身份验证：

• 具有以下特权的用户：

• config数据库中shards集合上的update，以及

  • config数据库中tags集合上的find；

or, alternatively

• 特权包括cluster资源上的enableSharding的用户(从版本 3.6.16 开始可用)。

内置clusterAdmin或clusterManager角色具有发布removeShardFromZone的适当权限。有关更多信息，请参见基于角色的访问控制手册页。

Example

以下示例删除了shard0000和区域NYC之间的关联：

db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )