Docs Menu
Docs Home
/
MongoDBマニュアル
/
変更ストリーム
/
変更イベント

rename イベント

項目一覧

  • 概要
  • 説明
  • 動作
  • 拡張イベント情報
  • 例

概要

rename

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

説明

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

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

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

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

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

clusterTime
タイムスタンプ

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

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

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

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

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

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