AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Docs Menu

refineCollectionShardKey イベント

refineCollectionShardKey

バージョン6.0の新機能。

refineCollectionShardKeyイベントは、コレクションのシャードキーが変更されたときに発生します。

フィールド
タイプ
説明

_id

ドキュメント

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

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

clusterTime

タイムスタンプ

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

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

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

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

バージョン8.0で変更。

collectionUUID

UUID

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

バージョン6.0の新機能。

ns

ドキュメント

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

ns.coll

文字列

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

ns.db

文字列

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

operationDescription

ドキュメント

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

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

バージョン6.0の新機能。

operationDescription.
shardKey

ドキュメント

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

バージョン6.0の新機能。

operationDescription.
oldShardKey

ドキュメント

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

バージョン6.1の新機能。

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

{
"_id": { <ResumeToken> },
"operationType": "refineCollectionShardKey",
"clusterTime": Timestamp({ t: 1654894852, i: 52 }),
"collectionUUID": UUID("98046a1a-b649-4e5b-9c75-67594221ce19"),
"ns": {"db": "reshard_collection_event", "coll": "coll"},
"operationDescription": {
"shardKey": {"_id": 1, akey: 1},
"oldShardKey": {"_id": 1}
}
}
このページを評価

項目一覧