Couchbase中_txn文档的推荐删除方式及无影响操作方法

问题背景 #

我有一个采用事务修改Couchbase Bucket中文档的.NET 6应用，每次执行事务时，都会在_default集合下生成新的_txn文档。

问题：是否建议删除这类文档？如何在不影响当前进行中事务的前提下完成正确删除？

当前清理配置为默认值，默认清理仅处理因各类原因失败、未提交或回滚的事务，仅对_txn文件执行清理操作但不会删除它们。

解答 #

是否建议删除_txn文档 #

• 不建议手动随意删除正常的_txn文档：这类文档是Couchbase事务内部追踪状态、保障ACID特性的核心元数据，直接删除可能引发正在进行的事务出现一致性问题，或是已完成事务的残留状态无法被正确收尾。
• 仅针对已完成且无残留状态的_txn文档，或确认失败且超过清理窗口期的事务元数据，才可以考虑清理。

安全清理的正确方式 #

1. 优先依赖SDK自带的事务清理机制
   • 默认配置下，SDK会自动处理失败、未提交或回滚的事务元数据，但不会直接删除_txn文档，而是标记其为已完成状态。如果需要优化清理效果，可修改事务配置中的相关参数：
     • CleanupWindow：设置自动清理的时间窗口，超过窗口的失效事务元数据会被处理
     • CleanupLostAttempts：开启后可清理因客户端崩溃等意外情况遗留的事务
     • CleanupQueueSize：调整清理任务的并发处理队列大小，优化清理效率
   • 这些参数可在初始化事务管理器时自定义配置，让清理逻辑自动运行，无需手动介入。
2. 手动清理的严格前提
   • 若必须手动清理，需先查询_txn文档的state字段：
     • 仅删除state为COMMITTED、ABORTED且已超过事务超时时间的文档
     • 绝对不能删除state为ACTIVE的文档，这类属于正在执行中的事务
3. 禁止盲目批量清理
   • 不要直接执行批量删除操作清理所有_txn文档，必须逐一校验事务状态，防止误删活跃事务的元数据，导致数据一致性异常。

内容的提问来源于stack exchange，提问作者Diego Arias