官方查询手册与版本说明
编写查询时，先选择与数据库版本对应的官方手册，再按本系统的只读查询规则配置。下方链接均可点击跳转；Redis 使用命令，ES 原生模式使用 JSON DSL，二者不属于 SQL。
TDengine 提供对应版本的官方中文手册；本页其余入口以官方英文资料为准，可配合浏览器翻译阅读。ES 的常用写法另见本站中文Calcite SQL 与原生 DSL 详解。
官方参考入口
| 数据源或查询模式 | 本手册对应版本 | 官方参考链接 | 阅读说明 |
|---|---|---|---|
| TDengine SQL | 3.3.8 | SQL 手册（中文） · 数据查询 · 内置函数 | 保留 URL 中的 3.3.8，不要切换成其他版本后直接套用新语法 |
| MySQL SQL | 8.0 系列 | MySQL 8.0 Reference Manual · SELECT · 函数与运算符 | 当前按 MySQL 8.0 整理；仅知道“MySQL 8”时，仍需核对实际分支与补丁版本 |
| Redis 命令 | 6.x | 官方命令索引 · GET · ZRANGE | 官网是持续更新入口，不是 Redis 6.x 冻结手册；需检查命令及参数的版本历史 |
| ES 原生 DSL | Elasticsearch 7.17.6 | 7.17 Query DSL · 7.17.6 发布说明 | 查询手册按 7.17 系列提供，不是只描述 7.17.6 的独立语法快照 |
| ES Calcite SQL | Calcite 1.39.0 + ES 7.17.6 | Calcite SQL 参考 · Elasticsearch 适配器 | SQL 由 Calcite 解析和转换，不能直接套用 MySQL 或 Elasticsearch SQL 的全部语法 |
Redis 官网访问不便时，可查看同一官方项目的 GET 文档源文件、ZRANGE 文档源文件和命令版本元数据。这些资料同样会更新，不能忽略版本历史。
如何核对版本
TDengine 3.3.8
打开链接后，确认文档版本选择器显示 v3.3.8。普通 SELECT、时序窗口、超级表和日期函数的语法，应以这个版本的中文手册为准。
数据库支持的时序扩展语法不一定全部通过报表查询校验；遇到不支持的语法，先在“查询数据”中验证并联系维护人员，不把新版本示例直接作为当前功能承诺。
MySQL 8
本页链接固定到 /8.0/en/。8.0 手册可能包含较新补丁版本的功能，使用新增函数或语法时查看页面中的版本注记。若实际服务器是其他 8.x 分支，应在官方版本选择器中切换后再核对，不能只凭驱动名称判断数据库版本。
Redis 6.x
查看命令页的 Available since / since 和 History：命令本身存在于 Redis 6.x，不代表它的所有选项都可用。
例如 ZRANGE 的 REV、BYSCORE、BYLEX、LIMIT 选项从 6.2.0 才加入，不能直接用于 6.0。该变化可在官方命令元数据中核对。
本报表系统还限制命令形态：当前 ZRANGE 使用 ZRANGE key start stop，不开放上述扩展选项或 WITHSCORES。需要按分数查询时，使用已开放的 ZRANGEBYSCORE key min max LIMIT offset count，且必须带数量限制。
Elasticsearch 7.17.6 与 Calcite 1.39.0
ES 服务端版本与 Calcite 版本是两个独立维度。本项目源码声明 calcite-core、calcite-elasticsearch 均为 1.39.0；这不是对某台在线服务实际加载版本的检测结果。
Calcite 官网的 SQL 总表随项目更新。需要追溯 1.39.0 时，使用 Apache 官方仓库中固定标签的资料：
该版本的适配器说明列出的 ES 范围为 6.x 至 7.15.2，没有覆盖本环境的 7.17.6。这不等于已有查询必定失败，但不能据此承诺完整兼容。维护人员升级任一侧后，应重点核对已有的筛选、分组、排序和日期查询。
本系统的使用范围
官方手册说明数据库或查询引擎的能力，本系统额外限制可执行的查询、参数和资源规模。
| 类型 | 在本系统中使用时注意 |
|---|---|
| SQL | 只提交一条受支持的只读查询；不要带结尾分号、SQL 注释、写操作或管理命令；函数须同时满足系统校验和实际引擎支持 |
| ES Calcite SQL | 使用 es.索引名、_MAP['字段'] 等当前配置下的写法；SQL 总语法表不等于 ES 适配器的完整执行能力 |
| ES 原生 DSL | 只填写查询 JSON，不粘贴 GET /索引/_search、curl 命令或连接信息；仅开放受控的查询和聚合子集 |
| Redis | 只执行已开放的单条只读命令；不开放扫描、写入、事务、脚本或任意命令执行 |
| 动态参数 | :name、${name} 和 SERVER_DATE 是本系统模板规则，不能当作所有数据库客户端通用的参数语法 |
推荐操作顺序为：查阅对应版本 → 使用最小查询 → 添加实际条件 → 主后台调试成功 → 生成密文 → GoView 配置。具体参数规则见查询模板与动态参数。
资料核对日期：2026年9月18日。版本依据为本手册指定环境和当前源码声明，示例仍需结合实际索引映射验证。