40 lines
2.5 KiB
Markdown
40 lines
2.5 KiB
Markdown
---
|
||
title: TDengine SQL
|
||
description: 'TDengine SQL 支持的语法规则、主要查询功能、支持的 SQL 查询函数，以及常用技巧等内容'
|
||
---
|
||
|
||
本文档说明 TDengine SQL 支持的语法规则、主要查询功能、支持的 SQL 查询函数，以及常用技巧等内容。阅读本文档需要读者具有基本的 SQL 语言的基础。TDengine 3.0 版本相比 2.x 版本做了大量改进和优化，特别是查询引擎进行了彻底的重构，因此 SQL 语法相比 2.x 版本有很多变更。详细的变更内容请见 [3.0 版本语法变更](/taos-sql/changes) 章节
|
||
|
||
TDengine SQL 是用户对 TDengine 进行数据写入和查询的主要工具。TDengine SQL 提供标准的 SQL 语法，并针对时序数据和业务的特点优化和新增了许多语法和功能。TDengine SQL 语句的最大长度为 1M。TDengine 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 的建模规则，对应 4 个子表，其名称分别是 d1001, d1002, d1003, d1004。
|
||
|
||
```mdx-code-block
|
||
import DocCardList from '@theme/DocCardList';
|
||
import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
|
||
|
||
<DocCardList items={useCurrentSidebarCategory().items}/>
|
||
```
|