/ /

无效事件

总结

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`	ISODate	数据库操作的服务器日期和时间。`wallTime` 与 `clusterTime` 的不同之处在于，`clusterTime` 是从与数据库操作事件相关的 oplog 条目中提取的时间戳。 6.0版本新增。

例子

以下示例说明了 invalidate 事件：

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

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

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

invalidate 事件关闭变更流游标。

You cannot use resumeAfter to resume a change stream after an invalidate event (for example, a collection drop or rename) closes the stream. Instead, you can use startAfter to start a new change stream after an invalidate event.