为什么 DDL 同步不能直接把 SQL 文本发过去


难度 中等

视频字幕(口播稿 · 为什么 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 的能力」或「已经合入主线」
  • 与口播不一致的字幕(字幕必须逐句对应,不得为凑画面改写事实)

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