PostgreSQL 太难懂？有人把它做成了城市模拟器

Nikolay Samokhvalov " 发布了 PGSimCity "。这是一款开源教育可视化工具，可以将 PostgreSQL 集群的运行机制转换成交互式 3D 空间模拟。该项目完全在浏览器中运行，无需安装本地依赖，可以通过 PGSimCity 在线可视化 "沙箱访问。它为后端开发者、站点可靠性工程师和数据库架构师弥合了高层 SQL 查询与底层内核执行之间的概念鸿沟。 其核心抽象将 PostgreSQL 18 的内部机制转换为 src/world/layout.ts " 中定义的具体市政区域。客户端连接从北部天空进入 Postmaster 管理进程，后者沿着后端大道派生工作进程。shared_buffers 池是位于城市中央的一个 1024 帧网格，旁边分布着 wal_buffers、ProcArray、锁表和提交日志（CLOG）。城市结构下方的存储挖掘区以 8 KB 页面区域、B 树、空闲空间映射（FSM）和可见性映射（VM）的形式组织堆数据。预写日志被传送至东部的 WAL 区域，walwriter 和 walsender 线程从这里广播复制流；西部维护场则容纳 checkpointer、bgwriter 和 autovacuum 工作进程。 为了忠实呈现系统架构，展示层将 three.js " 渲染与核心状态转换严格解耦。模拟状态变更由 src/sim/state.ts " 中采用 SimState 的独立 TypeScript 状态机计算，确保帧率波动不会导致内部状态失去同步。 后端开发者可以跟踪语句在解析、重写、规划和执行各阶段的生命周期，而首席数据库工程师和 SRE 则可以主动触发异常运行场景，检查引擎的故障模式。将 shared_buffers 设置为 16 MB 会强制触发 clock-sweep 淘汰竞争，后端需要先写入作为淘汰对象的脏页，然后才能读取新数据。模拟受限的 work_mem 会导致 Sort 和 HashAggregate 执行节点将临时文件溢写到 base/pgsql_tmp。 长时间运行的事务会压低 xmin 水平线，使 autovacuum 无法获得足够的清理空间并导致表膨胀；大量突发写入则会引发检查点风暴，在超过 max_wal_size / (1 + checkpoint_completion_target) 阈值时，以全页写入（FPW）淹没 pg_wal。 在 Hacker News " 上，该项目引发了关于 AI 辅助软件架构可视化和认知负担的广泛讨论。 Samokhvalov 表示，最初的原型通过消耗数十亿 token 的大语言模型提示构建，随后又对照 PostgreSQL REL_18_STABLE 源代码进行了大量人工校准。社区反馈推动了降低 UI 弹窗密度的工作，也催生了面向 ClickHouse 的 CHSimCity " 等衍生项目。 PGSimCity 还集成了 PGlite "，可以直接在浏览器的客户端线程中运行编译为 WebAssembly 的真实内存版 PostgreSQL。展望未来，该项目的 ROADMAP.md " 列出了多项核心技术里程碑：引入语句池化可视化模式；使缓冲帧环大小模型与 PostgreSQL 18 的动态 io_combine_limit " 和 effective_io_concurrency " 规则保持一致；扩展交互式查询计划路径；实施每夜运行的变异测试门禁，以针对上游 REL_18_STABLE 分支强化确定性验证引擎。完整代码库、文档和运维测试套件均可在 PGSimCity GitHub 仓库 "中获取，并采用 Apache-2.0 许可证 "，鼓励开发者提供反馈、创建分支并参与贡献。 原文链接： https://www.infoq.com/news/2026/08/pgsimcity/ "