/ /

`rename` 事件

总结

rename: 重命名collection时会发生rename事件。

说明

字段	类型	说明
`_id`	文档	一个BSON对象，用作变更流事件的标识符。恢复变更流时，此值用作 `resumeAfter` 参数的 `resumeToken`。`_id`对象中的字段取决于MongoDB版本，在某些情况下，还取决于变更流打开或恢复时的特征兼容性版本(FCV)。有关通过 `resumeToken` 恢复变更流的示例，请参阅恢复变更流。
`clusterTime`	时间戳	`clusterTime` 是来自与该事件关联的oplog条目的时间戳。由于oplog大小限制，多文档事务可能会创建多个oplog条目。在ACID 事务中，给定oplog条目中暂存的变更流事件股票相同的 `clusterTime`。具有相同`clusterTime`的事件可能并不都与同一ACID 事务相关。有些事件与ACID 事务完全无关。从MongoDB 8.0开始，任何部署上的事件都可能如此。在以前的版本中，这种行为只适用于分分片集群上的事件。要标识单个事务的事件，您可以在变更流事件文档中结合使用 `lsid` 和 `txnNumber`。在版本8.0中进行了更改。：
`collectionUUID`	UUID	标识发生更改的集合的 UUID。 6.0版本新增。：
`lsid`	文档	与事务关联的会话标识符。只有当操作是多文档事务的一部分时才会出现。
`ns`	文档	受事件影响的命名空间（数据库和/或集合）。
`ns.db`	字符串	发生事件的数据库的名称。
`ns.coll`	字符串	发生事件的集合的名称。
`operationDescription`	文档	有关变更操作的其他信息。仅当变更流使用扩展事件时，此文档及其子字段才会出现。 6.0版本新增。：
`operationDescription.` `dropTarget`	UUID	在重命名操作中删除的collection的UUID 。 6.0版本新增。：
`operationDescription.` `to`	文档	重命名后collection的新命名空间。 6.0版本新增。：
`operationDescription.` `to.coll`	文档	重命名后collection的新名称。 6.0版本新增。：
`operationDescription.` `to.db`	文档	重命名后数据库的新名称。 6.0版本新增。：
`operationType`	字符串	变更通知报告的操作类型。为这些变更事件返回 `rename` 值。
`to`	文档	重命名后collection的新命名空间。
`to.coll`	文档	重命名后collection的新名称。
`to.db`	文档	重命名后数据库的新名称。
`txnNumber`	NumberLong	与 lsid 一起使用的数字，有助于唯一标识事务。只有当操作是多文档事务的一部分时才会出现。
`wallTime`	ISODate	数据库操作的服务器日期和时间。`wallTime` 与 `clusterTime` 的不同之处在于，`clusterTime` 是从与数据库操作事件相关的 oplog 条目中提取的时间戳。 6.0版本新增。：

行为

扩展事件信息

在版本6.0中进行了更改。：

从 MongoDB 6.0 开始，当 change stream 的showExpandedEvents选项设置为true时， rename事件包括operationDescription文档。此文档提供了一个to字段（显示更改后的数据库和collection）和一个dropTarget字段（指示rename操作是否在重命名之前删除了collection）。

例子

以下示例说明了 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事件会导致针对其nscollection或tocollection打开的change stream发生事件。

后退

refineCollectionShardKey

来年

替换

rename 事件

总结

说明

行为

扩展事件信息

例子

`rename` 事件