reshardCollection イベント

項目一覧

概要

説明
例

概要

reshardCollection

バージョン6.1の新機能（ 6.0.14でも利用可能）

reshardCollectionイベントは、次の場合に発生します。

コレクションのシャードキーとデータの分散状況が変更され、
変更ストリームでは、 showExpandedEventsがtrueに設定されています。

説明

フィールド

タイプ

説明

_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 で追加。

ns

ドキュメント

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

ns.coll

文字列

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

ns.db

文字列

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

operationDescription

ドキュメント

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

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

バージョン 6.0 で追加。

operationDescription.

reshardUUID

UUID

リシャーディング操作を識別するUUID 。

バージョン 6.1 で追加。

operationDescription. | shardKey

ドキュメント

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

バージョン 6.0 で追加。

operationDescription. | oldShardKey

ドキュメント

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

バージョン 6.1 で追加。

operationDescription. | unique

ブール値

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

バージョン 6.0 で追加。

operationDescription. | numInitialChunks

NumberLong

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

バージョン 6.0 で追加。

operationDescription.

collation

ドキュメント

シャードキーインデックスに使用される照合ドキュメント。

バージョン 6.1 で追加。

operationDescription.

zones

配列

新しいシャードキーに追加されたゾーン。

バージョン 6.1 で追加。

例

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

{
   "_id": { <ResumeToken> },
   "operationType": "reshardCollection",
   "collectionUUID": 0,
   "ns": {"db": "reshard_collection_event", "coll": "coll"},
   "operationDescription": {
     "reshardUUID": 0,
     "shardKey": {"newKey": 1},
     "oldShardKey": {"_id": 1},
     "unique": false,
     "numInitialChunks": NumberLong(1),
     "collation": {"locale": "simple"},
     "zones": [
         {"zone": "zone1", "min": {"newKey": {"$minKey": 1}}, "max": {"newKey": {"$maxKey": 1}}}
     ]
   }
}

戻る

replace

shardCollection