WAL 里的顺序,不等于事务的顺序


难度 中等

视频字幕(口播稿 · WAL 里的顺序,不等于事务的顺序 · 第三方开发者口径)

版本:2026-11-12 首版(EP03,第一季第三期)
承接:《CSN 全序 · 口播稿与字幕》(EP02)
主钩子:WAL 是操作级记录,几个事务交错着写;订阅端要的是「一个事务一整组」
选题依据:[选题库.md] 的 EP03(第一季主线「机制族」)


一、身份口径(沿用 EP01,硬性约束)

以独立开发者 / PostgreSQL 社区贡献者身份讲述公开机制,全程不出现:

  • 公司名称、品牌名、产品名、Logo
  • 客户名称、案例项目名、内部项目代号
  • 未公开的内部数据、内部架构命名、内部人员信息

可出现:

  • PostgreSQL、逻辑复制、逻辑解码、WAL、xid、ReorderBuffer、LSN 等公开技术概念
  • 上游源码与设计稿中已公开的机制描述

⚠️ 本期的口径红线:本期讲的是上游逻辑解码的公开机制
(ReorderBuffer 按事务号聚合、commit 时整组发出、组间按 commit LSN 顺序)。
不是 openGauss 的 CSN 方案——那是 EP02 讲的,openGauss 在上游机制之上额外加的;
也不是 PostgreSQL 18 的新能力,本期没有任何一处依赖版本。
画面上那组 LSN 是出处文档里的举例,不是实测数据。


二、口播稿(10 句,每行一句)

大家好,我是关注数据库内核方向的独立开发者。
上一期讲了提交顺序怎么定,这期往回退一步。
WAL 是操作级记录,一行只写一个动作。
比如 6 条 WAL 记录,来自三个并发的事务。
那订阅端怎么知道哪些变更属于同一个事务?
靠的是 WAL 记录里的事务号,这是整件事能成立的前提。
这就是 ReorderBuffer,一个事务一个槽。
槽里攒的变更太多,会 spill 到磁盘,完整性一样不受影响。
攒到该事务的提交记录出现才整组发出,发出去的是提交顺序。
上游靠事务号攒成组,CSN 那一套是 openGauss 额外加的。
项 值
字数 254 字
句数 10 句
实际时长 实测 34.596 秒 / 254 字

第 10 句是边界声明:明确「上游这套」与「openGauss 的 CSN」不是同一件事,
避免观众把 EP02 的号和这期的聚合混成同一个机制。


三、字幕文本(每行视觉宽度 ≤ 14,与口播逐句对应)

# 字幕 备注
1 关注数据库内核的独立开发者 身份行
2 提交顺序往回退一步 承接上期
3 WAL 一条只写一个动作 操作级记录
4 6 条记录三个事务交错 ★ 交错示意
5 怎么知道属于同一个事务 提问
6 靠 WAL 里的事务号 ★ 前提
7 ReorderBuffer 一个事务一个槽 ★ 核心机制
8 攒多了 spill 到磁盘 落盘
9 提交记录出现才整组发出 ★ 核心机制
10 CSN 是 openGauss 额外加的 ★ 边界声明

宽度按视觉宽度计(中文 1、拉丁 0.5),由 pipeline/pyv/timeline.py 的
display_width() 校验。表格行数必须与口播稿句数一致,否则 align 直接报错。


四、分段时间轴

时间码由 pipeline/pyv/align.py 从本期旁白的静音点产出,写入
storyboard_wal-interleave.json。本表只固定段落归属与顺序。

# 段 段落 句 画面 来源
1 s01 身份 1 小象入场 + 标题卡 code(复用 s01_intro)
2 s02 交错 2–4 WAL 位置上几条记录交错 code(新场景 s02_wal_interleave)
3 s03 归并 5–7 按事务号落进各自的槽 code(新场景 s03_reorder_buffer)
4 s04 落盘 8 槽攒不下就 spill 到磁盘 code(新场景 s04_spill)
5 s05 输出 9 提交记录出现才整组发出 code(新场景 s05_emit)
6 s06 收束 10 落版 + 边界声明 code(复用 s06_outro)

契约在 contracts/wal-interleave.json。
s02 的 6 条记录与 LSN 100~150 是出处文档里的举例,
画面只表达「WAL 的物理顺序和事务的分组不是一回事」这个结构,
不承载任何实测时间点。


五、数据与机制出处

陈述 出处 状态
WAL 记录是操作级记录,只含操作类型、relation OID、tuple 数据/ctid docs/source-tracks/postgresql/logical-replication/逻辑复制解惑.md §「WAL 中事务变更特点」 上游公开机制,可引用
WAL 记录带事务号 xid 同上 上游公开机制,可引用
逻辑解码按 LSN 依次解析 WAL 同上 §「LSN 推进」 上游公开机制,可引用
交错事务的变更缓存到 ReorderBuffer 同上 §「LSN 推进」 上游公开机制,可引用
遇到 commit 记录时把整个事务一次性发出去 同上 §「提交事务时发送」 上游公开机制,可引用
事务顺序 = commit LSN 顺序 同上 §1️「事务提交与 WAL 关系」 上游公开机制,可引用
大事务会让 ReorderBuffer spill 到磁盘,仍保持完整性 同上 §「事务重组示例」后的汇总条目 上游公开机制,可引用
画面上的 6 条记录 / LSN 100~150 / xid 10·11·12 同上 §「事务重组示例」表格 文档举例,画面要说明是示意

不得表述为:这是 PostgreSQL 18 的新能力;这是 openGauss 的机制;
画上的 LSN 与条数是实测数据。


六、禁止项

  • 出现公司名、品牌名、产品名、Logo、客户名
  • 把上游的 ReorderBuffer 说成 openGauss 的能力,或反过来把 CSN 说成上游的
  • 把文档里的举例说成实测数据
  • 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)

文章作者: growdu
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 growdu !
这篇还发到了
哔哩哔哩 packaged 微信视频号 packaged douyin packaged
  目录