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

shardCollection イベント

shardCollection

バージョン6.0の新機能。

コレクションがシャーディングされると、 shardCollectionイベントが発生します。

フィールド
タイプ
説明

_id

ドキュメント

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

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

clusterTime

タイムスタンプ

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

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

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

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

collectionUUID

UUID

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

バージョン6.0の新機能。

lsid

ドキュメント

トランザクションに関連付けられたセッションの識別子。

操作がマルチドキュメントトランザクションの一部である場合にのみ存在します。

ns

ドキュメント

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

ns.coll

string

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

ns.db

string

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

operationDescription

ドキュメント

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

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

バージョン6.0の新機能。

operationDescription.
numInitialChunks

long

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

バージョン6.0の新機能。

operationDescription.
presplitHashedZones

ブール値

コレクションがシャーディングされたときに、シャード チャンクがゾーンに従って事前に分割されているかどうかを示します。

バージョン6.0の新機能。

operationDescription.
shardKey

ドキュメント

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

バージョン6.0の新機能。

operationDescription.
unique

ブール値

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

バージョン6.0の新機能。

operationType

string

変更通知が報告する操作のタイプ。

これらの変更イベントのshardCollectionの値を返します。

txnNumber

NumberLong

wallTime

データベースの操作のサーバー日付と時刻。 wallTimeclusterTimeclusterTimeは と異なり、 はデータベース操作イベントに関連付けられた oplog エントリから取得されたタイムスタンプであるため、

バージョン6.0の新機能。

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

{
"_id": { <ResumeToken> },
"operationType": "shardCollection",
"clusterTime": Timestamp({ t: 1654894852, i: 52 }),
"collectionUUID": UUID("98046a1a-b649-4e5b-9c75-67594221ce19"),
"wallTime": ISODate("2022-06-10T21:00:52.854Z"),
"ns": {
"db": "test",
"coll": "authors"
},
"operationDescription": {
"shardKey": { "age": "hashed" },
"unique": false,
"numInitialChunks": Long("0"),
"presplitHashedZones": false
}
}
このページを評価

項目一覧