PostgreSQL 18 并行逻辑解码


难度 中等

视频字幕(口播稿 · openGauss 并行逻辑解码 · 第三方开发者口径)

版本:2026-11-12 改版(openGauss 归属口径:并行解码是 openGauss 的实现,不是 PostgreSQL 18 的能力)
上一版:2026-11-09(把并行解码说成 PostgreSQL 18 的能力,并把提交顺序写进了本期,已作废)
目标时长:约 32.4 秒(旁白 narration_pg-parallel-decode.mp3 实测 32.436 秒)
旁白来源:按本文件的口播稿重新合成,音色参数见 [voice/README.md] 的定标结论
主钩子:openGauss 把发布端拆成三层线程:reader 读 WAL,worker 池并行解码,walsender 收口输出


一、身份口径(本版硬性约束)

以独立开发者 / PostgreSQL 社区贡献者身份讲述上游特性,全程不出现:

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

可出现:

  • openGauss、reader / worker / walsender、逻辑复制、WAL 等公开技术概念
  • 上游源码与设计稿中已公开的机制描述
  • 作者本人的压测结论(须标注为个人实测,并说明是在哪个系统上跑的)

素材口径同步约束:

  • 形象唯一来源:character/growdu_character_2k_nobg.png(3D 卡通形象,静帧贴入)。
    场景画面与 Design 内的 H3 参考图,一律用这一套形象。
  • 不使用 docs/source-tracks/postgresql/logical-replication/pa_decode/ 目录下的任何图片(image.png、image-1.png 等),
    也不使用其它历史版本小象图;避免形象在系列内不一致。
  • 落版用个人头像 themes/matery/source/medias/avatar.jpg,不使用任何公司 Logo
  • 片头质感镜头、H3 参考图一律以这一套形象为唯一主体

本期的口径红线(2026-11-12 改版新增)

  1. 并行解码是 openGauss 的实现,不是 PostgreSQL 18 的能力。
    docs/source-tracks/postgresql/logical-replication/pa_decode/概要设计说明书-v2.md 是一份设计提案,
    它自己就写着「建议新增或改造的机制」「不能直接视为已经具备的内核能力」,
    不能拿它当「PostgreSQL 18 已有此功能」的证据。
  2. 「2 到 5 倍」是作者本人在 openGauss 上压出来的,不是官方数据、不是社区共识。
    归因必须写明「我在 openGauss 上本地压测」。
  3. 提交顺序不归本期。「按事务结束顺序输出、订阅端顺序与发布端一致」整段删掉,
    顺序问题留给 EP02(CSN 全序)——那才是 openGauss 真正解决顺序的方式。
  4. Vastbase 不出现在本期。仓库里没有任何 Vastbase 材料,没有依据的并列一律不写。

术语确认

  • 三个线程各叫各的:reader(读 WAL)、worker(并行解码)、walsender(收口输出)。
    画面上分别标注,不合并——上一版把 reader 标成 Reader (WALSender),
    与 openGauss 的实际拓扑(reader 是独立线程,walsender 单独收口)不符,已改。
  • 字幕固定写 reader,不写 leader。

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

大家好,我是关注数据库内核方向的独立开发者。
今天聊聊 openGauss 的并行逻辑解码。
常规的逻辑复制,数据同步效率一直不高。
默认发布端只有一个解码线程,串行处理。
32 核机器上,解码只占 1 核。
大事务、小事务高并发场景,都跟不上。
openGauss 把发布端拆成三层:reader 读 WAL,worker 池并行解码。
walsender 收口输出,reader 只有一个线程,因为 WAL 的页缓存不能并发。
我在 openGauss 上本地压测,整体性能提升 2 到 5 倍。
对异构数据同步这类场景,实用性很高。
项 值
字数 260 字
句数 10 句
实际时长 32.436 秒(旁白实测;成片加品牌片头片尾共 38.125 秒)

2026-11-12:整期按 openGauss 归属口径重做,旁白重新合成。
ASR 复核(成片正文段,即加了铺底音乐之后)逐句与本稿对上:
openGauss、读 WAL、WALSender 收口输出、我在 openGauss 上本地压测, 整体性能提升 2 到 5 倍 全部识别正确,没有出现 PostgreSQL 18,也没有出现「顺序」。
说明铺底音乐没有影响旁白内容。

