概述
更新时间：2026-07-24
本目录介绍用户通过 /api/v3/query_sql 与 Flight SQL gRPC 提交查询时可用的 SQL 语言能力，包括语言边界、数据类型、操作符、语句与全部公开函数的签名、参数和查询示例。
示例约定
本参考的示例沿用命令行会话的展示格式：开头的 > 是提示符，其下是查询返回的结果表。结果列名里的 Utf8(...)、Int64(...)、Float64(...) 等，是该列表达式的内部类型标注。这些标注仅用于展示（未用 AS 起别名时，列名即表达式本身），不影响查询的写法。列类型的完整映射见 数据类型与字面量。
语言边界
- 方言：TSDB SQL 查询方言；支持范围与全部公开函数以本目录为准。
- 查询专用：只接受查询语句。DDL（
CREATE等）、DML（INSERT/COPY）、SET类语句一律不支持；库表管理走 HTTP API。 - 不支持 InfluxQL：查询入口只有 SQL，没有 InfluxQL 端点或方言。
- schema 探查：
SHOW TABLES与information_schema视图可用；只能看到publicschema 下的业务表，systemschema 的内部表不可查询，也不出现在information_schema视图中（见 EXPLAIN 与 schema 探查）。 - time 列：纳秒精度 timestamp（
Timestamp(Nanosecond, None)），值为 UTC。
文档地图
| 页面 | 内容 |
|---|---|
| 数据类型与字面量 | 表列类型映射、SQL 类型名、字面量 |
| 操作符 | 算术 / 比较 / 逻辑 / 模式匹配 / 位运算 / 时间运算 / 访问 / 转换操作符 |
| SELECT 语句 | SELECT 语句与全部子句（WHERE / GROUP BY / HAVING / WITH / UNION / JOIN / LIMIT） |
| EXPLAIN 与 schema 探查 | EXPLAIN、SHOW TABLES、information_schema 与可见范围 |
| 聚合函数 | 聚合函数（通用 / 统计 / 近似，37 个） |
| Selector 函数 | 时序 selector 聚合（selector_first/last/min/max） |
| 窗口函数 | 窗口函数与 OVER 子句（8 个） |
| 时间日期函数 | 时间日期函数（内置 16 个 + 时序扩展：gap filling、date_bin_wallclock、tz、to_timestamp） |
| 数学函数 | 数学函数（38 个） |
| 条件函数 | 条件与空值处理函数（6 个） |
| 字符串函数 | 字符串函数（32 个） |
| 正则表达式函数 | 正则表达式函数（4 个） |
| 数组函数 | 数组函数（39 个） |
| 结构体与 Map 函数 | 结构体与 Map 函数（7 个） |
| 哈希函数 | 哈希函数（6 个） |
| 类型转换与杂项函数 | 类型转换与杂项函数（4 个） |
明确不支持与已知限制
- InfluxQL：不提供 InfluxQL 端点，也不支持 InfluxQL 方言与其函数（如
top/bottom/moving_average）。 - cache 查询函数：
last_cache()/distinct_cache()table function 未实现。 - DDL / DML / SET：见上文语言边界。
评价此篇文章