TDengine 最大亮点超级表

TDengine （老段）

已于 2025-03-01 10:42:03 修改

阅读量1.1k

点赞数 40

分类专栏： TDengine SQL 手册文章标签： tdengine 数据库 java 大数据时序数据库物联网 iot

于 2025-03-01 10:38:31 首次发布

本文链接：https://blog.csdn.net/ticktick999/article/details/145943567

版权

TDengine SQL 手册专栏收录该内容

25 篇文章

订阅专栏

超级表

TDengine 数据库根据时序数据库采集设备数据特点，提出了超级表及子表概念。超级表完美实现了一类设备一超级表，一个设备一张子表数据模型，模型简单易用、性能好、压缩率高。

超级表可理解为一个模板，超级表上不存储实际数据，所有数据存储在子表中。
超级表的标签（TAG）是用于记录子表属性的，可形象理解为在每台设备上粘上的标签，标签上写有字，那个字可理解为标签值，标签是红色的还是黄色的可理解为标签名，所以标签是来描述子表属性的。
一个数据库中没有限制创建超级表的数量，但超级表不宜过多，要尽可能把今后频繁在一起查询使用的数据放到一个超级表中，在一张超级表中进行过滤、分组查询等性能会非常高，分到不同超级表中便需要使用到关联查询(join) , 在超级表之间与超级表内部查询的性能会差很多。
超级表中标签列多少对写入性能无太大影响，但普通列多少对写入性能有一定影响，普通列在 2000 列以内，都能得到比较好的写入性能。

下面详细介绍下超级表的创建及管理 SQL 语句：

创建超级表

CREATE STABLE [IF NOT EXISTS] stb_name (create_definition [, create_definition] ...) TAGS (create_definition [, create_definition] ...) [table_options]
 
create_definition:
    col_name column_definition
 
column_definition:
    type_name [PRIMARY KEY] [ENCODE 'encode_type'] [COMPRESS 'compress_type'] [LEVEL 'level_type']

table_options:
    table_option ...

table_option: {
    COMMENT 'string_value'
  | SMA(col_name [, col_name] ...)  
}

使用说明

超级表中列的最大个数为 4096，需要注意，这里的 4096 是包含 TAG 列在内的，最小个数为 3，包含一个时间戳主键、一个 TAG 列和一个数据列。
除时间戳主键列之外，还可以通过 PRIMARY KEY 关键字指定第二列为额外的主键列，该列与时间戳列共同组成复合主键。当设置了复合主键时，两条记录的时间戳列与 PRIMARY KEY 列都相同，才会被认为是重复记录，数据库只保留最新的一条；否则视为两条记录，全部保留。注意：被指定为主键列的第二列必须为整型或字符串类型（varchar）。
TAGS语法指定超级表的标签列，标签列需要遵循以下约定：
- TAGS 中的 TIMESTAMP 列写入数据时需要提供给定值，而暂不支持四则运算，例如 NOW + 10s 这类表达式。
- TAGS 列名不能与其他列名相同。
- TAGS 列名不能为预留关键字。
- TAGS 最多允许 128 个，至少 1 个，总长度不超过 16 KB。
关于 ENCODE 和 COMPRESS 的使用，请参考按列压缩
关于 table_option 中的参数说明，请参考建表 SQL 说明

查看超级表

显示当前数据库下的所有超级表信息

SHOW STABLES [LIKE tb_name_wildcard];

查看数据库内全部超级表。

显示一个超级表的创建语句

SHOW CREATE STABLE stb_name;

常用于数据库迁移。对一个已经存在的超级表，返回其创建语句；在另一个集群中执行该语句，就能得到一个结构完全相同的超级表。

获取超级表的结构信息

DESCRIBE [db_name.]stb_name;

获取超级表中所有子表的标签信息

SHOW TABLE TAGS FROM table_name [FROM db_name];
SHOW TABLE TAGS FROM [db_name.]table_name;

taos> SHOW TABLE TAGS FROM st1;
             tbname             |     id      |         loc          |
======================================================================
 st1s1                          |           1 | beijing              |
 st1s2                          |           2 | shanghai             |
 st1s3                          |           3 | guangzhou            |
Query OK, 3 rows in database (0.004455s)

返回结果集的第一列为子表名，后续列为标签列。

如果已经知道标签列的名称，可以使用下面的语句来获取指定标签列的值。

taos> SELECT DISTINCT TBNAME, id FROM st1;
             tbname             |     id      |
===============================================
 st1s1                          |           1 |
 st1s2                          |           2 |
 st1s3                          |           3 |
Query OK, 3 rows in database (0.002891s)

需要注意，SELECT 语句中的 DISTINCT 和 TBNAME 都是必不可少的，TDengine 会根据它们对语句进行优化，使之在没有数据或数据非常多的情况下都可以正确并快速的返回标签值。

