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

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

showExpandedEvents

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

6.0 版新增功能。

startAfter

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

startAtOperationTime

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

举例

使用下面的聚合命令创建一个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") }
}
相关推荐
GeW19 小时前
世界目光聚焦中国:底层技术、Linux、数据库的破局逻辑
linux·数据库
PingCAP20 小时前
平凯数据库 × 圣诺云数:让治理数据实时可用、跨域可信流通
数据库·tidb
利威尔xu20 小时前
PostgreSQL 索引失效 4 类:函数运算让查询全表扫描拖垮性能
开发语言·数据库·postgresql·性能优化·索引优化
PingCAP20 小时前
挚文集团(陌陌、探探)从 MySQL 分库分表到 TiDB 实时统一架构的实践
数据库·tidb
Decay__20 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
杨凯凡20 小时前
Spring Framework 7 原生重试与并发限制实战:@Retryable、@ConcurrencyLimit 能替代 Resilience4j 吗?
数据库·spring·sqlserver
星恒随风21 小时前
MySQL 从零入门(十):MVCC、Undo Log 与 Read View 详解——InnoDB 如何实现事务隔离?
linux·数据库·笔记·sql·mysql
zdr尽职尽责21 小时前
终端工具凭空消失:Codex + GPT-6 的一次完整排障复盘
数据库·gpt·学习·ai
txxzjmzlh1 天前
Redis 介绍及简单使用
数据库·redis·缓存
进击的荆棘1 天前
MySQL——数据类型
数据库·mysql