跳到主要内容

SQL 手册

本文档说明 TDengine TSDB SQL 支持的语法规则、主要查询功能、支持的 SQL 查询函数，以及常用技巧等内容。阅读本文档需要读者具有基本的 SQL 语言的基础。TDengine TSDB 3.0 版本相比 2.x 版本做了大量改进和优化，特别是查询引擎进行了彻底的重构，因此 SQL 语法相比 2.x 版本有很多变更。详细的变更内容请见 3.0 版本语法变更 章节

TDengine TSDB SQL 是用户对 TDengine TSDB 进行数据写入和查询的主要工具。TDengine TSDB SQL 提供标准的 SQL 语法，并针对时序数据和业务的特点优化和新增了许多语法和功能。TDengine TSDB SQL 语句的最大长度为 1M。TDengine TSDB SQL 不支持关键字的缩写，例如 DELETE 不能缩写为 DEL。

本章节 SQL 语法遵循如下约定：

  • 用大写字母表示关键字，但 SQL 本身并不区分关键字和标识符的大小写
  • 用小写字母表示需要用户输入的内容
  • [ ] 表示内容为可选项，但不能输入 [] 本身
  • | 表示多选一，选择其中一个即可，但不能输入 | 本身
  • … 表示前面的项可重复多个

为更好地说明 SQL 语法的规则及其特点，本文假设存在一个数据集。以智能电表（meters）为例，假设每个智能电表采集电流、电压、相位三个量。其建模如下：

taos> DESCRIBE meters;
             Field              |        Type        |   Length    |    Note    |
=================================================================================
 ts                             | TIMESTAMP          |           8 |            |
 current                        | FLOAT              |           4 |            |
 voltage                        | INT                |           4 |            |
 phase                          | FLOAT              |           4 |            |
 location                       | BINARY             |          64 | TAG        |
 groupid                        | INT                |           4 | TAG        |

数据集包含 4 个智能电表的数据，按照 TDengine TSDB 的建模规则，对应 4 个子表，其名称分别是 d1001、d1002、d1003、d1004。

📄️ 数据挂载

自 3.3.7.0 版本起，TDengine TSDB 企业版提供数据挂载功能。该功能支持用户在宿主集群中，通过 SQL 命令将源集群（包括飞行器、车载设备、边缘设备、同机房其他集群、跨数据中心集群、历史备份数据等）挂载到宿主集群，使宿主集群能够直接识别并访问源集群的数据库、表及数据。挂载后无需数据迁移，即可在宿主集群内直接查询挂载的源集群数据，让集群间的数据访问更加便捷高效。为防止源集群的数据被篡改，当前仅支持只读挂载模式。

SOC 2 Certified
ISO 27001 Certified
ISO 27017 Certified
TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。
产品
TDengine TSDB
TDengine IDMP
TDengine Cloud
学习
TSDB 文档
IDMP 文档
博客
资源
公司
关于我们
技术支持
新闻动态
安全性
联系我们
招贤纳士
服务条款
隐私
场景
物联网
工业互联网
车联网
IT 运维
电力能源
金融
TDengine Database
加小 T 为好友
即可加入物联网大数据技术前沿群
点击填写表单
获得解决方案专家帮助
© 2017-2025 涛思数据
京公网安备 11010502047618号
新版时序数据库 TDengine Database v3.0