AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

reshardCollection イベント

reshardCollection

バージョン6.1 の新機能(6.0.14 でも利用可能)。

reshardCollectionイベントは、次の場合に発生します。

  • コレクションのシャードキーとデータの分散状況が変更され、

  • 変更ストリームではshowExpandedEventstrueに設定されています。

フィールド
タイプ
説明

_id

ドキュメント

BSONオブジェクト。変更ストリームイベントの識別子として機能します。この値は、変更ストリームを再開するときに、resumeAfter パラメータの resumeToken として使用されます。_idオブジェクト内のフィールドは、変更ストリームの開始時または再開時にMongoDB のバージョンと、場合によっては機能の互換性バージョン(FCV)によって異なります。

resumeTokenによる変更ストリームの再開の例については、「 変更ストリームの再開 」を参照してください。

clusterTime

タイムスタンプ

clusterTime は、イベントに関連付けられたoplogエントリからのタイムスタンプです。

oplog のサイズ制限 により、マルチドキュメントトランザクションでは複数のoplogエントリが作成される場合があります。トランザクションでは、特定のoplogエントリでステージされた変更ストリームイベントは同じ clusterTime を共有します。

同じclusterTimeを持つイベントが、すべて同じトランザクションに関連するわけではありません。 一部のイベントはトランザクションにまったく関連しません。 MongoDB 8.0以降では、どの配置のイベントにも当てはまる可能性があります。 以前のバージョンでは、この動作は シャーディングされたシャーディングされたクラスター上の イベントでのみ可能でした。

単一のトランザクションのイベントを識別するには、変更ストリーム イベント ドキュメントでlsidtxnNumberの組み合わせを使用できます。

8.0バージョン での変更。

collectionUUID

UUID

変更が発生したコレクションを識別するUUID

6.0バージョン の新機能。:

ns

ドキュメント

イベントの影響を受ける名前空間(データベースと または コレクション)。

ns.coll

文字列

イベントが発生したコレクションの名前。

ns.db

文字列

イベントが発生したデータベースの名前。

operationDescription

ドキュメント

変更操作に関する追加情報。

このドキュメントとそのサブフィールドは、変更ストリームが展開されたイベントを使用する場合にのみ表示されます。

6.0バージョン の新機能。:

operationDescription.
reshardUUID

UUID

リシャーディング操作を識別するUUID

6.1バージョン の新機能。:

operationDescription. | shardKey

ドキュメント

変更が発生したコレクションのシャードキー

6.0バージョン の新機能。:

operationDescription. | oldShardKey

ドキュメント

変更されたコレクションのシャードキー

6.1バージョン の新機能。:

operationDescription. | unique

ブール値

コレクションが一意のシャードキーでシャーディングされている場合、これの値は true になります。

6.0バージョン の新機能。:

operationDescription. | numInitialChunks

NumberLong

reshardCollection操作中に各シャードで作成されたチャンクの数。

シャードキーにハッシュされたプレフィックスが含まれている場合、リシャーディング操作では numInitialChunks 設定は無視されます。代わりに、 MongoDB は、空のハッシュされたコレクションの最初のチャンク作成と同じアプローチを使用して、受信者間でハッシュされたキースペースを確定的に分割します。

operationDescription.
collation

ドキュメント

シャードキー インデックスに使用される照合ドキュメント。

6.1バージョン の新機能。:

operationDescription.
zones

配列

新しいシャードキーに追加されたゾーン。

6.1バージョン の新機能。:

次の例は、 reshardCollectionイベントを示しています。

{
"_id": { <ResumeToken> },
"operationType": "reshardCollection",
"collectionUUID": 0,
"ns": {"db": "reshard_collection_event", "coll": "coll"},
"operationDescription": {
"reshardUUID": 0,
"shardKey": {"newKey": 1},
"oldShardKey": {"_id": 1},
"unique": false,
"numInitialChunks": Long(1),
"collation": {"locale": "simple"},
"zones": [
{"zone": "zone1", "min": {"newKey": {"$minKey": 1}}, "max": {"newKey": {"$maxKey": 1}}}
]
}
}

項目一覧