视频字幕(口播稿 · 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 改版新增)
- 并行解码是 openGauss 的实现,不是 PostgreSQL 18 的能力。
docs/source-tracks/postgresql/logical-replication/pa_decode/概要设计说明书-v2.md是一份设计提案,
它自己就写着「建议新增或改造的机制」「不能直接视为已经具备的内核能力」,
不能拿它当「PostgreSQL 18 已有此功能」的证据。 - 「2 到 5 倍」是作者本人在 openGauss 上压出来的,不是官方数据、不是社区共识。
归因必须写明「我在 openGauss 上本地压测」。 - 提交顺序不归本期。「按事务结束顺序输出、订阅端顺序与发布端一致」整段删掉,
顺序问题留给 EP02(CSN 全序)——那才是 openGauss 真正解决顺序的方式。 - 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(仓库里没有依据)
- 出现具体客户、内部项目代号、内部人员信息
- 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)