第 18 章读者视角自审记录

本次实战篇合并后，本记录及正文已同步为当前章号；下文早期第五、六章的称呼保留历史语境。

2026-10-17：由原第五章迁入高级篇。以下保留原审阅记录，其中第五章指现第十八章、第六章指现第十九章；迁移不代表已完成高级篇扩写或用户审阅。

自审日期：2026 年 10 月 15 日。正文：自然语言到语义 SQL 再到 DSL 和物理 SQL。待用户统一审阅。

• 开篇明确 Foggy Virtual Semantic SQL 的设计定位，教学 SQL 不充当已支持的 CLI 入口。
• 保持上一章的模型和字段，解释前后两个 SQL 各自面向什么；虚拟表不等于提前搬运数据。
• 引用带 $ 的字段时加双引号，按客户 ID 和名称分组，保留左闭右开日期和稳定排序。
• 本例的 SUM(salesAmount) 只用于可加总的单票金额；平均值与 Cube MEASURE() 单独解释，避免误认为所有指标都可 SUM。
• SQL 到 JSON 不简化成关键词替换；区分语法不支持、字段不可见、业务定义缺失的处理方式。

依据：v1.0 白皮书第 8.4 节、Query DSL 参考，以及 2026 年 10 月 15 日核对的 Cube 官方文章。Cube 的机制不推广为所有产品的统一实现。

核对方法：用 SQLite 临时视图模拟本章约定的简单字段映射，执行教学 SQL，与第 1、4 章物理查询比较。该核对只验证示例含义与数据结果，不验证 Foggy 的 SQL 前端、模型加载、权限或编译。

核对已通过：三份 SQL 的客户、金额和排序一致，结果为 5500、4200、3000 元。核对输出保留验证范围。

同步产品无关的前序示例（2026-10-17）

按用户对前序概念讲解的要求，同步第四章沿用的 customerId/customerName 和返回条数约定，移出私有引擎术语。教学 SQL 在 SQLite 临时视图中与第一章及第四章基线核对一致；不宣称运行过真实语义引擎或证明双入口实现。合订稿已同步，具体产品实战留应用篇。

与前章衔接及通用概念复审（2026-10-17）

本轮按用户要求保持精练、产品无关，以下结论替代历史稿中的产品语法讲解安排。

• 开头承接第四章：仍使用同一语义模型、字段和客户排名问题，只更换 LLM 提交查询的方式。业务用户依旧自然语言提问，避免读者误以为需要让业务用户改写 SQL。
• 说明虚拟业务表由语义层的 SQL 入口识别，与同名物理表或数据库视图区分；LLM 复用 SQL 语法经验，仍需语义模型元数据与操作说明。
• 保留一段语义 SQL 及其与第四章教学 DSL 的逐项对应，不再重贴 DSL 或物理 SQL。
• 流程图精简为五个节点，正文简要解释 AST、语义模型绑定、类型/聚合/权限校验；明确关键词对照不是通用转换算法，内部计划不必导出公开 JSON。
• 移除具体产品及专用指标函数，用第三章的平均值案例作简短回扣，只强调 SQL 入口仍须保留指标语义，不重复展开平均值公式与示例。
• 支持范围段聚焦 SQL 入口的能力边界与等价改写条件，删除与第四章重复的字段错误分类；结尾自然引出第六章两个入口共用执行计划。
• 已逐段读回并同步合订稿及写作方案。教学 SQL 和配套 SQL 文件保持一致，未修改数据或查询，沿用既有 SQLite 等价性核对结果，本轮未重复执行数据库。