视频字幕(口播稿 · 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 说成上游的
- 把文档里的举例说成实测数据
- 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)