/ /

/ /

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

定義

sh.moveCollection(namespace, toShard): シャーディングされていないコレクションを別のシャードに移動します。 sh.moveCollection()mongos管理データベースを使用しながら、インスタンスでを実行します。
重要
mongosh メソッド
このページでは、mongosh メソッドについて説明します。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。
データベースコマンドについては、moveCollection コマンドを参照してください。
MongoDB API ドライバーについては、各言語の MongoDB ドライバードキュメントを参照してください。

sh.moveCollection() の構文は次のとおりです。

sh.moveCollection( "<namespace>", "<toShard>" )

listShards受信者シャードのIDを取得するには、コマンドを使用します。

sh.moveCollection() は以下のパラメーターを取ります。

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

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

このコマンドは、Atlas 無料および Flex 階層では使用できません。

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

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

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

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

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

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

sh.moveCollection( "app.inventory", "shard02" )

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

戻る

sh.moveChunk

sh.moveRange