使用 CREATE TABLE columns 直接定义列的方式进行建表。

定义列建表

CREATE TABLE [IF NOT EXISTS] --[1]
[<database_name>.]<table_name> --[2]
(<column_name1> <DATATYPE1> [NOT NULL] [COMMENT "<column_text>"], --[3]
<column_name2> <DATATYPE2> [NOT NULL] [COMMENT "<column_text>"],
<column_name3> <DATATYPE3> [NOT NULL] [COMMENT "<column_text>"],
...) [COMMENT "<table_text>"] --[4]
[STORED AS TIMELYRE/TIMELYRE2] --[5]
[TBLPROPERTIES|SERDEPROPERTIES ("<property_name>"="<property_value>", ...)];--[6]
复制

<database_name>：将表建在指定的数据库中。

<table_name>：表名称。

<column_name>：列名称，长度不超过 128。

<DATATYPE>：数据类型。

<column_text>：列注释信息。

<table_text>：表注释信息。

<property_name>：表属性名称，包括。

<property_value>：表属性值。

可选项 [1]，如果 <table_name> 指定的表已经存在，会报错，加上 IF NOT EXISTS 选项在建表前检测是否已存在同名表。

可选项 [2]，支持指明表所在的数据库名称。

可选项 [3]，支持非空 [NOT NULL] 约束。

可选项 [4]，用 [COMMENT] 为表或列加注释，注意注释要放在引号中。

可选项 [5]，支持使用 STORED AS 指定表的存储格式，TimeLyre中支持的存储格式请参考表格存储格式。

可选项 [6]，支持使用 TBLPROPERTIES 或 SERDEPROPERTIES 对表的属性进行设定，TimeLyre表中支持的表参数请参考timelyre表格式。

局部临时表 TEMPORARY TABLE 仅在当前 session 可见，当前 session 结束后会被删除。如果一张临时表和一张永久表重名，在临时表所在的 session 中该表名将指代临时表，同名永久表将无法在 session 中访问。临时表不支持分区。

全局临时表 GLOBAL TEMPORARY TABLE 在当前 session1 创建后，其他 session 可见，并可以使用，当 session1 结束后，会等待其他使用到该表的 session 结束使用后删除。全局临时表无法与永久表重名，且其他 session 无法创建同名。全局临时表不支持分区。

使用 CREATE TEMPORARY TABLE 命令创建局部临时表。

使用 CREATE GLOBAL TEMPORARY TABLE 命令创建全局临时表。

<database_name>：将表建在指定的数据库中。

<table_name>：表名称。

<column_name>：列名称。

<DATATYPE>：数据类型。

<column_text>：列注释信息。

<table_text>：表注释信息。

可选项 [1]，选择创建局部临时表 TEMPORARY TABLE，或是全局临时表 GLOBAL TEMPORARY TABLE。

可选项 [2]，如果 <table_name> 指定的表已经存在，会报错，加上 IF NOT EXISTS 选项在建表前检测是否已存在同名表。

可选项 [3]，指明表所在的数据库名称。

可选项 [4]，支持 [NOT NULL] 约束列数据不能为空 NULL。

可选项 [5]，用 [COMMENT] 为表或列加注释，注意注释要放在引号中。

可选项 [6]，支持使用 STORED AS 指定表的存储格式，TimeLyre 中支持的存储格式请参考表格存储格式。

可选项 [7]，支持使用 TBLPROPERTIES 或 SERDEPROPERTIES 对临时表的属性进行设定。

数据的导入与导出：可以使用外表将外部数据源中的数据导入到数据库中或者将数据库中的数据导出到外部数据文件中，比如可以将 Excel 或 CSV 格式的数据文件导入到 TimeLyre 数据库中。

数据库数据的备份和恢复：可以将数据库中的数据备份到外部数据文件中，然后再将其恢复到数据库中。

数据的转换和集成：可以使用外表将多个数据源中的数据进行集成，并通过 SQL 查询来获取需要的数据。

<database_name>：将表建在指定的数据库中。

<table_name>：表名称。

<column_name>：列名称。

<DATATYPE>：数据类型。

<column_text>：列注释信息。

<table_text>：表注释信息。

可选项 [1]，添加 TEMPORARY 关键字创建临时表

可选项 [2]，如果 <table_name> 指定的表已经存在，会报错，加上 IF NOT EXISTS 选项在建表前检测是否已存在同名表。

可选项 [3]，指明表所在的数据库名称。

可选项 [4]，支持非空 [NOT NULL] 约束。

可选项 [5]，用 [COMMENT] 为表或列加注释，注意注释要放在引号中。

可选项 [6]，支持使用 STORED AS 指定外表表的存储格式。TimeLyre 中支持的存储格式请参考表格存储格式。

