在开始使用表管理功能前，推荐您先了解以下相关预备知识，以便更好地理解和应用表管理功能：
用于在当前数据库中创建表，也可以对任何指定数据库创建表，格式为“数据库名.表名”。
语法：
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); CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( station STRING TAG, temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); -- 自定义时间列:命名为time_test, 位于表的第二列 CREATE TABLE table1 ( region STRING TAG, time_user_defined TIMESTAMP TIME, temperature FLOAT FIELD );
注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。
用于查看该数据库中或指定数据库中的所有表和表库的属性信息。
语法：
SHOW TABLES (DETAILS)? ((FROM | IN) database_name)?
说明：
FROM或IN子句时，系统将展示指定数据库内的所有表。FROM或IN子句，系统将展示当前选定数据库中的所有表。如果用户未使用（use）某个数据库空间，系统将报错。DETAILS），系统将展示表的当前状态，包括：USING：表示表处于正常可用状态。PRE_CREATE：表示表正在创建中或创建失败，此时表不可用。PRE_DELETE：表示表正在删除中或删除失败，此类表将永久不可用。示例:
show tables from database1;
+---------+---------------+ |TableName| TTL(ms)| +---------+---------------+ | table1| 31536000000| +---------+---------------+
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;
+------------+---------+---------+ | ColumnName| DataType| Category| +------------+---------+---------+ | time|TIMESTAMP| TIME| | 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| +------------+---------+---------+
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)| +------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Total line number = 1
用于修改表，包括添加列、删除列以及设置表的属性。
语法：
#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';
说明：
SET PROPERTIES操作目前仅支持对表的 TTL 属性进行配置。示例:
ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a'; ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b'; ALTER TABLE table1 set properties TTL=3600; COMMENT ON TABLE table1 IS 'table1'; COMMENT ON COLUMN table1.a IS null;
用于删除表。
语法：
DROP TABLE (IF EXISTS)? <TABLE_NAME>;
示例:
DROP TABLE table1; DROP TABLE database1.table1;