sh.moveRange()（mongoshメソッド）

定義

sh.moveRange(namespace, toShard, min, max)

6.0バージョン の新機能。:

範囲をシャード間で範囲を移動します。

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

データベースコマンドについては、moveRange コマンドを参照してください。

MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。

互換性

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

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

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

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

構文

sh.moveRange(namespace, toShard, min, max)

sh.moveRange() メソッドは次のパラメータを取ります。

例

次の例では、以下を含むコレクションを使用しています。

• 郵便番号を表すシャードキー postal。

• 70007 と 70124 を境界とする範囲。

書き込み範囲を shard02 に移動するには、次のメソッドを実行します。

sh.moveRange(
   "contacts.addresses", "shard02",
   { postal: 70007 },
   { postal: 70124 }
)

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1742507819, i: 42 }),
    signature: {
      hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0),
      keyId: Long('0')
    }
  },
  operationTime: Timestamp({ t: 1742507819, i: 42 })
}