CREATE-TABLE-AS-SELECT

CREATE-TABLE-AS-SELECT

Name

CREATE TABLE AS SELECT

Description

该语句通过 Select 语句返回结果创建表结构，同时导入数据

语法：

CREATE TABLE table_name [( column_name_list )]
    opt_engine:engineName
    opt_keys:keys
    opt_comment:tableComment
    opt_partition:partition
    opt_distribution:distribution
    opt_rollup:index
    opt_properties:tblProperties
    opt_ext_properties:extProperties
    KW_AS query_stmt:query_def

说明：

• 用户需要拥有来源表的SELECT权限和目标库的CREATE权限
• 创建表成功后，会进行数据导入，如果导入失败，将会删除表
• 可以自行指定 key type，默认为Duplicate Key
• 所有字符串类型的列 (varchar/var/string) 都会被创建为 string 类型。该功能自 Apache Doris 1.2 版本起支持。
• 如果创建的来源为外部表，并且第一列为 String 类型，则会自动将第一列设置为 VARCHAR(65533)。因为 Doris 内部表，不允许 String 列作为第一列。该功能自 Apache Doris 1.2 版本起支持

Example

1. 使用 select 语句中的字段名

   create table `test`.`select_varchar` 
   PROPERTIES("replication_num" = "1") 
   as select * from `test`.`varchar_table`

2. 自定义字段名 (需要与返回结果字段数量一致)

   create table `test`.`select_name`(user, testname, userstatus) 
   PROPERTIES("replication_num" = "1") 
   as select vt.userId, vt.username, jt.status 
   from `test`.`varchar_table` vt join 
   `test`.`join_table` jt on vt.userId=jt.userId

3. 指定表模型、分区、分桶

   CREATE TABLE t_user(dt, id, name)
   ENGINE=OLAP
   UNIQUE KEY(dt, id)
   COMMENT "OLAP"
   PARTITION BY RANGE(dt)
   (
      FROM ("2020-01-01") TO ("2021-12-31") INTERVAL 1 YEAR
   )
   DISTRIBUTED BY HASH(id) BUCKETS 1
   PROPERTIES("replication_num"="1")
   AS SELECT cast('2020-05-20' as date) as dt, 1 as id, 'Tom' as name;

Keywords

CREATE, TABLE, AS, SELECT

Best Practice