sh.removeRangeFromZone()（mongosh方法）

定义

sh.removeRangeFromZone(namespace, minimum, maximum)

删除一系列分片键值与区域之间的关联。

sh.removeRangeFromZone() 采用以下字段：

Parameter	类型	说明
namespace	字符串	与区域关联的分片collection的命名空间。 必须对集合进行分片才能使操作成功。
minimum	文档	分片键值范围的下限（含）。 以<fieldname> : <value>的形式指定分片键的每个字段。 该值必须与分片键具有相同的 BSON 类型。
maximum	文档	分片键值范围的独占上限。 以<fieldname> : <value>的形式指定分片键的每个字段。 该值必须与分片键具有相同的 BSON 类型。

使用sh.removeRangeFromZone()删除未使用、已过期或有冲突的分片键范围与区域之间的关联。

如果没有范围与传递给sh.removeRangeFromZone()的最小和最大边界匹配，则不会删除任何内容。

仅在连接到mongos实例时运行sh.removeRangeFromZone() 。

兼容性

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

行为

sh.removeRangeFromZone() 不会删除区域和分片之间的关联。 它也不会删除区域本身。

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

例子

给定一个分片键为{ a : 1 }的分片collectionexampledb.collection ，以下操作删除下限为1且上限为10的范围：

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

min和max必须与目标范围的边界完全匹配。 以下操作尝试删除之前创建的范围，但将{ a : 0 }指定为min边界：

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

虽然{ a : 0 }和{ a : 10 }的范围包含现有范围，但它不是精确匹配，因此sh.removeRangeFromZone()不会删除任何内容。

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