获取某个子表的标签信息

taos> SHOW TAGS FROM st1s1;
   table_name    |     db_name     |   stable_name   |    tag_name     |    tag_type     |    tag_value    |
============================================================================================================
 st1s1           | test            | st1             | id              | INT             | 1               |
 st1s1           | test            | st1             | loc             | VARCHAR(20)     | beijing         |
Query OK, 2 rows in database (0.003684s)

同样的，也可以用 SELECT 语句来查询指定标签列的值。

taos> SELECT DISTINCT TBNAME, id, loc FROM st1s1;
     tbname      |     id      |       loc       |
==================================================
 st1s1           |           1 | beijing         |
Query OK, 1 rows in database (0.001884s)

删除超级表

DROP STABLE [IF EXISTS] [db_name.]stb_name

删除 STable 会自动删除通过 STable 创建的子表以及子表中的所有数据。

注意：删除超级表并不会立即释放该表所占用的磁盘空间，而是把该表的数据标记为已删除，在查询时这些数据将不会再出现，但释放磁盘空间会延迟到系统自动或用户手动进行数据重整时。

修改超级表

ALTER STABLE [db_name.]tb_name alter_table_clause
 
alter_table_clause: {
    alter_table_options
  | ADD COLUMN col_name column_type
  | DROP COLUMN col_name
  | MODIFY COLUMN col_name column_type
  | ADD TAG tag_name tag_type
  | DROP TAG tag_name
  | MODIFY TAG tag_name tag_type
  | RENAME TAG old_tag_name new_tag_name
}
 
alter_table_options:
    alter_table_option ...
 
alter_table_option: {
    COMMENT 'string_value'
}

使用说明

修改超级表的结构会对其下的所有子表生效。无法针对某个特定子表修改表结构。标签结构的修改需要对超级表下发，TDengine 会自动作用于此超级表的所有子表。

ADD COLUMN：添加列。
DROP COLUMN：删除列。
MODIFY COLUMN：修改列的宽度，数据列的类型必须是 nchar 和 binary，使用此指令可以修改其宽度，只能改大，不能改小。
ADD TAG：给超级表添加一个标签。
DROP TAG：删除超级表的一个标签。从超级表删除某个标签后，该超级表下的所有子表也会自动删除该标签。
MODIFY TAG：修改超级表的一个标签的列宽度。标签的类型只能是 nchar 和 binary，使用此指令可以修改其宽度，只能改大，不能改小。
RENAME TAG：修改超级表的一个标签的名称。从超级表修改某个标签名后，该超级表下的所有子表也会自动更新该标签名。
与普通表一样，超级表的主键列不允许被修改，也不允许通过 ADD/DROP COLUMN 来添加或删除主键列。

增加列

ALTER STABLE stb_name ADD COLUMN col_name column_type;

删除列

ALTER STABLE stb_name DROP COLUMN col_name;

修改列宽

ALTER STABLE stb_name MODIFY COLUMN col_name data_type(length);

如果数据列的类型是可变长格式（BINARY 或 NCHAR），那么可以使用此指令修改其宽度（只能改大，不能改小）。

添加标签

ALTER STABLE stb_name ADD TAG tag_name tag_type;

为 STable 增加一个新的标签，并指定新标签的类型。标签总数不能超过 128 个，总长度不超过 16KB 。

删除标签

ALTER STABLE stb_name DROP TAG tag_name;

删除超级表的一个标签，从超级表删除某个标签后，该超级表下的所有子表也会自动删除该标签。

修改标签名

ALTER STABLE stb_name RENAME TAG old_tag_name new_tag_name;

修改超级表的标签名，从超级表修改某个标签名后，该超级表下的所有子表也会自动更新该标签名。

修改标签列宽度

ALTER STABLE stb_name MODIFY TAG tag_name data_type(length);

如果标签的类型是可变长格式（BINARY 或 NCHAR），那么可以使用此指令修改其宽度（只能改大，不能改小）。（2.1.3.0 版本新增）

超级表查询

使用 SELECT 语句可以完成在超级表上的投影及聚合两类查询，在 WHERE 语句中可以对标签及列进行筛选及过滤。

如果在超级表查询语句中不加 ORDER BY, 返回顺序是先返回一个子表的所有数据，然后再返回下个子表的所有数据，所以返回的数据是无序的。如果增加了 ORDER BY 语句，会严格按 ORDER BY 语句指定的顺序返回的。

:::note
除了更新标签的值的操作是针对子表进行，其他所有的标签操作（添加标签、删除标签等）均只能作用于 STable，不能对单个子表操作。对 STable 添加标签以后，依托于该 STable 建立的所有表将自动增加了一个标签，所有新增标签的默认值都是 NULL。

:::

访问官网

更多内容欢迎访问 TDengine 官网