视频字幕(口播稿 · CSN 全序 · 第三方开发者口径)
版本:2026-11-12 首版(EP02,第一季第二期)
承接:《并行逻辑解码 · 口播稿与字幕》(EP01)
主钩子:并发提交的时间是乱的,但只要给每次 commit 分配一个单调递增的号,订阅端就能自己排好序
选题依据:[选题库.md] 的 EP02(第一季主线「机制族」)
一、身份口径(沿用 EP01,硬性约束)
以独立开发者 / PostgreSQL 社区贡献者身份讲述公开机制,全程不出现:
- 公司名称、品牌名、产品名、Logo
- 客户名称、案例项目名、内部项目代号
- 未公开的内部数据、内部架构命名、内部人员信息
可出现:
- PostgreSQL 18、openGauss、reader / worker、逻辑复制、WAL、CSN、commit 顺序等公开技术概念
- 上游源码与设计稿中已公开的机制描述
⚠️ 本期的口径红线:CSN 是 openGauss 的实现,不是 PostgreSQL 18 的能力。
口播第 10 句必须把这条边界说出来,不能让观众以为 PG 18 也有 CSN。
二、口播稿(10 句,每行一句)
大家好,我是关注数据库内核方向的独立开发者。
接着上期的问题:提交顺序到底是怎么定的?
并发时 commit 的先后是乱的,按时间戳排并不可靠。
openGauss 的做法是给每次提交发一个号,叫 CSN。
号从哪来?一个 64 位原子计数器,自增一号就归你。
所以不管谁先谁后,号的顺序永远和领取顺序一致。
这个号会写进 WAL 的提交记录,一路带到订阅端。
订阅端拿到号,就知道这条变更该不该先应用。
整个链路有六层保障,从计数器一直管到订阅端校验。
不过它的边界很清楚:这是 openGauss 的做法,不是 PostgreSQL 18 的能力。
| 项 | 值 |
|---|---|
| 字数 | 267 字 |
| 句数 | 10 句 |
| 实际时长 | 35.316 秒(EP01 实测 255 字 / 33.156 秒,本期 267 字) |
末尾一句是边界声明,也是人格规范 §5 要求的「什么时候不该用/不是谁的能力」。
这一期结尾落在边界上是有意的:EP01 结尾落在价值上(「实用性很高」),
两期一正一反,观众能感觉到这期说的是「一条路,但不是所有人的路」。
三、字幕文本(每行视觉宽度 ≤ 14,与口播逐句对应)
| # | 字幕 | 备注 |
|---|---|---|
| 1 | 关注数据库内核的独立开发者 | 身份行 |
| 2 | 提交顺序是怎么定的 | 承接上期 |
| 3 | 并发提交 时间顺序不可靠 | 痛点 |
| 4 | openGauss 用 CSN 编号 | 方案 |
| 5 | 64 位原子计数器 | ★ 数字强调 |
| 6 | 号码顺序永远单调 | 核心性质 |
| 7 | CSN 写进 WAL 带到订阅端 | 传播 |
| 8 | 订阅端按 CSN 决定可见性 | ★ 核心图示 |
| 9 | 六层机制 从计数器到订阅端 | 六层一览 |
| 10 | 这是 openGauss 的做法 | ★ 边界声明 |
宽度按视觉宽度计(中文 1、拉丁 0.5),由
pipeline/pyv/timeline.py的display_width()校验。表格行数必须与口播稿句数一致,否则align直接报错。
四、分段时间轴
时间码由 pipeline/pyv/align.py 从本期旁白的静音点产出,写入storyboard_csn-total-ordering.json。本表只固定段落归属与顺序。
| # | 段 | 段落 | 句 | 画面 | 来源 |
|---|---|---|---|---|---|
| 1 | s01 | 身份 | 1 | 小象入场 + 标题卡 | code(复用 s01_intro) |
| 2 | s02 | 乱序 | 2–3 | 三个事务在 commit 时间轴上交错 | code(新场景 s02_mixed) |
| 3 | s03 | 发号 | 4–6 | 原子计数器自增取号 | code(新场景 s03_counter) |
| 4 | s04 | 传播 | 7–8 | 号进 WAL → 协议下发 → 订阅端 | code(新场景 s04_propagate) |
| 5 | s05 | 六层 | 9 | 六层机制一览 | code(新场景 s05_layers) |
| 6 | s06 | 收束 | 10 | 落版 + 边界声明 | code(复用 s06_outro) |
契约在
contracts/csn-total-ordering.json。
s02 的时间轴是示意图:三个事务谁先 commit 不由编号决定,
画面只表达「先后是乱的」这一结构,不承载任何实测时间点。
五、数据与机制出处
| 陈述 | 出处 | 状态 |
|---|---|---|
| 并发时 commit 的先后是乱的 | docs/source-tracks/postgresql/logical-replication/opengauss-csn-total-ordering/index.md §6.2(「即使乱序执行,返回值也是严格递增的」) |
上游公开源码,可引用 |
| 按时间戳排并不可靠 | 通用并发事实,不是 openGauss 专有结论 | 不标注出处;只作机制背景 |
nextCommitSeqNo 用 pg_atomic_fetch_add_u64 分配 CSN |
同上 §二、§6.2(源码行号已记) | 上游公开源码,可引用 |
| CSN 单调性来自原子自增,与 commit 实际时刻无关 | 同上 §6.2 | 上游公开源码,可引用 |
| 全序由六层机制保证 | 同上 §六(L1~L6 表格) | 上游公开源码,可引用 |
| CSN 写进 commit 的 WAL 记录 | 同上 §三、§5.1 | 上游公开源码,可引用 |
| BEGIN 消息携带 CSN(协议新增字段) | 同上 §5.5、§6.5 | 上游公开源码,可引用 |
| 订阅端用 CSN 判断可见性 | 同上 §5.7、§六 L6、§八 | 上游公开源码,可引用 |
与 PostgreSQL 18 的 SerializableSnapshot 全序是两条不同路线 |
同上 §十一 | 可公开引用 |
不得表述为:PG 18 支持 CSN、CSN 是 PostgreSQL 的能力、
CSN 比 PG 18 的方案「快 N 倍」(O(1) 与 O(活跃事务数) 是源码机制对比,不是实测)。
六、禁止项
- 出现公司名、品牌名、产品名、Logo、客户名
- 把 CSN 说成 PostgreSQL 18 的能力
- 把源码机制对比说成性能实测数字
- 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)