moveRange（データベースコマンド）

このバージョンのドキュメントはアーカイブされており、サポートされなくなりました。6.0 配置をアップグレードするには、 MongoDB 7.0 のアップグレード手順を参照してください。

定義

moveRange: バージョン 6.0 で追加。
シャード間での範囲を移動します。moveRangemongos管理データベースを使用しながら、インスタンスでコマンドを実行します。
Tip
mongoshでは、このコマンドはsh.moveRange()ヘルパーメソッドを通じて実行することもできます。
ヘルパーメソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、データベースコマンドを使用します。

互換性

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

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

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

このコマンドの構文は、次のとおりです。

db.adminCommand(
  {
    moveRange: <namespace>,
    toShard: <ID of the recipient shard>,
    min: <min key of the range to move>,
    max: <max key of the range to move>, // optional
    forceJumbo: <bool>, // optional
    writeConcern: <write concern>, // optional
    secondaryThrottle: <bool> // optional
  }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

フィールド	タイプ	説明
`toShard`	string	受信者シャードの ID。
`min`	キー	移動する範囲の最小キー。
`max`	キー	任意。移動する範囲の最大キー。 `max`を指定しない場合、シャードキー`min`を含むチャンク`C`がある場合、 `max`は次のように決定されます。 `min`から`max(C)`の範囲のデータサイズが、コレクションごとのチャンクサイズまたはデフォルトのチャンクサイズより小さい場合、チャンクの最大値は`max` = `max(C)`として選択されます。それ以外の場合、キー`max` < `max(C)`は、 `max`が構成されたチャンクサイズによって異なります。
forceJumbo	ブール値	任意。コマンドが移行するには大きすぎる範囲を移動できるかどうかを決定するフラグです。その範囲にはジャンボというラベルが付いている場合と付いていない場合があります。 `true`の場合、コマンドは範囲を移動できます。 `false`の場合、コマンドは範囲を移動できません。デフォルトは `false` です。警告: `forceJumbo=true` と `moveRange` コマンドは、コレクションに対する書込み操作をブロックします。このオプションを指定すると、シャードは、設定されたチャンクサイズよりも大きい場合でも、チャンクを移行します。コレクションは、移行中は書き込みができなくなります。この長いブロッキング期間なしでこれらの大きなチャンクを移行するには、代わりに「サイズ制限を超えるバランス範囲」を参照してください。
`writeConcern`	ドキュメント	任意。書込み保証 ( write concern) のあるドキュメント。デフォルトは`w: majority`です。
`secondaryThrottle`	ブール値	任意。 `true`の場合、チャンクの移行中に移動された各ドキュメントは、バランサーが次のドキュメントに進む前に少なくとも 1 つのセカンダリに伝達されます。これは`{ w: 2 }`の書込み保証 (write concern) と同等です。別の書込み保証 (write concern) を指定するには、 `writeConcern`オプションを使用します。 `false`の場合、バランサーはセカンダリへのレプリケーションを待たずに次のドキュメントに進みます。詳細については、「セカンダリスロットル」を参照してください。

範囲移行セクションでは、範囲が MongoDB 上のシャード間で範囲がどのように移動されるかについて説明します。

Considerations

次のようなシナリオでのみmoveRangeを使用してください。

データの初期取り込み
大規模な一括インポート操作

ほとんどの場合、バランサーがシャーディングされたクラスターに範囲を作成し、範囲を作成できるようにします。

Tip

シャーディングされたクラスターで範囲を作成

例

次の例では、次の内容を含むコレクションを使用します。

シャードキー x
128MB のチャンクサイズに設定
境界のあるチャンク: [x: 0, x: 100)

との両方を指定`minmax`

次の表は、 minとmaxをさまざまな値に設定した結果を示しています。

`min`	`max`	結果
`0`	`100`	範囲内のすべてのドキュメントを受信者シャードに移動します。
`10`	`30`	3 つのサブ範囲を作成します。 `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` `[x: 10, x: 30)`内のすべてのドキュメントを受信者シャードに移動します。
`0`	`20`	2 つのサブ範囲を作成します。 `[x: 0, x: 20)` `[x: 20, x: 100)` `[x: 0, x: 20)`内のすべてのドキュメントを受信者シャードに移動します。
`40`	`100`	2 つのサブ範囲を作成します。 `[x: 0, x: 40)` `[x: 40, x: 100)` `[x: 40, x: 100)`内のすべてのドキュメントを受信者シャードに移動します。

を指定するが、は指定しない`minmax`

次の表は、 minをさまざまな値に設定した結果を示しています。

`min`	キー範囲内のデータ量	結果
`0`	キー`x: 0`と`x: 100`の間に含まれる 128 MB 未満。	範囲内のすべてのドキュメントを受信者シャードに移動します。
`10`	キー`x: 0`と`x: 100`の間に含まれる 128 MB 未満。	2 つのサブ範囲を作成します。 `[x: 0, x: 10)` `[x : 10, x: 100)` `[x: 10, x: 100)`内のすべてのドキュメントを受信者シャードに移動します。
`10`	キー`x: 10`と`x: 30`の間に含まれる 128 MB 。	3 つのサブ範囲を作成します。 `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` `[x: 10, x: 30)`内のすべてのドキュメントを受信者シャードに移動します。

戻る

movePrimary

mergeChunks

定義

Tip

互換性

注意

構文

コマンドフィールド

Considerations

Tip

例

と の両方を指定minmax

を指定するが、 は指定しないminmax

との両方を指定`minmax`

を指定するが、は指定しない`minmax`