删除事件

文档的预和后映像

从MongoDB 6.0开始，如果您执行以下步骤，将看到一个包含文档更改（或删除）前的字段的fullDocumentBeforeChange文档：

1. 使用db.createCollection()、create或collMod启用集合的新changeStreamPreAndPostImages字段。

2. 在db.collection.watch()中将fullDocumentBeforeChange设置为“required”或“whenAvailable”。

变更流输出中的fullDocumentBeforeChange文档示例

"fullDocumentBeforeChange" : {
   "_id" : ObjectId("599af247bb69cd89961c986d"),
   "userName" : "alice123",
   "name" : "Alice Smith"
}

有关带有变更流输出的完整示例，请参阅带有文档前后的变更流。

如果图像在文档更新或删除操作时未启用，则变更流事件中不可用预和后图像。

• 在文档更新或删除操作时未在集合上启用。

• 在expireAfterSeconds中设置的预和后图像保留时间后已删除。

  • 以下示例将整个集群上的expireAfterSeconds设置为100秒

    use admin
    db.runCommand( {
       setClusterParameter:
          { changeStreamOptions: {
             preAndPostImages: { expireAfterSeconds: 100 }
          } }
    } )

  • 以下示例返回当前的changeStreamOptions设置，包括expireAfterSeconds

    db.adminCommand( { getClusterParameter: "changeStreamOptions" } )

  • 将expireAfterSeconds设置为“off”将使用默认的保留策略：预和后图像保留到相应的变更流事件从oplog中删除。

  • 如果从oplog中删除了变更流事件，则相关的预和后图像也将被删除，无论expireAfterSeconds预和后图像保留时间如何。

其他注意事项

• 启用预和后图像会消耗存储空间并增加处理时间。只有当您需要它们时才启用预和后图像。

• 将变更流事件大小限制在小于16兆字节。要限制事件大小，您可以

  • 将文档大小限制为8兆字节。如果其他变更流事件字段（如updateDescription）不大，您可以在变更流输出中同时请求预和后图像。

  • 如果其他变更流事件字段（如updateDescription）不大，则在变更流输出中仅请求16兆字节以下文档的后图像。

  • 如果以下条件满足，则在变更流输出中仅请求16兆字节以下文档的前图像：

    • 文档更新仅影响文档结构或内容的一小部分

    • 并且不会引起replace更改事件。替换事件始终包括后图像。

• 要请求前图像，请在db.collection.watch()中将fullDocumentBeforeChange设置为“required”或“whenAvailable”。要请求后图像，请使用相同的方法设置fullDocument。

• 预映像被写入到 config.system.preimages 集合中。

  • config.system.preimages 集合可能会变得很大。为了限制集合大小，您可以设置预映像的 expireAfterSeconds 时间，如前所述。

  • 预映像由后台进程异步删除。