AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
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以降では、どの配置のイベントにも当てはまる可能性があります。 以前のバージョンでは、この動作は シャーディングされたシャーディングされたクラスター上の イベントでのみ可能でした。

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

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}
}
}

項目一覧