事务可见性、错误与重试边界¶
实现基线为 v4.2.5。事务模式、真实隔离级别、MySQL 兼容变量与数据新鲜度是不同维度;读取 @@transaction_isolation 的文本不能证明执行引擎采用了同名隔离策略。
时间戳和状态¶
值/状态 |
用途 |
诊断时需要核对 |
|---|---|---|
SnapshotTS |
本次读取的版本边界 |
RC 的语句刷新与 SI 的事务快照不同 |
PrepareTS / CommitTS |
TN 准备与提交排序 |
不与 UUID 事务 ID 或 WAL LSN 混用 |
Logtail 水位 |
CN 已同步的可读进度 |
与目标快照/最后提交比较 |
Committing / unknown |
客户端正在提交或结果不明 |
网络错误不证明提交已失败 |
BEGIN → workspace / 读写 / 锁 → 准备与提交请求
├→ 明确提交 → 释放事务资源
├→ 明确中止 → 回滚/释放
└→ 结果未知 → 解析最终状态、避免盲目重复业务写入
悲观模式默认 RC、乐观模式默认 SI,需以运行时配置确认。RC 每个语句需要合适的快照,冲突后的内部语句重试不等于应用整事务可无条件重试。乐观冲突由 TN 的时间戳/MVCC 检查裁决,不能描述成提交时获得悲观锁。
错误范围¶
情况 |
默认处理原则 |
应用处理 |
|---|---|---|
普通约束/语法等语句错误 |
|
明确选择继续、COMMIT 或 ROLLBACK |
死锁、锁超时、绑定变化和部分连接/事务状态错误 |
静态错误集合要求整事务结束 |
重新开始事务,检查错误类型与幂等性 |
|
真实语句错误触发整事务回滚 |
不能继续把后续操作当作原事务 |
提交返回不明确 |
可能尚不能判断是否生效 |
用业务幂等键/状态核对,不能仅按网络错误重放 |
以错误号和 SQLSTATE 分类,并保存事务 ID;不要依赖错误消息文本中的一个关键词。后台/内部执行会话也有自身变量与生命周期,不能简单等同于普通客户端会话。
锁与节点变化¶
CN 的 LockService 管理本地锁表并代理远程锁。TN 的分配器维护锁表绑定版本;事务提交时绑定过期可导致中止。CN 下线、锁持有者失联和 TN 重建需要可靠性处理;“缓存无状态”不表示活跃事务无状态。
死锁和锁等待不是 WAL 等待。记录锁表/服务 ID、等待者和持有者、绑定版本以及事务时间范围,再结合锁服务日志诊断。
跨 CN 可见性¶
源 CN 的提交确认、目标 CN 的 Logtail 应用和目标事务选择快照分别发生。同会话读自己的提交、同 CN 新连接与另一 CN 新连接不能互相替代测试。重连后需重建订阅状态;通过端口健康检查不证明水位已追平。