Docs Menu
Docs Home
/
MongoDBマニュアル
/ /

refineCollectionShardKey イベント

項目一覧

  • 概要
  • 説明
refineCollectionShardKey

バージョン 6.0 で追加。

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

フィールド
タイプ
説明
_id
ドキュメント

変更ストリーム イベントの識別子として機能する BSONオブジェクト。 この値は、変更ストリームを再開するときに、 resumeAfterパラメータのresumeTokenとして使用されます。 _idオブジェクトの形式は次のとおりです。

{
"_data" : <BinData|hex string>
}

_dataタイプは、変更ストリームの開始時または再開時に MongoDB のバージョン、および場合によっては機能の互換性バージョン(FCV)によって異なります。 _dataタイプの完全なリストについては、「再開トークン」を参照してください。

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

clusterTime
タイムスタンプ

イベントに関連付けられた oplog エントリのタイムスタンプ。

マルチドキュメントトランザクションに関連付けられた変更ストリーム イベントの通知では、すべて同じclusterTime値(トランザクションがコミットされた時間)が含まれます。

シャーディングされたクラスターでは、同じclusterTimeを持つイベントがすべて同じトランザクションに関連付けられない場合があります。 一部のイベントはトランザクションにまったく関連しません。

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

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

戻る

modify

項目一覧