playbook/docs/tsl/syntax/29_ts_sql_advanced.md

TS-SQL Advanced

文档类型：语法主线 是否可直接用于生成代码：是 是否含已验证可执行示例：是 是否含已验证反例：是 遇到不确定时跳转到：28_ts_sql_core.md、15_ts_sql.md、12_pitfalls.md

手册位置：第 29 篇，共 32 篇。上一篇：28_ts_sql_core.md。下一篇：30_runtime_services_and_global_cache.md。

这一篇只收当前已经实测通过的 TS-SQL 进阶查询能力：多表 join、分组子查询 ThisGroup、排序后的原始行下标 ThisRowIndex，以及 RefMaxOf / RefMinOf 这类“取极值所在行的另一列”的写法。

这一篇解决什么问题

回答“基础 select 已经会写以后，怎样继续处理多表联接、分组后组内再查、以及极值对应行的引用值”。

必须记住的规则

• 多表 join 时，字段访问应写成 [表序号].["字段名"]。
• ThisGroup 不是普通值，而是分组后的子结果集；要通过子 select / vselect 的 from ThisGroup 来访问。
• ThisRowIndex 在 order by 之后仍可返回原始行位置，而不是排序后的序号。
• RefMaxOf(...) 和 RefMinOf(...) 在当前最小例子里可与 MaxOf(...) / MinOf(...) 配合，取极值所在行的另一列值。
• 这一篇当前只提升“高级查询”部分；对象化写回接口和更深的时间序列查询仍然暂缓。

已验证语法

join

最小内存表联接：

代码块身份：已验证可执行示例

program test;
begin
    A := array(
        ("ID": 1, "V1": 10),
        ("ID": 2, "V1": 20)
    );
    B := array(
        ("ID": 1, "V2": 100),
        ("ID": 3, "V2": 300)
    );
    R := select [1].["ID"], [1].["V1"], [2].["V2"]
         from A join B on [1].["ID"] = [2].["ID"]
         end;
end.

已验证运行结果：

• R 的长度是 1
• 唯一一行是 (1,10,100)
• 说明当前解释器接受 from A join B on ...，并接受 [1].["字段"]、[2].["字段"] 这种多表字段访问

ThisGroup

分组后可在组内继续做子查询：

代码块身份：已验证可执行示例

program test;
begin
    T := array(
        ("A": 1, "B": 3, "Name": "x"),
        ("A": 2, "B": 1, "Name": "y"),
        ("A": 1, "B": 2, "Name": "z")
    );
    G := select ["A"], maxb := maxof(["B"]) as "MaxB",
         vselect ["Name"] from ThisGroup where ["B"] = maxb end as "TopName"
         from T
         group by ["A"]
         order by ["A"]
         end;
end.

已验证运行结果：

• G 的长度是 2
• 第一行是 (1,3,"x")
• 第二行是 (2,1,"y")
• 说明 ThisGroup 可以在分组上下文里作为子结果集继续 vselect

ThisRowIndex 在排序后仍指向原始位置

代码块身份：已验证可执行示例

program test;
begin
    T := array(
        ("A": 1, "B": 3),
        ("A": 2, "B": 1),
        ("A": 1, "B": 2)
    );
    R := select ThisRowIndex as "Idx", ["B"]
         from T
         order by ["B"]
         end;
end.

已验证运行结果：

• R 的三行依次是 (1,1)、(2,2)、(0,3)
• 说明 order by ["B"] 之后，ThisRowIndex 仍返回原表中的原始下标

RefMaxOf 与 RefMinOf

当前最小样例里，RefMaxOf / RefMinOf 可以和对应的极值聚集一起使用：

代码块身份：已验证可执行示例

program test;
begin
    A := array((6, 20), (5, 20), (9, 2), (2, 20), (7, 18));
    R1 := select maxof([0]) as "MaxA", refmaxof([1]) as "RefB" from A end;
    R2 := select minof([0]) as "MinA", refminof([1]) as "RefB" from A end;
end.

已验证运行结果：

• R1 只有一行，结果是 (9,2)
• R2 只有一行，结果是 (2,20)
• 说明在这个最小例子里，refmaxof([1]) 取到了 [0] 最大值所在行的 [1]，refminof([1]) 取到了 [0] 最小值所在行的 [1]

暂不在本页展开的部分

• with on
• left join / right join / full join
• RefsOf
• TSQLInsert
• TSQLSetValue
• TSQLBatchInsert
• TSQLEdit / TSQLPost / TSQLFinal
• 更深的时间序列聚集与缓存选项

这些内容要等单独补最小验证后，再进入主线正文。

最小可编译示例

如果你只想先记住最短的高级查询骨架，从这个开始：

代码块身份：已验证可执行示例

R := select [1].["ID"], [2].["V2"]
     from A join B on [1].["ID"] = [2].["ID"]
     end;

常见误写

• 多表联接时继续写成 ["ID"]，没有加表序号。
• 把 ThisGroup 当成普通字段或普通变量。
• 把排序后的 ThisRowIndex 误当成排序序号。
• 在还没验证的情况下，把 with on、写回接口和时间序列缓存写进默认模板。

代码块身份：反例 / 不可照写

R := select ["ID"], ["V1"], ["V2"]
     from A join B on ["ID"] = ["ID"]
     end;

上面这种写法不要当成当前手册的可靠规则。多表查询里，当前只把 [1].["字段"]、[2].["字段"] 这种带表序号的访问方式提升为已验证主干。

代码块身份：反例 / 不可照写

Value := ThisGroup;

不要把 ThisGroup 当成普通值直接使用。当前可靠入口是 select ... from ThisGroup end 或 vselect ... from ThisGroup end。

跳转指引

• 回看 TS-SQL 基础：见 28_ts_sql_core.md
• 回看 TS-SQL 总入口：见 15_ts_sql.md
• 看运行时与全局缓存：见 30_runtime_services_and_global_cache.md