第 7、8 句讲的是 openGauss 的真实三层拓扑(见
docs/source-tracks/postgresql/logical-replication/opengauss-parallel-decoding-design/index.md §二):
reader 单线程读 WAL(XLogReader 的页缓存非线程安全,所以只能有一个),
轮询把 change 分发给 worker 池,worker 并行解码成 logicalLog,
walsender 再轮询各 worker 的队列统一收口输出。

第 8 句里的 walsender 收口是留给 EP02 的引子:并行解码出来的数据谁先谁后,
正是下一期要答的问题。EP02 开场那句「接着上期的问题:提交顺序到底是怎么定的?」
接的就是这里——本期只把问题摆出来,答案留给 CSN。


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

# 字幕 备注
1 关注数据库内核的独立开发者 身份行
2 openGauss 并行逻辑解码 标题卡
3 常规逻辑复制效率一直不高 痛点
4 发布端只有一个解码线程 串行
5 32 核机器 解码只占 1 核 ★ 数字强调
6 大事务小事务 都跟不上 双场景
7 reader 读 WAL worker 并行 ★ 转折
8 walsender 收口 reader 单线程 ★ 核心图示
9 openGauss 本地压测 2–5 倍 ★ 数字大字
10 异构数据同步场景实用性很高 收束

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

配色沿用:问题段 #F6AD55,解决段 #4FD1C5,数字段大字号 + 强调色。


四、分段时间轴

时间码由 pipeline/pyv/align.py 从新旁白的静音点产出,人工确认后写入
storyboard_pg-parallel-decode.json。
本表只固定段落归属与顺序,与 contracts/pg-parallel-decode.json 一一对应。

# 段 段落 句 画面 来源
1 s01 身份 + 标题 1–2 小象入场 + 标题卡 code(复用 s01_intro)
2 s02 痛点 3–4 单线程解码,事务排队 code(复用 s02_serial)
3 s03 量化 5–6 32 核 vs 1 核 code(复用 s03_cores)
4 s04 机制 7–8 reader → worker 池 → walsender code(复用 s04_parallel)
5 s05 数据 9 吞吐对比 + 2–5 倍 code(新场景 s05_bench)
6 s06 收束 10 价值 + 落版(个人头像) code(复用 s06_outro)

五、数据与机制出处

陈述 出处 状态
发布端默认单解码线程串行处理 docs/source-tracks/postgresql/logical-replication/pa_decode/逻辑复制发布端现状.md(PostgreSQL 原版现状) 可公开引用
openGauss 的三层线程拓扑:reader / worker 池 / walsender docs/source-tracks/postgresql/logical-replication/opengauss-parallel-decoding-design/index.md §二(源码级拆解) 上游公开源码,可引用
reader 只有一个线程,XLogReader 的页缓存非线程安全 同上 §2.1「关键观察」 上游公开源码,可引用
worker 池大小由 parallel_decode_num 控制 同上 §2.1 上游公开源码,可引用
32 核机器上解码只占 1 核 由「单解码线程」直接推得的事实陈述 可公开引用
性能提升 2 到 5 倍 作者本人本地压测,在 openGauss 上跑的,无公开基准 必须保留「我在 openGauss 上本地压测」的归因,不得表述为官方数据

docs/source-tracks/postgresql/logical-replication/pa_decode/概要设计说明书-v2.md 是 PostgreSQL 侧的设计提案,
不是 PG18 已具备的能力,本期不拿它当出处。
上游设计稿里「性能验证与默认值评估」也仍是待办项,
不得把 2–5 倍说成「官方数据」或「社区公认结论」。


六、禁止项

  • 出现公司名、品牌名、产品名、Logo、客户名
  • 把这期说成 PostgreSQL 18 的能力(并行解码是 openGauss 的实现)
  • 把内部压测数据表述为官方或社区结论
  • 把「按事务结束顺序输出、订阅端顺序与发布端一致」写进本期(那是 EP02 的内容)
  • 出现 Vastbase(仓库里没有依据)
  • 出现具体客户、内部项目代号、内部人员信息
  • 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)

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