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

定義

sh.moveChunk(namespace, query, destination)

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

重要

ほとんどの場合、バランサーがチャンクを自動的に移行できるようにし、 sh.moveChunk()を直接呼び出すのは避けてください。

警告

このコマンドは、 moveChunkコマンドのfindオプションを使用するため、ハッシュされたシャードキーには使用できません。ハッシュされたシャードキーを使用してチャンクを移動するには、 boundsフィールドを指定するmoveChunkコマンドを使用します。

重要

mongosh メソッド

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

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

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

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

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

注意

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

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

Tip

互換性

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

MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、サポートされていないコマンドを参照してください。

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

例

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

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

戻る

sh.listShards

sh.moveCollection