在开始使用表管理功能前，推荐您先了解以下相关预备知识，以便更好地理解和应用表管理功能：
用于在当前数据库中创建表，也可以对任何指定数据库创建表，格式为“数据库名.表名”。
语法：
createTableStatement : CREATE TABLE (IF NOT EXISTS)? qualifiedName '(' (columnDefinition (',' columnDefinition)*)? ')' charsetDesc? comment? (WITH properties)? ; charsetDesc : DEFAULT? (CHAR SET | CHARSET | CHARACTER SET) EQ? identifierOrString ; columnDefinition : identifier columnCategory=(TAG | ATTRIBUTE | TIME) charsetName? comment? | identifier type (columnCategory=(TAG | ATTRIBUTE | TIME | FIELD))? charsetName? comment? ; charsetName : CHAR SET identifier | CHARSET identifier | CHARACTER SET identifier ; comment : COMMENT string ;
说明：
enable_auto_create_schema选项，或通过 session 接口自动创建或修改表的语句来添加。FIELD。当列的类别为TAG或ATTRIBUTE时，数据类型需为STRING（可省略）。default。大小写不敏感，创建成功后，统一显示为小写
名称可包含特殊字符，如 ~!"%` 等
包含特殊字符或中文字符的表名创建时必须用双引号 "" 括起来。
当为表命名时，最外层的双引号（""）不会在实际创建的表名中出现。
-- SQL 中 "a""b" --> a"b """""" --> "" -- API 中 "a""b" --> "a""b"
.。示例:
CREATE TABLE table1 ( time TIMESTAMP TIME, region STRING TAG, plant_id STRING TAG, device_id STRING TAG, model_id STRING ATTRIBUTE, maintenance STRING ATTRIBUTE COMMENT 'maintenance', temperature FLOAT FIELD COMMENT 'temperature', humidity FLOAT FIELD COMMENT 'humidity', status Boolean FIELD COMMENT 'status', arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000);
注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。
用于查看该数据库中或指定数据库中的所有表和表库的属性信息。
语法：
SHOW TABLES (DETAILS)? ((FROM | IN) database_name)?
说明：
FROM或IN子句时，系统将展示指定数据库内的所有表。FROM或IN子句，系统将展示当前选定数据库中的所有表。如果用户未使用（use）某个数据库空间，系统将报错。DETAILS），系统将展示表的当前状态，包括：USING：表示表处于正常可用状态。PRE_CREATE：表示表正在创建中或创建失败，此时表不可用。PRE_DELETE：表示表正在删除中或删除失败，此类表将永久不可用。示例:
show tables details from database1;
+---------------+-----------+------+-------+ | TableName| TTL(ms)|Status|Comment| +---------------+-----------+------+-------+ | table1|31536000000| USING| table1| +---------------+-----------+------+-------+
用于查看表的列名、数据类型、类别、状态。
语法：
(DESC | DESCRIBE) <TABLE_NAME> (DETAILS)?
说明：
DETAILS选项，系统将展示列的详细状态信息，包括：USING：表示列目前处于正常使用状态。PRE_DELETE：表示列正在被删除或删除操作失败，该列将永久无法使用。示例:
desc table1 details;
+------------+---------+---------+------+------------+ | ColumnName| DataType| Category|Status| Comment| +------------+---------+---------+------+------------+ | time|TIMESTAMP| TIME| USING| null| | region| STRING| TAG| USING| null| | plant_id| STRING| TAG| USING| null| | device_id| STRING| TAG| USING| null| | model_id| STRING|ATTRIBUTE| USING| null| | maintenance| STRING|ATTRIBUTE| USING| maintenance| | temperature| FLOAT| FIELD| USING| temperature| | humidity| FLOAT| FIELD| USING| humidity| | status| BOOLEAN| FIELD| USING| status| |arrival_time|TIMESTAMP| FIELD| USING|arrival_time| +------------+---------+---------+------+------------+
用于获取表模型下表或视图的完整定义语句。该功能会自动补全创建时省略的所有默认值，因此结果集中所展示的语句可能与原始创建语句不同。
V2.0.5 起支持该功能
语法：
SHOW CREATE TABLE <TABLE_NAME>
说明：
示例:
show create table table1;
+------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Table| Create Table| +------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ |table1|CREATE TABLE "table1" ("region" STRING TAG,"plant_id" STRING TAG,"device_id" STRING TAG,"model_id" STRING ATTRIBUTE,"maintenance" STRING ATTRIBUTE,"temperature" FLOAT FIELD,"humidity" FLOAT FIELD,"status" BOOLEAN FIELD,"arrival_time" TIMESTAMP FIELD) WITH (ttl=31536000000)| +------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
用于修改表，包括添加列、删除列、修改列类型（V2.0.8.2）以及设置表的属性。
语法：
#addColumn; ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? column=columnDefinition COMMENT 'column_comment'; #dropColumn; ALTER TABLE (IF EXISTS)? tableName=qualifiedName DROP COLUMN (IF EXISTS)? column=identifier; #setTableProperties; // set TTL can use this; | ALTER TABLE (IF EXISTS)? tableName=qualifiedName SET PROPERTIES propertyAssignments; | COMMENT ON TABLE tableName=qualifiedName IS 'table_comment'; | COMMENT ON COLUMN tableName.column IS 'column_comment'; #changeColumndatatype; | ALTER TABLE (IF EXISTS)? tableName=qualifiedName ALTER COLUMN (IF EXISTS)? column=identifier SET DATA TYPE new_type=type;
说明：
SET PROPERTIES操作目前仅支持对表的 TTL 属性进行配置。| 原始类型 | 可变更为类型 |
|---|---|
| INT32 | INT64, FLOAT, DOUBLE, TIMESTAMP, STRING, TEXT |
| INT64 | TIMESTAMP, DOUBLE, STRING, TEXT |
| FLOAT | DOUBLE, STRING, TEXT |
| DOUBLE | STRING, TEXT |
| BOOLEAN | STRING, TEXT |
| TEXT | BLOB, STRING |
| STRING | TEXT, BLOB |
| BLOB | STRING, TEXT |
| DATE | STRING, TEXT |
| TIMESTAMP | INT64, DOUBLE, STRING, TEXT |
示例:
表 table1 增加 tag 列 a
ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a';
表 table1 增加 field 列 b
ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b';
修改表 table1 的 TTL
ALTER TABLE table1 set properties TTL=3600;
表 table1 增加注释
COMMENT ON TABLE table1 IS 'table1';
表 table1 的 a 列去掉注释
COMMENT ON COLUMN table1.a IS null;
修改表 table1 的 b 列的数据类型
ALTER TABLE table1 ALTER COLUMN IF EXISTS b SET DATA TYPE DOUBLE;
用于删除表。
语法：
DROP TABLE (IF EXISTS)? <TABLE_NAME>
示例:
DROP TABLE table1;
表模型下测点数量等于所有表的测点数之和，目前单表测点数可通过公式：单表测点数 = device 数量 × field 列的数量 计算得出，后续会支持通过 SQL 语句直接查询表模型下测点数，敬请期待。
以示例数据 中的表 table1 为例。
该示例组织架构共包含三个 tag 列（region 为区域，plant_id 为工厂，device_id 为机器）和四个 field 列（temperature 为温度，humidity 为湿度，status 为状态，arrival_time 为到达时间）。
device 的唯一标识由全部 tag 列组合而成，只要 region（区域）+ plant_id（工厂）+ device_id（机器）的组合不重复，就代表一个独立设备。
示例数据一共定义了 2 个区域，分别为：北京、上海。其中
综上，整个表一共存在 6 组唯一 tag 组合，对应 6 个独立设备。
单表测点数完整计算示例：
count devices from table1;
+--------------+ |count(devices)| +--------------+ | 6| +--------------+