一个 64 位计数器,决定所有事务的提交顺序


难度 中等

视频字幕(口播稿 · 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 的能力
  • 把源码机制对比说成性能实测数字
  • 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)

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