tsl-devkit/docs/tsl/syntax/29_ts_sql_advanced.md

# TS-SQL Advanced

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

手册位置：第 29 篇，共 32 篇。上一篇：[28_ts_sql_core.md](28_ts_sql_core.md)。下一篇：[30_runtime_services_and_global_cache.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`

最小内存表联接：

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

```tsl
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`

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

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

```tsl
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` 在排序后仍指向原始位置

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

```tsl
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` 可以和对应的极值聚集一起使用：

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

```tsl
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`
- 更深的时间序列聚集与缓存选项

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

## 最小可编译示例

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

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

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

## 常见误写

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

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

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

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

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

```text
Value := ThisGroup;
```

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

## 跳转指引

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