视频字幕(口播稿 · 并行接收之后,谁先应用 · 第三方开发者口径)
版本:2026-11-12 首版(EP04,第一季第四期)
承接:《WAL 里的顺序,不等于事务的顺序 · 口播稿与字幕》(EP03)
主钩子:发布端并行了,订阅端还在排队;难的不是并行接收,而是判断哪两条事务不能同时应用
选题依据:[选题库.md] 的 EP04(第一季主线「机制族」)
一、身份口径(沿用 EP01,硬性约束)
以独立开发者 / PostgreSQL 社区贡献者身份讲述公开机制,全程不出现:
- 公司名称、品牌名、产品名、Logo
- 客户名称、案例项目名、内部项目代号
- 未公开的内部数据、内部架构命名、内部人员信息
可出现:
- PostgreSQL、逻辑复制、并行 apply、事务、冲突、依赖图等公开技术概念
- 上游源码与设计稿中已公开的机制描述
⚠️ 本期的口径红线(硬要求):本期讲的是我自己写的一套订阅端并行 apply 设计方案
(出处:docs/source-tracks/postgresql/logical-replication/logical_parallel_apply/下三份内部设计文档)。
它尚未合入上游主线,也没有上线实现。
口播第 10 句必须把这条边界说出来,不能讲成「PostgreSQL 18 已经这样了」。画面上不出现设计文档内部的项目代号,只讲「窗口调度」「冲突判定」「依赖图」这些通用说法。
二、口播稿(10 句,每行一句)
大家好,我是关注数据库内核方向的独立开发者。
前几期都在讲发布端,这期把镜头转到订阅端。
上游的并行 apply 是单事务内多流并行,事务之间还是排队。
排队不是最难的,难的是这几条事务能不能同时应用。
判据是它们有没有改到同一行,也就是有没有冲突。
有冲突的必须排在前面,没冲突的可以一起做。
所以要先看一个窗口,默认 1000 笔事务、10 秒或 1GB 先到就调度。
把事务之间的依赖画成一张图,按图的顺序分发出去。
最后按依赖顺序统一提交,提交的先后不能乱。
边界很清楚:这是我自己的设计方案,还没合进上游主线。
| 项 | 值 |
|---|---|
| 字数 | 251 字 |
| 句数 | 10 句 |
| 实际时长 | 待出片时实测(EP02 为 35.316 秒 / 267 字,本期 251 字) |
第 10 句是边界声明,也是人格规范 §5 要求的「什么时候不该用 / 不是谁的能力」。
这一期是全季唯一一期讲作者自己未落地的方案的,边界必须说在最后一句,
不能藏在字幕角落。
三、字幕文本(每行视觉宽度 ≤ 14,与口播逐句对应)
| # | 字幕 | 备注 |
|---|---|---|
| 1 | 关注数据库内核的独立开发者 | 身份行 |
| 2 | 镜头转到订阅端 | 承接上期 |
| 3 | 事务之间还是排队 | 上游现状 |
| 4 | 难的是能不能同时应用 | ★ 转折 |
| 5 | 有没有改到同一行 | ★ 冲突判据 |
| 6 | 有冲突的排在前面 | 冲突处置 |
| 7 | 1000 笔或 10 秒触发 | ★ 数字强调 |
| 8 | 依赖画成一张图 | ★ 核心图示 |
| 9 | 按依赖顺序统一提交 | 调度收口 |
| 10 | 我自己的设计方案 | ★ 边界声明 |
宽度按视觉宽度计(中文 1、拉丁 0.5),由
pipeline/pyv/timeline.py的display_width()校验。表格行数必须与口播稿句数一致,否则align直接报错。
四、分段时间轴
时间码由 pipeline/pyv/align.py 从本期旁白的静音点产出,写入storyboard_parallel-apply.json。本表只固定段落归属与顺序。
| # | 段 | 段落 | 句 | 画面 | 来源 |
|---|---|---|---|---|---|
| 1 | s01 | 身份 | 1 | 小象入场 + 标题卡 | code(复用 s01_intro) |
| 2 | s02 | 排队 | 2–3 | 订阅端单线程接收,事务排队 | code(新场景 s02_apply_queue) |
| 3 | s03 | 判据 | 4–6 | 同一行 → 冲突 → 冲突键三要素 | code(新场景 s03_conflict_key) |
| 4 | s04 | 建图 | 7–8 | 窗口阈值 + 依赖 DAG | code(新场景 s04_dependency_dag) |
| 5 | s05 | 调度 | 9 | 按拓扑序分发 + 统一提交 | code(新场景 s05_scheduler) |
| 6 | s06 | 收束 | 10 | 落版 + 边界声明 | code(复用 s06_outro) |
契约在
contracts/parallel-apply.json。
画面上的四个事务、依赖边都是示意例子,用来表达「有冲突的排在前面」这个结构,
不是设计文档里的真实用例。
五、数据与机制出处
| 陈述 | 出处 | 状态 |
|---|---|---|
上游的 streaming=parallel 是单事务内多流并行,事务之间仍是串行 |
docs/source-tracks/postgresql/logical-replication/logical_parallel_apply/逻辑复制并行apply概要设计文档.md §3.3、§11 |
上游公开机制,可引用 |
方案复用上游已有的 ParallelApplyWorkerInfo 与 pa_launch_parallel_worker,只加窗口调度层 |
同上 §3.3 | 上游公开机制 + 内部设计 |
冲突键由表、索引与键值构成(relid / index_oid / key_values) |
docs/source-tracks/postgresql/logical-replication/logical_parallel_apply/逻辑复制并行apply依赖冲突检测设计文档.md §4.1 |
内部设计文档 |
用 last_writer 做到 O(1) 判断「谁最后写过这个 key」 |
同上 §5.1、§5.2 | 内部设计文档 |
| 窗口内构造依赖 DAG,按拓扑序调度 | 逻辑复制并行apply概要设计文档.md §8.1、§9.1、§9.2 |
内部设计文档 |
| 窗口默认 1000 笔事务 / 10 秒 / 1GB,三者任一达到即触发调度 | docs/source-tracks/postgresql/logical-replication/logical_parallel_apply/逻辑复制并行apply接口文档.md §5.1、§5.5 |
内部设计文档(文档另列 transaction_parallel_min_transactions 默认 5,为最小事务数门槛) |
| 提交顺序由提交协调器按 commit LSN 排序后逐个提交 | 逻辑复制并行apply概要设计文档.md §10.1、§10.2 |
内部设计文档 |
不得表述为:PostgreSQL 18 已经支持多事务并行 apply;
方案已经实现或已经在生产环境跑过;窗口大小是上游的默认值。
画面上不出现设计文档内部的项目代号。
六、禁止项
- 出现公司名、品牌名、产品名、Logo、客户名
- 出现设计文档内部的项目代号与内部架构命名
- 把内部设计方案说成「PostgreSQL 18 已经这样了」或「已经合入主线」
- 把设计文档里的默认参数说成上游的默认参数
- 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)