分裂

項目一覧

定義

互換性
構文
コマンドフィールド
Considerations
コマンド形式
例
Metadata Lock Error

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

定義

split

シャーディングされたクラスター内のチャンクを 2 つのチャンクに分割します。シャードは、保持するチャンクサイズ統計に基づいてチャンクを管理および分割します。

例外的な状況では、 splitコマンドでは、管理者が分割を手動で作成できるようになります。これらの状況とをラップする MongoDB shell コマンドについては、「シャーディングされたクラスターでのチャンクの分割 split 」を参照してください。

Tip

mongoshでは、このコマンドはsh.splitAt()およびsh.splitFind()ヘルパーメソッドを通じて実行することもできます。

ヘルパーメソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、データベースコマンドを使用します。

互換性

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

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

重要

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

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

構文

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

db.adminCommand( { split: <database>.<collection>,
                     <find|middle|bounds> } )

コマンドフィールド

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

フィールド	タイプ	説明
`split`	string	チャンクが存在するコレクションの名前。データベース名を含む、コレクションの完全な名前空間を指定します。
`find`	ドキュメント	シャードキーの等価一致を指定するクエリステートメント。一致により、指定されたドキュメントを含むチャンクが選択されます。次のいずれか 1 つだけを指定する必要があります: `find` 、 `bounds` 、または`middle` 。空のコレクションでは`find`オプションは使用できません。
`bounds`	配列	バージョン2.4の新機能 : 分割するチャンクの境界。 `bounds`は、ハッシュされたシャードキーを使用して分割されたコレクション内のチャンクに適用されます。パラメーターの配列は、チャンクのシャードキーの下限と上限を指定する 2 つのドキュメントで構成されている必要があります。値は、既存のチャンクの最小値と最大値と一致する必要があります。次のいずれか 1 つだけを指定します: `find` 、 `bounds` 、または`middle` 。空のコレクションでは`bounds`オプションは使用できません。
`middle`	ドキュメント	2 つのチャンクを作成するための分裂点として使用するドキュメント。`split` には、次のいずれかのオプションが必要です:`find` 、`bounds` 、または`middle` 。

Considerations

findまたはboundsオプションのいずれかとともに使用すると、 splitコマンドは中央値に基づいてチャンクを分割します。そのため、コマンドではfindまたはboundsオプションを使用して空のチャンクを分割できません。空のチャンクには中央値がないためです。

空のチャンクに分割を作成するには、 splitコマンドでmiddleオプションを使用するか、 sh.splitAt()コマンドを使用します。

コマンド形式

チャンクの分割を作成するには、 mongosインスタンスに接続し、 adminデータベースに次のコマンドを実行します。

db.adminCommand( { split: <database>.<collection>,
                   find: <document> } )

または:

db.adminCommand( { split: <database>.<collection>,
                   middle: <document> } )

または:

db.adminCommand( { split: <database>.<collection>,
                   bounds: [ <lower>, <upper> ] } )

ハッシュされたシャードキーを使用するコレクションの分割を作成するには、 boundsパラメータを使用します。この目的では、 middleパラメータを使用しないでください。

警告

シャーディングされたコレクションのデータを分割して新しいチャンクを作成する場合は注意してください。既存のデータを持つコレクションをシャーディングすると、MongoDB はコレクションを均等に分散するためのチャンクを自動的に作成します。シャーディングされたクラスターでデータを効果的に分割するには、チャンク内のドキュメント数と平均ドキュメントサイズを考慮して、均等なチャンクサイズを作成する必要があります。チャンクのサイズが不均等な場合、シャードのチャンク数は同じ数でも、データサイズは大きく異なる場合があります。サイズが異なるコレクションになるような分割は作成しないようにします。

Tip

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

例

次のセクションでは、 splitコマンドの例を示します。

チャンクを半分に分割

db.adminCommand( { split : "test.people", find : { _id : 99 } } )

splitコマンドは、 { _id : 99 }に一致するドキュメントを保持するtestデータベースのpeopleコレクション内のチャンクを識別します。 splitでは、適切なチャンクを識別するために、一致が存在する必要はありません。次に、コマンドはそれを同じサイズの 2 つのチャンクに分割します。

注意

split は、サイズではなく範囲で 2 つの等しいチャンクを作成し、選択した点を新しいチャンクの境界として使用しません。

任意の分裂点を定義する

任意の分裂点を定義するには、次の形式を使用します。

db.adminCommand( { split : "test.people", middle : { _id : 99 } } )

splitコマンドは、 testデータベースのpeopleコレクション内のチャンクを識別し、クエリ{ _id : 99 }に一致するドキュメントを保持します。 splitでは、適切なチャンクを識別するために、一致が存在する必要はありません。次に、コマンドはそれを 2 つのチャンクに分割し、一致するドキュメントを分割されたチャンクの 1 つの下限として返します。

この形式は通常、コレクション内のデータを事前に分割するときに使用されます。

ハッシュされたシャードキーの値を使用したチャンクの分割

この例では、 testデータベースのpeopleコレクションでハッシュされたシャードキーuseridを使用します。次のコマンドは、2 つの単一フィールドドキュメントを含む配列を使用して、チャンクを分割するためのハッシュされたシャードキーの最小値と最大値を表します。

db.adminCommand( { split: "test.people",
                  bounds : [ { userid: NumberLong("-5838464104018346494") },
                             { userid: NumberLong("-5557153028469814163") }
             ] } )

注意

MongoDB は、ハッシュ値を表すのに64ビットのNumberLong型を使用します。

シャードキーの既存の限界を確認するには、 sh.status()を使用します。

Metadata Lock Error

splitの実行中にバランサープロセスなどの別のプロセスがメタデータを変更すると、 metadata lock errorが表示されることがあります。

errmsg: "The collection's metadata lock is already taken."

このメッセージは、分裂が失敗し、サイド効果がないことを示しています。 splitコマンドを再試行します。

戻る

shardingState

unsetSharding