MongoDB聚合：$changeStreamSplitLargeEvent

变更流（Change stream）允许应用访问数据实时变更情况，应用可以使用变更流订阅集合、数据库甚至整个部署的数据变化并直接跟它们进行交互。因为变更流使用了聚合框架，所以应用也可以筛选特定的变化并灵活的转换通知。

如果变更流的事件超过16M，将返回BSONObjectTooLarge异常。不过从7.0开始，MongoDB提供了$changeStreamSplitLargeEvent阶段，支持把事件拆分成多个小的片段。在必要时应该使用$changeStreamSplitLargeEvent，例如应用需要整个文档的pre-images或post-images，并且产生的大事件超过了16MB，就应该使用$changeStreamSplitLargeEvent

在决定使用$changeStreamSplitLargeEvent之前，应该先尝试降低变更事件的大小，例如：

• 若非必要，不要请求pre-images和post-images文档，在大多数情况下会生成fullDocument和fullDocumentBeforeChange字段，它们通常是变更事件最大的对象。
• 使用$project只选取应用需要的字段，这可以减小变更事件的大小并避免把大事件拆分为片段时耗费过多的时间，也就可以一次返回更多的变更事件。

聚合管道中只能有一个$changeStreamSplitLargeEvent，而且必须放在管道的最后，$changeStreamSplitLargeEvent只能用于$changeStream管道。

语法

{
   
   
  $changeStreamSplitLargeEvent: {
   
   }
}

$changeStreamSplitLargeEvent会把超过16MB的事件分割成多个片段，并使用变更流游标按顺序返回这些片段。分割片段时，会在第一个片段中返回最大数量的字段，这样可以确保尽快返回事件上下文。分割变更事件时，只使用顶层字段的大小。$changeStreamSplitLargeEvent不会递归处理或分割子文档。例如，如果使用$project阶段创建一个单字段大小为 20MB的变更事件，则该事件不会被拆分，而是会返回错误信息。

每个片段都有一个恢复标记。使用片段令牌恢复的数据流有以下两种情况：

• 从后续片段开始新的数据流。
• 如果从序列中的最后一个片段恢复，则从下一个事件开始。

事件的每个片段都包含一个splitEvent文档：

splitEvent: {
   
   
   fragment: <int>,  //片段索引，从1开始
   of: <int>         //片段中事件总数
}

举例

下面的示例显示了$changeStreamSplitLargeEvent在集合myCollection中的使用。创建myCollection并插入一个数据量略低于16MB的文档：

db