sh.removeRangeFromZone()

定義

sh.removeRangeFromZone(namespace, minimum, maximum)

シャードキー値の範囲とゾーンの間の関連付けを削除します。

sh.removeRangeFromZone() は、次のフィールドがあります。

Parameter	タイプ	説明
namespace	string	ゾーンに関連付けるシャーディングされたコレクションの名前空間。 操作を成功させるには、コレクションをシャーディングする必要があります。
minimum	ドキュメント	シャードキー値の範囲の包括的下限。 シャードキーの各フィールドを<fieldname> : <value>の形式で指定します。 値は、シャードキーと同じ BSON type である必要があります。
maximum	ドキュメント	シャードキー値の範囲の排他的上限。 シャードキーの各フィールドを<fieldname> : <value>の形式で指定します。 値は、シャードキーと同じ BSON type である必要があります。

未使用、期限切れ、または競合するシャードキー範囲とゾーンの間の関連付けを削除するには、 sh.removeRangeFromZone()を使用します。

sh.removeRangeFromZone()に渡される最小境界と最大境界に一致する範囲がない場合、削除されるものはありません。

mongosインスタンスに接続している場合にのみsh.removeRangeFromZone()を実行します。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

sh.removeRangeFromZone() では、ゾーンとシャードの間の関連付けは削除されません。 また、ゾーン自体は削除されません。

シャーディングされたクラスター内のゾーンの詳細については、ゾーンのマニュアル ページを参照してください。

例

シャーディングされたコレクションexampledb.collectionとシャードキーが{ a : 1 }の場合、次の操作を実行すると下限が1で上限が10の範囲が削除されます。

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

minとmaxは、ターゲット範囲の境界と完全に一致する必要があります。 次の操作は、以前に作成した範囲を削除しようとしますが、 minの限界として{ a : 0 }を指定します。

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 }
              )