「1024 TiDB AIGC 黑客松」TiDB Insight:看见分布式数据库的内部

作品说明

把 TiDB 看不见的内部机制做成可动手的模拟器:Region 分裂与选主、两阶段提交、HTAP、在线 DDL、扩缩容、向量搜索,配真实 SQL。方向:产品特性解读 / 技术概念可视化。

作品展示

六个章节,每章都是一个可以动手的模拟器:

  1. Multi-Raft:持续写入,Region 超过 384MiB 自动分裂(v8.4+ 默认 region-split-size 256MiB);让某个 TiKV「宕机」,看 Follower 等待选举超时后由多数派选出新 Leader,PD 做 balance-leader / balance-region。
  2. 分布式事务:Percolator 两阶段提交逐步演示(start_ts → prewrite → commit_ts → 先提交 primary → 异步提交 secondary),TSO 按 物理时间 << 18 | 逻辑位 解码;打开「并发冲突」可看到乐观事务的 ERROR 9007 (HY000): Write conflict。
  3. HTAP:TiKV 行存与 TiFlash 列存(Raft Learner 异步复制);OLAP 查询演示 read_index / wait_index 一致性读,并对比行存与列存扫描量。
  4. 在线 DDL:ADD INDEX 在 none → delete only → write only → write reorganization → public 间推进,边写边建索引,最后校验「索引与数据一致」。
  5. 弹性扩缩容:scale-out 后 PD 把 Region 迁到新节点;scale-in 时 store 状态 Up → Offline → Tombstone。
  6. 向量搜索:VECTOR 类型、四种距离函数、HNSW 分层检索动画;只有余弦 / L2 距离能用向量索引。

每章都有:

  • 「显示 SQL」:动画背后的真实语句;
  • 「查看真实集群」:直接查询部署在云服务器上的单节点 TiDB v8.5.8(tiup 部署,含 TiFlash),展示真实的 Region 表、EXPLAIN ANALYZE(mpp[tiflash])、DDL 任务和走 annIndex 的向量查询计划;
  • 所有技术参数对照 TiDB v8.5 官方文档逐条核对,简化之处在页面上明确标注。

使用的 AIGC 工具

  • Claude Code( Opus 5):从方案、事实核查(逐条对照 TiDB v8.5 文档)、全部前后端代码、单节点 TiDB 部署到上线,均由 Claude Code 及其子代理完成;我负责选题、决策和验收。
  • 建模:程序化建模 TiDB 集群三维主视觉(TiDB / PD / TiKV / TiFlash),多角度渲染关键帧。
  • 火山引擎 Seedance(豆包视频生成):以关键帧做图生视频,生成发布短片镜头与两条竖版 AI 主讲视频;Claude Code 逐镜抽帧自查,不合格的重新生成。生成镜头只用抽象隐喻,产品界面一律取自站点真实录屏。
  • 语音合成:中文旁白;字幕按实测语音时长自动排版。
  • 功能演示视频:Playwright 自动录屏 + 语音合成播报 + 自动生成字幕,脚本同样由 Claude Code 编写。
  • 技术栈:React + TypeScript + Apache ECharts,风格致敬 OSSInsight。

社媒传播

4 个赞

不错,学习了。

厉害啊,大佬

厉害,可以再增加一些带有负载瓶颈的解说。

这也太酷啦!好适合教学使用!!
恭喜老师您的作品审核通过,可进入下一阶段社区投票~ 期待这位大佬创作更多有趣更硬核的技术解读作品呀!

这也太酷啦!好适合教学使用!!
恭喜老师您的作品审核通过,可进入下一阶段社区投票~ 期待这位大佬创作更多有趣更硬核的技术解读作品呀!

这个作品挺厉害的哇