Docs 菜单
Docs 主页

opts 可以是 NULL 或带有附加命令选项的 BSON 文档:

  • batchSize: int32 表示每次调用 mongoc_change_stream_next 时请求返回的文档数量

  • resumeAfter:表示变更流的逻辑点的Document。此处可使用 mongoc_change_stream_get_resume_token 的结果或从变更流收到的任何变更的 字段。_id此选项与 startAfterstartAtOperationTime 互斥。

  • startAfter:表示变更流的逻辑点的Document。与 resumeAfter 不同,这可以在“无效”事件后恢复通知。此处可使用 mongoc_change_stream_get_resume_token 的结果或从变更流收到的任何变更的 字段。_id此选项与 resumeAfterstartAtOperationTime 互斥。

  • startAtOperationTime:一个Timestamp 。 变更流仅提供在指定时间戳时或之后发生的变更。 针对服务器运行的任何命令都将返回可在此处使用的optime 。 此选项与resumeAfterstartAfter互斥。

  • maxAwaitTimeMS: int64 表示调用 mongoc_change_stream_next 将区块等待数据的最长时间

  • fullDocument:可选的 UTF-8 string 。 将此选项设置为 "默认"、"updateLookup"、"whenAvailable" 或 "required",如果未设置,则假定string "默认"。 将此选项设置为“updateLookup”,以指示变更流游标查找与更新变更流事件关联的文档的最新多数提交版本。

  • fullDocumentBeforeChange:可选的 UTF-8 string 。 将此选项设置为 "whenAvailable"、"required" 或 "off"。 未设置时,默认值为“off”。 与“fullDocument”类似,但返回关联更改之前的文档值。

  • showExpandedEvents:设置为true可返回变更流事件的展开列表。 仅适用于6.0以上的 MongoDB 版本

  • comment: 一个bson_value_t,指定要附加到该命令的注释。注释将显示在日志消息、分析器输出和 currentOp 输出中。在MongoDB 4.4 之前的版本中,仅支持字符串值。