对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

无效事件

invalidate

当操作将变更流渲染为无效时发生 invalidate 事件。例如,在后来被删除或重命名的集合上打开的变更流将导致 invalidate 事件。

字段
类型
说明

_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中进行了更改。

operationType

字符串

变更通知报告的操作类型。

为这些变更事件返回 invalidate 值。

wallTime

数据库操作的服务器日期和时间。wallTime 与 clusterTime 的不同之处在于,clusterTime 是从与数据库操作事件相关的 oplog 条目中提取的时间戳。

6.0版本新增。

以下示例说明了 invalidate 事件:

{ "_id": { <Resume Token> }, "operationType": "invalidate", "clusterTime": <Timestamp>, "wallTime": <ISODate>}

当发生影响受监视集合的删除、重命名或 dropDatabase 操作时,在集合上打开的变更流会引发 invalidate 事件。

当发生影响受监视数据库的 dropDatabase 事件时,在数据库上打开的变更流会引发 invalidate 事件。

invalidate 事件关闭变更流游标。

在某一无效事件(例如,集合删除或重命名)关闭变更流后,您无法使用 resumeAfter 来恢复变更流。请改为使用 startAfter 在无效事件后启动新的变更流。

给本页内容打分

在此页面上