コレクションの移動

項目一覧

定義

moveCollection: バージョン8.0の新機能。
シャーディングされていないコレクションを別のシャードに移動します。 moveCollectionmongos管理データベースを使用しながら、インスタンスでを実行します。

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

このコマンドは、Atlas 共有階層または Atlas サーバーレスでは使用できません。

次の場合は、 moveCollectionは使用できません。

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

db.adminCommand(
  {
    moveCollection: "<database>.<collection>",
    toShard: "<ID of the recipient shard>",
  }
)

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

フィールド	タイプ	説明
`moveCollection`	string	移動するコレクションのデータベースと名前。
`toShard`	string	受信者シャードの ID。

moveCollection は、シャーディングされたクラスターでのみ実行できます。
moveCollection は、シャーディングされていないコレクションのみを移動できます。
moveCollection は一度に 1 つのコレクションのみを移動できます。
moveCollection の最小期間は5分です。
Atlas Search インデックスは、 moveCollectionの実行後に再構築する必要があります。
moveCollectionが完了するまで、シャードの追加や削除、埋め込みコンフィギュレーションサーバーと専用コンフィギュレーションサーバー間での移行などのトポロジー変更を行うことはできません。
moveCollectionの進行中に移動されるコレクションに対して次の操作を実行することはできません。
moveCollectionが進行中の間は、クラスターに対して次の操作を実行することはできません。
moveCollectionの進行中に発生するインデックスビルドは、メッセージが表示されずに失敗する可能性があります。
- moveCollectionの進行中は、インデックスを作成しないでください。
- インデックスビルドが進行中の場合は、 moveCollectionを呼び出しないでください。

コレクションを移動する前に、次の要件を満たしていることを確認してください。

アプリケーションは、影響を受けるコレクションが書込みをブロックする期間を2 秒許容できます。書込み (write) がブロックされている期間中、アプリケーションのレイテンシが増加します。
データベースが次のリソース要件を満たしている。
- コレクションを移動するシャードに、コレクションとそのインデックス用の十分なストレージ領域があることを確認します。宛先シャードでは少なくとも( Collection storage size + Index Size ) * 2バイトが使用可能である必要があります。
- I/Oキャパシティーが50 % 未満であることを確認します。
- CPU 負荷が80 % 未満であることを確認します。

これらの要件はデータベースによって強制されません。十分なリソースを割り当てられない場合、次の結果が発生する可能性があります。

アプリケーションにトラフィックが少ない期間がある場合は、可能であれば、その時間中にコレクションに対してこの操作を実行します。

この例では、 appデータベース上のinventoryという名前のシャーディングされていないコレクションをshard02シャードに移動します。

db.adminCommand(
  {
    moveCollection: "app.inventory",
    toShard: "shard02"
  }
)

使用可能なシャード ID のリストを取得するには、 sh.status()を実行します。詳細についてはsh.status() 出力を参照してください。

戻る

moveChunk

movePrimary