关于Cosmos DB存储过程批量创建文档后Change Feed顺序异常的问询

假设验证 #

你的假设完全正确：Cosmos DB对于同一事务内、拥有相同_ts值的文档，Change Feed并不保证严格遵循存储过程内的创建顺序。

原因在于，Cosmos DB的事务是原子性的，但同一事务内的多个文档在底层存储层可能会被并行处理、分发到不同的物理节点分片，Change Feed的拉取逻辑是基于分区内的日志增量，当多个文档共享同一_ts时，系统没有额外的内置排序规则来保留存储过程中的调用顺序，所以会出现偶尔颠倒的情况。

缓解方案（除分两次调用存储过程外） #

• 在文档中新增自定义事务内顺序字段，比如TxnSeq，存储过程创建文档时按顺序赋值（如0、1）。Change Feed消费时，先将同一_ts的文档暂存，再根据TxnSeq字段排序后再处理。
• 创建复合索引：将_ts和自定义顺序字段（或Version）设为复合索引键。消费Change Feed时，对拉取到的同_ts文档执行本地排序，复合索引能确保排序操作的高效性，避免全文档扫描。
• 调整数据模型为事件数组模式：将同一事务内的多个文档合并为一个单文档，内部用数组存储不同版本的内容（如[{Version:0,...}, {Version:1,...}]）。Change Feed消费时直接解析数组，按数组内的顺序处理，从根源上避免顺序问题。
• 新增事务元数据文档：在存储过程中，除了创建业务文档，还创建一个包含事务ID、文档顺序列表的元数据文档。Change Feed消费时，先获取对应事务的元数据，再根据元数据中的顺序匹配并处理业务文档。

内容的提问来源于stack exchange，提问作者Travis Troyer