/ /

`rename` イベント

概要

rename: コレクションの名前が変更されると、 renameイベントが発生します。

説明

フィールド	タイプ	説明
`_id`	ドキュメント	BSONオブジェクト。変更ストリームイベントの識別子として機能します。この値は、変更ストリームを再開するときに、`resumeAfter` パラメータの `resumeToken` として使用されます。`_id`オブジェクト内のフィールドは、変更ストリームの開始時または再開時にMongoDB のバージョンと、場合によっては機能の互換性バージョン（FCV）によって異なります。 `resumeToken`による変更ストリームの再開の例については、「変更ストリームの再開」を参照してください。
`clusterTime`	タイムスタンプ	`clusterTime` は、イベントに関連付けられたoplogエントリからのタイムスタンプです。 oplog のサイズ制限により、マルチドキュメントトランザクションでは複数のoplogエントリが作成される場合があります。トランザクションでは、特定のoplogエントリでステージされた変更ストリームイベントは同じ `clusterTime` を共有します。同じ`clusterTime`を持つイベントが、すべて同じトランザクションに関連するわけではありません。一部のイベントはトランザクションにまったく関連しません。 MongoDB 8.0以降では、どの配置のイベントにも当てはまる可能性があります。以前のバージョンでは、この動作はシャーディングされたシャーディングされたクラスター上のイベントでのみ可能でした。単一のトランザクションのイベントを識別するには、変更ストリームイベントドキュメントで`lsid`と`txnNumber`の組み合わせを使用できます。バージョン8.0で変更。
`collectionUUID`	UUID	変更が発生したコレクションを識別するUUID 。バージョン6.0の新機能。
`lsid`	ドキュメント	トランザクションに関連付けられたセッションの識別子。操作がマルチドキュメントトランザクションの一部である場合にのみ存在します。
`ns`	ドキュメント	イベントの影響を受ける名前空間（データベースとまたはコレクション）。
`ns.db`	string	イベントが発生したデータベースの名前。
`ns.coll`	string	イベントが発生したコレクションの名前。
`operationDescription`	ドキュメント	変更操作に関する追加情報。このドキュメントとそのサブフィールドは、変更ストリームが展開されたイベントを使用する場合にのみ表示されます。バージョン6.0の新機能。
`operationDescription.` `dropTarget`	UUID	名前変更操作で削除されたコレクションのUUID 。バージョン6.0の新機能。
`operationDescription.` `to`	ドキュメント	名前変更後のコレクションの新しい名前空間。バージョン6.0の新機能。
`operationDescription.` `to.coll`	ドキュメント	名前変更後のコレクションの新しい名前。バージョン6.0の新機能。
`operationDescription.` `to.db`	ドキュメント	名前変更後のデータベースの新しい名前。バージョン6.0の新機能。
`operationType`	string	変更通知が報告する操作のタイプ。これらの変更イベントの`rename`の値を返します。
`to`	ドキュメント	名前変更後のコレクションの新しい名前空間。
`to.coll`	ドキュメント	名前変更後のコレクションの新しい名前。
`to.db`	ドキュメント	名前変更後のデータベースの新しい名前。
`txnNumber`	NumberLong	トランザクションを一意に識別するのに役立つ数値は、 lsid と合わせて使用されます。操作がマルチドキュメントトランザクションの一部である場合にのみ存在します。
`wallTime`	ISODate	データベースの操作のサーバー日付と時刻。 `wallTimeclusterTimeclusterTime`はと異なり、はデータベース操作イベントに関連付けられた oplog エントリから取得されたタイムスタンプであるため、バージョン6.0の新機能。

動作

拡張イベント情報

バージョン6.0で変更。

MongoDB 6.0 以降では、変更ストリームでshowExpandedEventsオプションがtrueに設定されている場合、 renameイベントにoperationDescriptionドキュメントが含まれます。このドキュメントには、変更されたデータベースとコレクションを示すtoフィールドと、名前変更前にrename操作によってコレクションが削除されたかどうかを示すdropTargetフィールドがあります。

例

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

{
   "_id": { <Resume Token> },
   "operationType": "rename",
   "clusterTime": <Timestamp>,
   "wallTime": <ISODate>,
   "ns": {
      "db": "engineering",
      "coll": "users"
   },
   "to": {
      "db": "engineering",
      "coll": "people"
   },
   "operationDescription": {
      "to": {
         "db": "engineering",
         "coll": "people"
      }
   }
}

renameイベントは、 nsコレクションまたはtoコレクションに対して開かれた変更ストリームの無効化イベントにつながります。

戻る

refineCollectionShardKey

replace

rename イベント

概要

説明

動作

拡張イベント情報

例

`rename` イベント