视频字幕(口播稿 · 为什么 DDL 同步不能直接把 SQL 文本发过去 · 第三方开发者口径)
版本:2026-11-12 首版(EP05,第一季第五期)
承接:《并行接收之后,谁先应用 · 口播稿与字幕》(EP04)
主钩子:社区讨论的方向不是「把 DDL 当字符串发过去」,而是拆成带语义的结构化对象
选题依据:[选题库.md] 的 EP05(第一季主线「机制族」)
一、身份口径(沿用 EP01,硬性约束)
以独立开发者 / PostgreSQL 社区贡献者身份讲述公开机制,全程不出现:
- 公司名称、品牌名、产品名、Logo
- 客户名称、案例项目名、内部项目代号
- 未公开的内部数据、内部架构命名、内部人员信息
可出现:
- PostgreSQL、逻辑复制、DDL、WAL、deparser、schema / name mapping 等公开技术概念
- 社区邮件、wiki 讨论中已公开的方向
- 作者本人读过的内部设计稿里的结论性内容(须标明是设计方案)
⚠️ 本期的口径红线(硬要求):结构化 DDL 社区讨论里没有一个已经合入主线的最终版本
(出处文档原话)。本期讲的是社区讨论的方向,不是已发布特性,
更不能说「PostgreSQL 18 支持结构化 DDL」。
第 10 句必须把这条边界说出来。
二、口播稿(10 句,每行一句)
大家好,我是关注数据库内核方向的独立开发者。
前面几期都在讲数据怎么复制,这期讲结构怎么跟着走。
最直觉的做法是:DDL 写进 WAL,解码出来原样发给订阅端。
听着最省事,但社区讨论下来,它有 4 条做不到的事。
订阅端只拿到文本,就没法判断这条命令到底做了什么。
所以方向是拆成带语义的结构化对象,分五步走。
先捕获,再结构化,中间过一次 deparse。
deparser 会补全 schema name,也会把没发布的表过滤掉。
最后订阅端按语义执行,这样才支持名字映射和跨版本。
边界要说清:社区还在讨论,还没有合入主线的版本。
| 项 | 值 |
|---|---|
| 字数 | 260 字 |
| 句数 | 10 句 |
| 实际时长 | 待出片时实测(EP02 为 35.316 秒 / 267 字,本期 260 字) |
第 10 句是边界声明。EP05 是季末,这期讲的是「怎么判断」而不是「怎么实现」,
收在边界上正好把整个季的基调立住。
三、字幕文本(每行视觉宽度 ≤ 14,与口播逐句对应)
| # | 字幕 | 备注 |
|---|---|---|
| 1 | 关注数据库内核的独立开发者 | 身份行 |
| 2 | 结构怎么跟着走 | 引入 DDL |
| 3 | DDL 原样发给订阅端 | 直觉做法 |
| 4 | 它有 4 条做不到的事 | ★ 数字强调 |
| 5 | 订阅端只拿到文本 | ★ 问题 |
| 6 | 拆成带语义的结构 | 方向 |
| 7 | 捕获 结构化 deparse | ★ 五步 |
| 8 | 补全名字 过滤未发布表 | deparse 作用 |
| 9 | 按语义执行 支持名字映射 | ★ 收益 |
| 10 | 社区还在讨论 未合入主线 | ★ 边界声明 |
宽度按视觉宽度计(中文 1、拉丁 0.5),由
pipeline/pyv/timeline.py的display_width()校验。表格行数必须与口播稿句数一致,否则align直接报错。
四、分段时间轴
时间码由 pipeline/pyv/align.py 从本期旁白的静音点产出,写入storyboard_structured-ddl.json。本表只固定段落归属与顺序。
| # | 段 | 段落 | 句 | 画面 | 来源 |
|---|---|---|---|---|---|
| 1 | s01 | 身份 | 1 | 小象入场 + 标题卡 | code(复用 s01_intro) |
| 2 | s02 | 直觉 | 2–4 | 原样发一段 SQL 文本 | code(新场景 s02_raw_sql) |
| 3 | s03 | 问题 | 5 | 订阅端只拿到一段文本 | code(新场景 s03_structured) |
| 4 | s04 | 五步 | 6–8 | 捕获 → 结构化 → deparse → 专用消息 → 按语义 apply | code(新场景 s04_ddl_pipeline) |
| 5 | s05 | 收益 | 9 | 名字映射 + 跨版本 | code(新场景 s05_ddl_benefit) |
| 6 | s06 | 收束 | 10 | 落版 + 边界声明 | code(复用 s06_outro) |
契约在
contracts/structured-ddl.json。
五步链路的步骤名与顺序取自社区讨论文档里的五步划分,画面不额外发明步骤。
五、数据与机制出处
| 陈述 | 出处 | 状态 |
|---|---|---|
| 直接把 DDL 当字符串发过去的 4 个短板:过滤粒度、名字映射、异构兼容、安全 | docs/source-tracks/postgresql/logical-replication/逻辑复制支持ddl问题.md §4.1–§4.4 |
社区讨论,可引用 |
| 结构化 DDL 的实现可以分成 5 步 | 同上 §2 | 社区讨论,可引用 |
| deparser 的作用:规范化表示、补全 schema name、过滤未发布对象、拆分混合命令、拒绝不安全表达式 | 同上 §2 第三步 | 社区邮件举例,可引用 |
| 订阅端按语义 apply 的 5 个动作:读消息头 → 合法性检查 → 名字映射 → 依赖检查 → 重建并执行 | 同上 §2 第五步 | 社区讨论,可引用 |
| 结构化之后才能做选择性复制、名字映射、语法不兼容修复、异构复制 | 同上 §2 第五步 | 社区讨论,可引用 |
| 社区讨论里没有一个已经合入主线的最终版本 | 同上 §2 首句 | 原话即红线 |
不得表述为:PostgreSQL 18 支持结构化 DDL;这套方案已经实现;
把社区邮件里提过的拟议 WAL 记录名说成已存在的记录类型。
画面上不出现具体记录名与内部设计稿里的实现细节。
六、禁止项
- 出现公司名、品牌名、产品名、Logo、客户名
- 出现内部设计稿里的实现细节与项目代号
- 把社区讨论方向说成「PostgreSQL 18 的能力」或「已经合入主线」
- 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)