可选项 [7]，支持使用 TBLPROPERTIES 或 SERDEPROPERTIES 对临时表的属性进行设定。

使用 RENAME 关键字修改表名称。

<table_name_old>：表原有名称。

<table_name_new>：表重命名之后的新名字

使用 TBLPROPERTIES 设置整个表的一些属性信息，如表的压缩格式、表的存储位置、表的格式、表的注释等。

使用 SERDEPROPERTIES 用于描述表中数据的序列化和反序列化格式，包括分隔符、数据类型等等，

<table_name>：表名称。

<column_name>：列名称。

<DATATYPE>：数据类型。

<property_name>：表属性名称。

<property_value>：表属性值。

可选项 [1]，使用 TBLPROPERTIES 或 SERDEPROPERTIES 对表的属性进行设定。

使用 ALTER TABLE ADD COLUMNS 增加指定表中的列。

ADD COLUMNS 可以将新的列加入到表中。列的位置不能被定义或更改：

TimeLyre表目前只支持时序主键表进行加列操作

<table_name>：表名称。

<column_name>：列名称。

<text>：注释信息。

<DATATYPE>：数据类型。

可选项 [1]，支持非空 [NOT NULL] 约束。

可选项 [2]，用 [COMMENT] 为新增列加注释，注意注释要放在引号中。

使用 ALTER CHANGE COLUMN 修改表中的列名称，数据类型，注释信息。

该指令仅仅修改表的元数据。

TimeLyre表只支持修改列名称，不支持修改数据类型

<table_name>：表名称。

<col_old_name>：列的原名称

<col_new_name>：列的新名词，可以和 <col_old_name> 相同。

<DATATYPE>：数据类型，必须填写，请填写原有数据类型，TimeLyre表不支持修改数据类型。

<text>：注释信息。

可选项 [1]，缩写时 COLUMN 可省略。

可选项 [2]，用 [COMMENT] 为列加注释，注意注释要放在引号中。

使用 COMMENT ON TABLE 或修改 TBLPROPERTIES 的 'comment' 参数的方式改变表注释信息。

使用 COMMENT ON COLUMN 或 CHANGE [COLUMN] 的方式改变指定表中某一个字段的注释信息。

使用 CHANGE [COLUMN] 语法时，可以同时修改列名称或添加字段长度，具体操作请参考改变列的相关信息。 语法格式

COMMENT ON TABLE 方式

-- 设置表注释
COMMENT ON TABLE [<database_name>.]<table_name> is '<text>';

-- 删除表注释
COMMENT ON TABLE [<database_name>.]<table_name> is '';
复制

修改 TBLPROPERTIES 参数方式

-- 设置表注释
ALTER TABLE [<database_name>.]<table_name> SET TBLPROPERTIES ('COMMENT' = '<text>');--[1]

-- 删除表注释
ALTER TABLE [<database_name>.]<table_name> UNSET TBLPROPERTIES ('comment');
复制

COMMENT ON COLUMN 语法

-- 设置列注释
COMMENT ON COLUMN [<database_name>.]<table_name>.<column_name> is '<text>';

-- 删除列注释
COMMENT ON COLUMN [<database_name>.]<table_name>.<column_name> is '';
复制

CHANGE COLUMN 参数方式

-- 设置列注释
ALTER TABLE [<database_name>.]<table_name> CHANGE [COLUMN] <column_name> <column_name> <DATATYPE> COMMENT '<text>';

-- 删除列注释
ALTER TABLE [<database_name>.]<table_name> CHANGE [COLUMN] <column_name> <column_name> <DATATYPE> COMMENT '';
复制

<database_name>：将表建在指定的数据库中。

<table_name>：表名称。

<column_name>：列名称。

<DATATYPE>：数据类型。

<text>：注释信息。

可选项 [1]，可以指定目标表所处数据库名称。

使用 ALTER TABLE SET LOCATION 设置表的 HDFS 路径。

使用 ALTER TABLE PARTITION SET LOCATION 设置表中某个分区的 HDFS 路径；

TimeLyre 表暂时不支持修改路径功能，因为TimeLyre的数据文件不保存在HDFS上。

修改表位置的用户必须是 <new_location> 的 OWNER，需要具有对应的 HDFS 路径的写入权限。具体查看方式如下：

我们建议只对外表进行修改表路径的操作。

<database_name>：将表建在指定的数据库中。

<table_name>：表名称。

<hdfs_path>：HDFS 目录，可以是相对路径也可以是绝对路径。

<partition_key>：分区键。

<partition_name>：范围分区中的指定某个分区名称。

<value>：分区对应取值。

可选项 [1]，可以指定目标表所处数据库名称。