MongoDB聚合操作:$changeStream

返回集合、数据库或整个群集上的Change Stream游标。必须在聚合管道的第一阶段使用。

语法

js 复制代码
{
  $changeStream: {
    allChangesForCluster: <boolean>,
    fullDocument: <string>,
    fullDocumentBeforeChange: <string>,
    resumeAfter: <int>
    showExpandedEvents: <boolean>,
    startAfter: <document>
    startAtOperationTime: <timestamp>
  }
}

allChangesForCluster

可选:设置Change Stream是否包括群集中的所有更改。可能只能在管理数据库中打开。

fullDocument

可选:指定update操作修改时,更改通知是否包含完整文档的副本。

  • default:更改通知不包括更新操作的完整文档。

  • required:更改通知包括更改后文档的副本。如果找不到文档,change stream 将会出错。

    要使用此选项,必须先使用 collMod 命令启用 changeStreamPreAndPostImages 选项。

    6.0 版新增功能。

  • updateLookup:更改通知包括更改所修改文档的副本。该文档是当前大多数已提交的文档,如果已不存在,则为空。

  • whenAvailable:变更通知包括一份变更后立即出现的被修改文档的副本,如果文档不可用,则为空。

    要使用此选项,必须先使用 collMod 命令启用 changeStreamPreAndPostImages 选项。

    6.0 版新增功能。

在部分更新的情况下,更改通知还会提供更改说明。

fullDocumentBeforeChange

包括更改前的完整文档。该字段接受以下值:

  • off:禁用包含更改前的文档。

  • whenAvailable:包含修改前的文档。如果未修改的文档不可用,查询不会失败。

  • required:包含更改前的文档。如果未修改的文档不可用,查询将失败。

resumeAfter

指定一个恢复标记作为更改流的逻辑起点。不能与 startAfterstartAtOperationTime 字段一起使用。

showExpandedEvents

指定是否包含其他更改事件,如 DDL 和索引操作。

6.0 版新增功能。

startAfter

指定一个恢复标记作为更改流的逻辑起点。不能与 resumeAfterstartAtOperationTime 字段一起使用。

startAtOperationTime

指定一个时间作为更改流的逻辑起点。不能与 resumeAfterstartAfter 字段一起使用。

举例

使用下面的聚合命令创建一个change stream 游标。

js 复制代码
var cur = db.names.aggregate( [
   { $changeStream: {} }
] )

运行cur打开光标。

当Change Stream检测到更改时,next()方法会返回更改事件通知。例如,在运行cur.next() 之后,MongoDB 会返回与下面类似的文档:

json 复制代码
{
   "_id": {
      _data: "8262E2EE54000000022B022C0100296E5A100448E5E3DD01364019AE8FE8C6859527E046645F6964006462E2EE54C8756C0D5CF6F0720004"
   },
   "operationType": "insert",
   "clusterTime": Timestamp({ t: 1659039316, i: 2 }),
   "wallTime": ISODate("2022-07-28T20:15:16.148Z"),
   "fullDocument": {
      "_id": ObjectId("62e2ee54c8756c0d5cf6f072"),
      "name": "Walker Percy"
   },
   "ns": {
      "db": "test",
      "coll": "names"
   },
   "documentKey": { _id: ObjectId("62e2ee54c8756c0d5cf6f072") }
}
相关推荐
计算机毕设定制辅导-无忧学长6 小时前
西门子 PLC 与 Modbus 集成:S7-1500 RTU/TCP 配置指南(一)
服务器·数据库·tcp/ip
程序员柳7 小时前
基于微信小程序的校园二手交易平台、微信小程序校园二手商城源代码+数据库+使用说明,layui+微信小程序+Spring Boot
数据库·微信小程序·layui
梦在深巷、7 小时前
MySQL/MariaDB数据库主从复制之基于二进制日志的方式
linux·数据库·mysql·mariadb
IT乌鸦坐飞机8 小时前
ansible部署数据库服务随机启动并创建用户和设置用户有完全权限
数据库·ansible·centos7
IT_10248 小时前
Spring Boot项目开发实战销售管理系统——数据库设计!
java·开发语言·数据库·spring boot·后端·oracle
祁思妙想9 小时前
八股学习(三)---MySQL
数据库·学习·mysql
惊骇世俗王某人9 小时前
1.MySQL之如何定位慢查询
数据库·mysql
秦歌66610 小时前
向量数据库-Milvus快速入门
数据库·milvus
Edingbrugh.南空11 小时前
Flink SQLServer CDC 环境配置与验证
数据库·sqlserver·flink
码不停蹄的玄黓11 小时前
MySQL分布式ID冲突详解:场景、原因与解决方案
数据库·分布式·mysql·id冲突