sh.moveChunk()

項目一覧

定義

互換性
例

定義

sh.moveChunk(namespace, query, destination)

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

重要

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

警告

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

重要

mongosh メソッド

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

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

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

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

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

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

Tip

以下も参照してください。

互換性

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

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

重要

このコマンドはサーバーレスインスタンスではサポートされていません。詳細については、「サポートされていないコマンド」を参照してください。

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

例

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

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

戻る

sh.isBalancerRuning

sh.moveCollection