MetonaSqlark

Files

T

thzxx 841db2e049 fix(A22/A23/A25/A26/A27/A29/A30/A36): 查询层 8 项缺陷根治 + 单一语义收敛

每项都先用可执行探针复现出**错误的实际输出**，再修根因、补永久回归套件
（tests/v080-query-layer.test.ts，8 项 × 4 引擎 + 跨引擎项，共 111 断言）。

A22 GROUP BY 引用 SELECT 别名
  修复前：`SELECT g AS grp, COUNT(*) FROM t GROUP BY grp` 抛
  `COLUMN_NOT_FOUND Unknown column "g" in SELECT list` —— 错误信息与真正原因
  （GROUP BY 用了别名）无关，因为 grp 取到 undefined 使全表并成一组，
  投影阶段又发现 g 不在输出行里。
  修复：GROUP BY 项先解析回**基列**（别名 → 源表达式）再分组，输出键与
  "按基列分组"完全一致。

A23 HAVING 引用未出现在 SELECT 里的聚合
  修复前：`SELECT g FROM t GROUP BY g HAVING SUM(n) > 25` → `[]`
  （SUM(n) 从未被求值 → HAVING 的键在分组行里不存在 → UNKNOWN）。
  修复：需要计算的聚合 = SELECT 列 ∪ HAVING 中的聚合（并集），
  并在 HAVING **之后**才把行收缩为 SELECT 输出键（否则又变回 []；
  顺序错了会双向出错：先投影 → 空结果，不投影 → 泄漏内部聚合列）。

A25 带表前缀的聚合参数恒 0
  修复前：`COUNT(t.n)` → 0、`SUM(t.n)` → null（行键是 n，直接取 row['t.n']
  得 undefined 再被"过滤 NULL"剔除，**且不报错**）。
  修复：新增唯一列引用解析 resolveColumnValue（前缀剥离 → 精确 → 唯一后缀），
  聚合识别统一为 parseAggregateExpression —— 此前"是否聚合"与"如何求值"
  用两条不同的正则。取不到列改为抛 COLUMN_NOT_FOUND，不再静默计 0。

A26 UNION 尾部 ORDER BY/LIMIT 归属错误
  修复前：`A UNION B ORDER BY id DESC` 只排 B；`... LIMIT 3` 返回 4 行
  （parser 把子句挂在右侧 SELECT 上，AST 没有复合查询级字段）。
  修复：SelectUnionStatement 增加 orderBy/limit/offset，parser 把子句**上移**
  （移动而非复制，否则 LIMIT 应用两次），executor 在合并+去重后统一排序/切片。

A27 DISTINCT 作用在投影前
  修复前：`SELECT DISTINCT g AS d FROM t` 返回 4 行 a,a,b,b
  （对 {id,g,n} 原始行去重），而 `SELECT DISTINCT g` 返回 2 行。
  修复：DISTINCT 移到投影后（作用于输出列）；ORDER BY 的应用时机随之拆成
  "引用输出列 → 投影后" / "引用非输出列 → 投影前"，两者互为因果必须一起改。

A29 maxRowsPerQuery 静默截断写入
  修复前：maxRowsPerQuery=2 时 `INSERT INTO dst SELECT id FROM src`（4 行源）
  只写 2 行并报成功 —— 不是"限制查询规模"而是**静默丢数据**。
  修复：行源不截断（executeSelect 增加 purpose='source'），写路径显式报错。

A30 INSERT 值多于目标列静默丢弃
  修复前：`INSERT INTO t (id,g) VALUES ('9','z','LOST')` 报成功、'LOST' 消失。
  修复：显式列名时解析期拦截（PARSE_ERROR），未给列名时 executor 对照 schema
  拦截（VALIDATION_ERROR）——两种情况都需要，因为前者无需 schema。

A36 派生表别名引用
  修复前：`SELECT d.id FROM (SELECT id, g FROM t) AS d` 返回 `[]`，
  而同义的 `SELECT id FROM (...) AS d` 正确。
  修复：抽出 normalizeUnprefixedReferences（WHERE/ORDER BY/GROUP BY/SELECT
  四类引用统一剥离别名前缀），非 JOIN 单表路径与派生表路径共用同一规则。

连带根治（修复过程中发现的两个更底层问题）：

1. **同步抛错穿过 async 边界**：`executor.execute()` 里 `return this.executeXxx(stmt)`
   的同步前导段若抛错（arity/校验），异常成为**同步抛出** ——
   `await expect(db.query(...)).rejects...` 的断言不生效、`.catch()` 永不执行。
   现统一包一层 try/catch，保证任何错误都是 rejected promise。

2. **缺列的行形状不一致**：validateRow 此前"值为 undefined 就不落键"，
   于是 `INSERT INTO t (id,g) VALUES ('9','z')` 的行里没有 n 键 →
   `SELECT id,g,n FROM t` 抛 COLUMN_NOT_FOUND: n，而 `SELECT * FROM t` 正常。
   现在缺列且无 default → 显式补 null（SQL 语义），行始终含全部 schema 列；
   ALTER ADD 同步在已有行上物化 null，使"内存视图"与"重启后视图"一致。

验证：全量 83 套件 / 1589 测试通过（含 Aria 5 万行索引竞态、KVStore 持久化）；
typecheck(src+tests) 与 lint 零错误。

2026-09-15 00:00:08 +08:00

e2e

test(P0): v0.8.0 验证基座与工程门禁根治

2026-09-14 21:03:06 +08:00

engine

fix(A22/A23/A25/A26/A27/A29/A30/A36): 查询层 8 项缺陷根治 + 单一语义收敛

2026-09-15 00:00:08 +08:00

helpers

test(P0): v0.8.0 验证基座与工程门禁根治

2026-09-14 21:03:06 +08:00

hybrid

fix(A8 + LSM 读自洽): 行所有权根治 + 读取路径不再依赖 prefetch