# TS-SQL

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

手册位置：第 15 篇，共 32 篇。上一篇：[14_resultset_and_filters.md](14_resultset_and_filters.md)。下一篇：[16_debug_and_profiler.md](16_debug_and_profiler.md)。

这一篇不再只是跳转页。它负责把 TS-SQL 放回整个语言阅读主线里：先知道它是什么、最短骨架怎么写、什么时候继续进入 `28` 和 `29` 两篇专题。

## 这一篇解决什么问题

回答“第一次进入 TS-SQL 时，应该先记住哪些固定骨架，怎样区分基础查询和高级查询，以及哪些内容属于语法、哪些已经属于业务层数据访问”。

## 必须记住的规则

- TS-SQL 是 TSL 自带的类 SQL 查询语法，不是金融业务函数库。
- 基础查询当前的稳定骨架是：以 `select` / `sselect` / `vselect` / `mselect` 开始，以 `end` 收尾。
- 在内存二维结果集上，当前稳定字段访问写法是 `["字段名"]`。
- 在一维数组上做 TS-SQL 时，当前应优先使用 `ThisRow` 和 `ThisRowIndex`。
- `select` 返回二维结果，`sselect` 返回一维结果，`vselect` 返回单值，`mselect` 返回 `Matrix`。
- `join`、`ThisGroup`、`RefMaxOf` / `RefMinOf` 这类更深查询，已经进入进阶页，不要和入门骨架混写。
- 访问金融表、时间序列或业务数据源时，语法和业务语义要分开看；本页只讲语言层查询骨架。

## 已验证语法

### 最小查询骨架

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

```tsl
program test;
begin
    T := array(
        ("A": 1, "B": 3),
        ("A": 2, "B": 1)
    );
    R := select * from T end;
end.
```

已验证运行结果：

- `R` 的长度是 `2`
- 两行依次是 `(1,3)`、`(2,1)`
- 说明 TS-SQL 的最短可靠入口就是“准备结果集，然后 `select ... from T end`”

### 四个查询入口怎样分工

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

```tsl
program test;
begin
    T := array(
        ("A": 1, "B": 3),
        ("A": 2, "B": 1),
        ("A": 1, "B": 2)
    );
    S := sselect ["A"] from T end;
    V := vselect sumof(["B"]) from T end;
    M := mselect * from T end;
    C := MCols(M, 1);
end.
```

已验证运行结果：

- `sselect ["A"] from T end` 返回一维数组 `array(1, 2, 1)`
- `vselect sumof(["B"]) from T end` 返回单值 `6`
- `mselect * from T end` 的行数是 `3`、列数是 `2`
- `MCols(M, 1)` 返回列索引 `array("A", "B")`

### 什么时候进入进阶页

当查询开始出现多表字段、联接条件或组内子查询时，就不要继续停留在本页：

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

```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)`
- 说明一旦开始写 `[1].["字段"]`、`join`、`on` 这类结构，就已经进入 [29_ts_sql_advanced.md](29_ts_sql_advanced.md) 的责任范围

## 暂不在本页展开的部分

- `with on`
- `insert` / `update` / `delete`
- 面向 SQL 表或业务表的数据写回
- 时间序列查询选项
- 更深的缓存、对象化接口和写回类

这些内容不是不能写，而是应先去对应专题页或业务文档，不要在这篇入门页提前固化成默认模板。

## 跳转指引

- 如果你其实要先做结果集过滤：去 [14_resultset_and_filters.md](14_resultset_and_filters.md)
- 如果你刚开始写 TS-SQL：先去 [28_ts_sql_core.md](28_ts_sql_core.md)
- 如果你已经需要 `join` / `ThisGroup` / `RefMaxOf`：去 [29_ts_sql_advanced.md](29_ts_sql_advanced.md)
- 如果你其实是在做业务查询任务：去 [../finance/index.md](../finance/index.md)