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

定義

moveRange: バージョン6.0の新機能。
Moves ranges between shards. Run the moveRange command with a mongos instance while using the admin database.
Tip
In mongosh, this command can also be run through the sh.moveRange() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

互換性

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

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

注意

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

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

構文

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

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

コマンドフィールド

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

フィールド	タイプ	説明
`toShard`	string	受信者シャードの ID。
`min`	キー	移動する範囲の最小キー。 `max`を指定しない場合は必須です。 `min`を指定しない場合、チャンク`C`において、 `max`が`C`の排他的上限であるか、 `C`にシャードキー`max`が含まれていると仮定すると、 `min`は次のように決定されます。 : `min(C)`から`max`の範囲のデータサイズが、コレクションごとのチャンクサイズまたはデフォルトのチャンクサイズより小さい場合、チャンクの`min`値は`min` = `min(C)`として選択されます。それ以外の場合、キー`min` > `min(C)`の場合、 `min`は構成されたチャンクサイズによって異なります。
`max`	キー	移動する範囲の最大キー。 `min`を指定しない場合は必須です。 `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

Only use the moveRange in scenarios like:

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

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

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)`内のすべてのドキュメントを受信者シャードに移動します。

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

次の表は、 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)`内のすべてのドキュメントを受信者シャードに移動します。

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

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

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

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

定義

互換性

構文

コマンドフィールド

Considerations

例

と の両方を指定minmax

min を指定するが、max は指定しない

max を指定するが、min は指定しない

との両方を指定`minmax`

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

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