表

创建表

CREATE TABLE 语句用于创建普通表和以超级表为模板创建子表。

1. CREATE TABLE [IF NOT EXISTS] [db_name.]tb_name (create_definition [, create_definition] ...) [table_options]

3. CREATE TABLE create_subtable_clause

5. CREATE TABLE [IF NOT EXISTS] [db_name.]tb_name (create_definition [, create_definition] ...)
6. [TAGS (create_definition [, create_definition] ...)]
7. [table_options]

9. create_subtable_clause: {
10. create_subtable_clause [create_subtable_clause] ...
11. | [IF NOT EXISTS] [db_name.]tb_name USING [db_name.]stb_name [(tag_name [, tag_name] ...)] TAGS (tag_value [, tag_value] ...)
12. }

14. create_definition:
15. col_name column_type

17. table_options:
18. table_option ...

20. table_option: {
21. COMMENT 'string_value'
22. | WATERMARK duration[,duration]
23. | MAX_DELAY duration[,duration]
24. | ROLLUP(func_name [, func_name] ...)
25. | SMA(col_name [, col_name] ...)
26. | TTL value
27. }

使用说明

表的第一个字段必须是 TIMESTAMP，并且系统自动将其设为主键；
表名最大长度为 192；
表的每行长度不能超过 48KB;（注意：每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置）
子表名只能由字母、数字和下划线组成，且不能以数字开头，不区分大小写
使用数据类型 binary 或 nchar，需指定其最长的字节数，如 binary(20)，表示 20 字节；
为了兼容支持更多形式的表名，TDengine 引入新的转义符 ““，可以让表名与关键词不冲突，同时不受限于上述表名称合法性约束检查。但是同样具有长度限制要求。使用转义字符以后，不再对转义字符中的内容进行大小写统一。例如：aBc和abc` 是不同的表名，但是 abc 和 aBc 是相同的表名。需要注意的是转义字符中的内容必须是可打印字符。

参数说明

COMMENT：表注释。可用于超级表、子表和普通表。
WATERMARK：指定窗口的关闭时间，默认值为 5 秒，最小单位毫秒，范围为 0 到 15 分钟，多个以逗号分隔。只可用于超级表，且只有当数据库使用了 RETENTIONS 参数时，才可以使用此表参数。
MAX_DELAY：用于控制推送计算结果的最大延迟，默认值为 interval 的值(但不能超过最大值)，最小单位毫秒，范围为 1 毫秒到 15 分钟，多个以逗号分隔。注：不建议 MAX_DELAY 设置太小，否则会过于频繁的推送结果，影响存储和查询性能，如无特殊需求，取默认值即可。只可用于超级表，且只有当数据库使用了 RETENTIONS 参数时，才可以使用此表参数。
ROLLUP：Rollup 指定的聚合函数，提供基于多层级的降采样聚合结果。只可用于超级表。只有当数据库使用了 RETENTIONS 参数时，才可以使用此表参数。作用于超级表除 TS 列外的其它所有列，但是只能定义一个聚合函数。聚合函数支持 avg, sum, min, max, last, first。
SMA：Small Materialized Aggregates，提供基于数据块的自定义预计算功能。预计算类型包括 MAX、MIN 和 SUM。可用于超级表/普通表。
TTL：Time to Live，是用户用来指定表的生命周期的参数。如果创建表时指定了这个参数，当该表的存在时间超过 TTL 指定的时间后，TDengine 自动删除该表。这个 TTL 的时间只是一个大概时间，系统不保证到了时间一定会将其删除，而只保证存在这样一个机制且最终一定会删除。TTL 单位是天，默认为 0，表示不限制，到期时间为表创建时间加上 TTL 时间。TTL 与数据库 KEEP 参数没有关联，如果 KEEP 比 TTL 小，在表被删除之前数据也可能已经被删除。

创建子表

1. CREATE TABLE [IF NOT EXISTS] tb_name USING stb_name TAGS (tag_value1, ...);

创建子表并指定标签的值

1. CREATE TABLE [IF NOT EXISTS] tb_name USING stb_name (tag_name1, ...) TAGS (tag_value1, ...);

以指定的超级表为模板，也可以指定一部分 TAGS 列的值来创建数据表（没被指定的 TAGS 列会设为空值）。

批量创建子表

1. CREATE TABLE [IF NOT EXISTS] tb_name1 USING stb_name TAGS (tag_value1, ...) [IF NOT EXISTS] tb_name2 USING stb_name TAGS (tag_value2, ...) ...;

批量建表方式要求数据表必须以超级表为模板。在不超出 SQL 语句长度限制的前提下，单条语句中的建表数量建议控制在 1000 ～ 3000 之间，将会获得比较理想的建表速度。

修改普通表

1. ALTER TABLE [db_name.]tb_name alter_table_clause

3. alter_table_clause: {
4. alter_table_options
5. | ADD COLUMN col_name column_type
6. | DROP COLUMN col_name
7. | MODIFY COLUMN col_name column_type
8. | RENAME COLUMN old_col_name new_col_name
9. }

11. alter_table_options:
12. alter_table_option ...

14. alter_table_option: {
15. TTL value
16. | COMMENT 'string_value'
17. }

使用说明 对普通表可以进行如下修改操作

ADD COLUMN：添加列。
DROP COLUMN：删除列。
MODIFY COLUMN：修改列定义，如果数据列的类型是可变长类型，那么可以使用此指令修改其宽度，只能改大，不能改小。
RENAME COLUMN：修改列名称。

增加列

1. ALTER TABLE tb_name ADD COLUMN field_name data_type;

删除列

1. ALTER TABLE tb_name DROP COLUMN field_name;

修改列宽

1. ALTER TABLE tb_name MODIFY COLUMN field_name data_type(length);

修改列名

1. ALTER TABLE tb_name RENAME COLUMN old_col_name new_col_name

修改子表

1. ALTER TABLE [db_name.]tb_name alter_table_clause

3. alter_table_clause: {
4. alter_table_options
5. | SET TAG tag_name = new_tag_value
6. }

8. alter_table_options:
9. alter_table_option ...

11. alter_table_option: {
12. TTL value
13. | COMMENT 'string_value'
14. }

使用说明

对子表的列和标签的修改，除了更改标签值以外，都要通过超级表才能进行。

修改子表标签值

1. ALTER TABLE tb_name SET TAG tag_name=new_tag_value;

删除表

可以在一条 SQL 语句中删除一个或多个普通表或子表。

1. DROP TABLE [IF EXISTS] [db_name.]tb_name [, [IF EXISTS] [db_name.]tb_name] ...

查看表的信息

显示所有表

如下 SQL 语句可以列出当前数据库中的所有表名。

1. SHOW TABLES [LIKE tb_name_wildchar];

显示表创建语句

1. SHOW CREATE TABLE tb_name;

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

获取表结构信息

1. DESCRIBE [db_name.]tb_name;