sh.removeRangeFromZone()

Definition定义

sh.removeRangeFromZone(namespace, minimum, maximum)

Removes the association between a range of shard key values and a zone.删除一系列分片键值和区域之间的关联。

sh.removeRangeFromZone() takes the following arguments:采用以下参数：

Parameter参数	Type类型	Description描述
namespace	string	The namespace of the sharded collection to associate with the zone.要与区域关联的分片集合的命名空间。 The collection must be sharded for the operation to succeed. 必须对集合进行分片，操作才能成功。
minimum	document	The inclusive lower bound of the range of shard key values.分片键值范围的包含下限。 Specify each field of the shard key in the form of <fieldname> : <value>. 以<fieldname> : <value>的形式指定分片键的每个字段。The value must be of the same BSON type or types as the shard key. 该值必须与分片键具有相同的BSON类型。
maximum	document	The exclusive upper bound of the range of shard key values.分片键值范围的独占上限。 Specify each field of the shard key in the form of <fieldname> : <value>. 以<fieldname> : <value>的形式指定分片键的每个字段。The value must be of the same BSON type or types as the shard key. 该值必须与分片键具有相同的BSON类型。

Use sh.removeRangeFromZone() to remove the association between unused, out of date, or conflicting ranges and a zone.使用sh.removeRangeFromZone()可以删除未使用、过期或冲突的范围与区域之间的关联。

If no range matches the minimum and maximum bounds passed to removeShardFromZone(), nothing is removed.如果没有任何范围与传递给removeShardFromZone()的最小和最大边界匹配，则不会删除任何内容。

Only issue sh.removeTagRange() when connected to a mongos instance.仅在连接到mongos实例时发出sh.removeTagRange()。

Behavior行为

sh.removeShardFromZone() does not remove the zone associated to the specified range.不会删除与指定范围关联的区域。

See the zone manual page for more information on zones in sharded clusters.有关分片集群中区域的更多信息，请参阅区域手册页面。

Example实例

Given a sharded collection exampledb.collection with a shard key of { a : 1 }, the following operation removes the range with a lower bound of 1 and an upper bound of 10:给定一个分片集合exampledb.collection，其分片键为{ a : 1 }，以下操作将删除下限为1、上限为10的范围：

sh.removeRangeFromZone( "exampledb.collection",
                { a : 1 },
                { a : 10 }
              )

The min and max must match exactly the bounds of the target range. min和max必须与目标范围的边界完全匹配。The following operation attempts to remove the previously created range, but specifies { a : 0 } as the min bound:以下操作尝试删除以前创建的范围，但将{ a : 0 }指定为min绑定：

admin = db.getSiblingDB("admin")
admin.runCommand(
   {
      updateZoneKeyRange : "exampledb.collection",
      min : { a : 0 },
      max : { a : 10 },
      zone : null
   }
)

While the range of { a : 0 } and { a : 10 } encompasses the existing range, it is not an exact match and therefore sh.removeRangeFromZone() does not remove anything.虽然{ a : 0 }和{ a : 10 }的范围包含现有范围，但它并不完全匹配，因此sh.removeRangeFromZone()不会删除任何内容。

sh.removeRangeFromZone( "exampledb.collection",
                { a : 1, b : 1 },
                { a : 10, b : 10 }
              )