sh.moveChunk()

定義

sh.moveChunk(namespace, query, destination)

queryによって指定されたドキュメントを含むチャンクをdestinationシャードに移動します。 sh.moveChunk()はmoveChunkデータベースコマンドを囲むラッパーを提供します。

重要

ほとんどの場合、バランサーがチャンクを直接移行することを許可し、 sh.moveChunk()を直接呼び出すのは避けてください。

重要

mongosh メソッド

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

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

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

sh.moveChunk() 以下の引数を取ります。

Parameter	タイプ	説明
namespace	string	移行するチャンクを含むシャーディングされたコレクションの名前空間。
query	ドキュメント	移動するチャンクを選択するシャードキーの等価一致。
destination	string	移動するシャードの名前。

デフォルトでは、チャンク内のドキュメント数が、構成されたチャンク サイズを平均ドキュメント サイズで割った結果の1.3倍を超える場合、MongoDB はチャンクを移動できません。 moveChunkコマンドでforceJumboオプションを指定すると、ジャンボラベルの有無にかかわらず、移動できないほど大きいチャンクの手動移行を可能にできます。 詳細については、 moveChunkコマンドを参照してください。

例

recordsデータベースのpeopleコレクションがある場合、次の操作では、 zipcodeフィールドが53187に設定されているドキュメントを含むチャンクが検索され、そのチャンクがshard0019という名前のシャードに移動されます。

sh.moveChunk("records.people", { zipcode: "53187" }, "shard0019")