2026-10-25 更新。用户确认本系列为第35—36章。第35章已整体读者复审,第36章按0.1.42实际验证、写作与读者自审完成,待用户审阅。下一性能系列尚未开始。
第35章正文 · 入口核对 · 实操与验收。4项语义查询、1项字段拒绝通过;数据库探查与解释另计。当前未发现原生语义SQL解析入口,不将AI转换写成引擎编译。
第36章正文 · 本章实操:7项正常查询(含2项基线复跑)、1项故意改错的执行、1项别名校验拒绝。错阶段请求校验通过,但与原SQL含义不同,单列为教学对照,不算正确转换。
回答一个问题:让 AI 使用熟悉的 SQL 表达查询时,怎样继续复用语义层的业务定义与执行规则?
主案例复用第32章的 LegacyBillQueryModel:83张有效账单、477.53教学元,客户编码已映射,状态过滤和分转元已写入语义模型。SQL面向公开业务字段,不再让AI重复处理物理字段 v0、s0。
不引入新数据库或WWI环境。客户排名、分组汇总等使用已验证基线;复杂时间分析、Pivot与Compose引用前章,不重教语法,也不要求全部改写成SQL。
读者要弄清: SQL查的是语义模型公开的业务字段,物理表映射与业务规则仍由语义层执行。
内容顺序:
SELECT / WHERE / GROUP BY / HAVING / ORDER BY / LIMIT 的对应关系。重点区分行筛选和聚合后筛选,不把转换讲成关键词替换。验收重点: 模型与字段来自实时元数据,规则没有遗漏或重复应用;客户编码、期间、总量及排名与已有基线一致。保留输入SQL、转换产物、CLI校验、执行响应和独立核对。
读者要弄清: 引擎接受转换后的DSL,不代表AI完整保留了SQL原意。本章核对AI转换产物与已审核基准,不比较两个原生SQL/DSL前端。
复用 file-legacy / LegacyBillQueryModel 和现有快照,不增加数据库或模型。固定模型版本、调用身份、期间与教学元口径;准备已审核DSL和只读原始账单的独立答案。两个由AI同时生成的请求相互一致,不能替代独立核对。
提示词保持简单,例如“把这些 SQL 转成 DSL,查询并与已确认结果核对。” SQL文件、模型信息和基准材料随任务一起提供,不把操作细节堆进提示词。
AI读取实时元数据后转换,通过CLI提交DSL校验,成功后执行。逐项保存SQL、转换产物、响应与差异;不支持的表达先说明或澄清,不能删掉条件后继续作答。
| 案例 | 核对重点 | 与前章的关系 |
|---|---|---|
| 客户排名与聚合后筛选 | 日期、分组、HAVING、返回条数和二级排序有没有丢失 | 复用第35章作基线,不重讲语法 |
| 平均账单金额 | 总金额÷账单数;全局和分组分别计算,不能相加或直接平均分组均值 | 已实测整体5.753373…及20个国家;组均额直接平均约5.84 |
| 不存在的客户或空期间 | 区分零记录、空值与零;记录当前引擎实际返回,不能擅自补零 | 已实测00999明细空数组;1990年汇总bills=0,NULL键默认省略 |
| 错误别名或含义不明确的条件 | 分清AI审查、DSL校验和结果核对各自能发现什么;不能把聚合别名误放WHERE后擅自改成HAVING | 错误排序别名在校验拒绝;含义不明的聚合WHERE由AI审查,未执行 |
先核对模型、字段、类型、日期、分组、筛选阶段与排序,再比较行数和数值,避免当前数据碰巧相等掩盖转换遗漏。物理SQL与解释只作辅助;解释若为RECOMPILED,不能称为此前执行轨迹,也不要求两段SQL文本逐字一致。
沿用已有回归方法,补少量案例,不再搭一套测试框架。脚本重放保存的转换产物,与重新让AI生成转换分开记录;此前暂缓的多次生成正确率评测仍不启动。
简述入口取舍:简单需求下SQL表达与直接DSL都可能可用;当前SQL表达路线多一次AI转换,不预设更准确或更省token。SQL工具的原生接入仍需实际接口支持;复杂时间、多维和分阶段分析引用已有DSL/Compose案例。
完成条件是:已确认案例与独立基准一致,差异和不支持项有明确解释,请求、响应与复跑记录完整。本轮均已完成;另验证47位客户完整排序,其中00013与00051同额24.75,按编号升序排列。未修改语义模型、数据或绑定,正常用例与教学错例分开计数。
现有 Skill指引描述的是将SQL式意图转换为语义DSL或Compose;v1.0白皮书将前置解析器列为演进方向。这两份材料不足以证明当前教学发行包已提供原生SQL入口。
0.1.42的公开CLI、capabilities、完整MCP工具Schema与Skill已核对,当前采用AI转换路线,正常查询与字段拒绝通过,见本轮结论。后续换版时重新核对,按真实入口选择写法:
| 实际能力 | 章节采用的讲法 |
|---|---|
| 提供原生语义SQL接口 | 展示接口的真实解析、校验、转换和执行过程,声明支持的SQL范围 |
| 只有AI转换指引(本次采用) | 明确写成“AI将语义SQL转为DSL/Compose”,校验转换产物;不称为引擎原生SQL解析器 |
| 某个表达无法等价转换 | 说明具体限制,引用已有DSL/Compose方案,或保留为概念说明 |
无论哪条路线,最终都走公开语义查询入口。AI转换不是确定性编译;单次案例通过也不证明任意SQL都能正确转换。若仅有转换指引,第二章据此核对“转换后的请求与执行规则”,不宣称两种原生前端已统一。
继续采用简单提示词、AI配合CLI、执行后独立核对。默认复用模型;确需补充字段时,先修改、校验和加载,再查询。每章最后归纳Foggy知识点,完整请求与响应放配套实操目录。
旧 语义SQL草稿与统一计划草稿只作为概念素材,原文件名保留,不能作为实测证据。后续仍按总纲进入“性能与持续运行”,届时再定章节与案例。