变更事件

在此页面上

操作类型
恢复令牌
扩展事件

变更流监视集合、数据库或部署中是否有更改。

当监视的资源发生更改时，变更流会返回变更事件通知文档，其中包含相关操作以及所做更改的信息。

操作类型

事件	说明
`create`	在创建集合时发生。需要将 showExpandedEvents 选项设置为 `true`。 6.0 版本中的新功能。
`createIndexes`	对集合创建索引时出现。需要将 showExpandedEvents 选项设置为 `true`。 6.0 版本中的新功能。
`delete`	从集合中删除文档时发生。
`drop`	从数据库中删除集合时发生。
`dropDatabase`	删除数据库时发生。
`dropIndexes`	从集合中删除索引时发生。需要将 showExpandedEvents 选项设置为 `true`。 6.0 版本中的新功能。
`insert`	在一个操作将文档添加到集合时发生。
`invalidate`	当操作使变更流无效时发生此事件。
`modify`	修改集合时出现。需要将 showExpandedEvents 选项设置为 `true`。 6.0 版本中的新功能。
`refineCollectionShardKey`	修改分片键时发生。 6.1 版本新增内容。
`rename`	重命名集合时发生。
`replace`	当更新操作从集合中删除文档并将其替换为新文档时发生此事件。
`reshardCollection`	当集合的分片键和数据分布发生变化时发生此事件。需要将 showExpandedEvents 选项设置为 `true`。版本 6.1 中的新功能：（也适用于 6.0.14）
`shardCollection`	对集合进行分片时发生。需要将 showExpandedEvents 选项设置为 `true`。 6.0 版本中的新功能。
`update`	当一个操作更新集合中的文档时发生。

恢复令牌

每个更改事件都包含一个 _id 字段，其中包含一个文档。启动变更流时，该文档可作为恢复令牌。

扩展事件

6.0 版本中的新功能。

从 MongoDB 6.0 开始，change stream 支持 DDL 事件的变更通知，如 createIndexes 和 dropIndexes 事件。要在 change stream 中包含扩展事件，请使用 showExpandedEvents 选项创建change stream 游标。

例如：

let cur = db.names.aggregate( [ {
   $changeStream: {
       showExpandedEvents: true
     }
   }
 ] )
cur.next()

后退

生产建议

来年

创建