`shardCollection` イベント

項目一覧

概要

説明
例

概要

shardCollection: バージョン 6.0 で追加。
コレクションがシャーディングされると、 shardCollectionイベントが発生します。

説明

フィールド

タイプ

説明

_id

ドキュメント

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

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

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

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

clusterTime

タイムスタンプ

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

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

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

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

バージョン8.0で変更。

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

トランザクションを一意に識別するのに役立つ数値は、 lsid と合わせて使用されます。

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

wallTime

ISODate

データベースの操作のサーバー日付と時刻。 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
   }
}

戻る

reshardCollection

update