fix(sql): skip TSQL paging for aggregates without @group - #885

背景

issue #648 反馈：SQL Server 下 @column 用聚合函数会报错。

复现请求：

{
  "Moment": {
    "@column": "max(date):date"
  }
}

报错：

order by 子句列 id 无效，因为该列没有包含在聚合函数或 group by 子句中

原因

SQL Server / DB2 / Kingbase SQL Server 模式下，OFFSET ... FETCH ... 必须带 ORDER BY，所以 gainOrderString 在 getCount() > 0 时自动补上 ORDER BY "id"：

if (getCount() > 0 && (isSQLServer() || isKingBaseSQLServer() || isDb2())) {
    ...
    order = idKey;  // 没传 @order 时默认用 id
}

但 max(date) 这种不带 GROUP BY 的单聚合永远只返回一行，它没有 id 列可以排序，于是生成非法 SQL：

SELECT max("date") AS "date" FROM "sys"."Moment" ORDER BY "id" OFFSET 0 ROWS FETCH FIRST 10 ROWS ONLY

MySQL / PostgreSQL 走 LIMIT，不强制 ORDER BY，所以一直是好的——这解释了为什么只有 SQL Server 报。

修复

新增 isAggregateWithoutGroup()：@group 为空、@column 只有一项、且该项是 SQL_AGGREGATE_FUNCTION_MAP 里的聚合函数（max/min/avg/count/sum）时返回 true。

两处使用：

1. gainOrderString：这种查询不再补 ORDER BY。
2. gainLimitString：直接返回空字符串——结果本来就只有一行，OFFSET/FETCH 没有意义。

修复后：

SELECT max("date") AS "date" FROM "sys"."Moment"

不受影响的场景

• 普通字段分页：仍保留 ORDER BY "id" OFFSET 0 ROWS FETCH FIRST 10 ROWS ONLY
• 带 @group 的聚合：仍保留 ORDER BY（可以按分组字段排序）
• MySQL / PostgreSQL：LIMIT 分支未改动

测试

新增 AbstractSQLConfigAggregatePagingTest（6 个用例）：

• SQL Server / DB2 / Kingbase SQL Server 的聚合查询断言无 ORDER BY、无 OFFSET
• SQL Server 普通字段分页断言仍带 ORDER BY + OFFSET
• SQL Server 带 @group 的聚合断言仍带 ORDER BY

双通道验证

修复前（git checkout origin/main -- src/main/java/apijson/orm/AbstractSQLConfig.java）：

aggregate paging: SELECT max("date") AS "date" FROM "sys"."Moment" ORDER BY "id" OFFSET 0 ROWS FETCH FIRST 10 ROWS ONLY
[ERROR] AbstractSQLConfigAggregatePagingTest.skipsOrderByForSQLServerAggregate:127
    聚合函数不带 GROUP BY 时不应补 ORDER BY，否则列不在聚合函数内会报错
[ERROR] Tests run: 6, Failures: 4, Errors: 0, Skipped: 0

修复后：

[INFO] Tests run: 6, Failures: 0, Errors: 0, Skipped: 0 -- in apijson.orm.AbstractSQLConfigAggregatePagingTest
[INFO] Tests run: 44, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

全量 mvn test 44 个用例全绿（原有 38 + 新增 6），无回归。

fix #648