CREATE TABLE AS

功能描述

根据查询结果创建表。

CREATE TABLE AS创建一个表并且用来自SELECT命令的结果填充该表。该表的字段和SELECT输出字段的名称及数据类型相关。不过用户可以通过明确地给出一个字段名称列表来覆盖SELECT输出字段的名称。

CREATE TABLE AS和创建视图有些相似，CREATE TABLE AS会创建一个新表并且只计算该查询一次用来将数据写入新表中。这个表之后将不会根据源表变化而改变。相反视图只要被查询，它的定义SELECT语句将会被重新计算。

注意事项

分区表不能采用此方式进行创建。
如果在建表过程中数据库系统发生故障，系统恢复后可能无法自动清除之前已创建的、大小非0的磁盘文件。此种情况出现概率小，不影响数据库系统的正常运行。
在为数据对象增加或者变更ILM策略的时候，如果追加了行级表达式，需要注意行表达式目前只支持白名单中列出的函数。具体白名单函数列表参考行表达式函数白名单。

语法格式

    
         CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name
    [ (column_name [, ...] ) ]
    [ { ENGINE [ = ] { InnoDB | 'InnoDB' | "InnoDB" } } [ [ , ] ... ] ]
    [ WITH ( {storage_parameter = value} [, ... ] ) ]
    [ ON COMMIT { PRESERVE ROWS | DELETE ROWS } ]
    [ COMPRESS | NOCOMPRESS ]
    [ ILM ADD POLICY ROW STORE { COMPRESS ADVANCED } { ROW } AFTER n { day | month | year } OF { NO MODIFICATION } [ ON ( EXPR )]]
    [ TABLESPACE tablespace_name ]
    [ DISTRIBUTE BY { REPLICATION | { [HASH ] ( column_name ) } } ]
    [ TO { GROUP groupname | NODE ( nodename [, ... ] ) } ]
    AS query
    [ WITH [ NO ] DATA ];

各个字段详细信息见语法格式。

参数说明

UNLOGGED
指定表为非日志表。在非日志表中写入的数据不会被写入到预写日志中，这样就会比普通表快很多。但是，非日志表在冲突或异常关机后会被自动删截，非日志表中的内容也不会被复制到备用服务器中，在该类表中创建的索引也不会被自动记录。
- 使用场景：非日志表不能保证数据的安全性，用户应该在确保数据已经做好备份的前提下使用，例如系统升级时进行数据的备份。
- 故障处理：当异常关机等操作导致非日志表上的索引发生数据丢失时，用户应该对发生错误的索引进行重建。
GLOBAL | LOCAL
创建临时表时可以在TEMP或TEMPORARY前指定GLOBAL或LOCAL关键字。目前这两个关键字的设立，仅是为了兼容SQL标准，实际上无论指定GLOBAL还是LOCAL，GaussDB都会创建本地临时表。
TEMPORARY | TEMP
如果指定TEMP或TEMPORARY关键字，则创建的表为临时表。临时表只在当前会话可见，当前会话结束后会自动删除。因此，若当前会话连接的CN以外的其他CN故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。
- 临时表通过每个会话独立的以pg_temp开头的SCHEMA来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的SCHEMA。
- 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的SCHEMA为当前会话的pg_temp开头的SCHEMA，则该表会被创建为临时表。
- 临时表只对当前会话可见，因此不支持与\parallel on并行执行一起使用。
- 临时表不支持DN故障或者主备切换。
IF NOT EXISTS
如果指定IF NOT EXISTS关键字，创建表前会在当前SCHEMA中查找是否已有名字相同的relation。若已有同名relation存在，则不会新建，返回NOTICE提示。未指定IF NOT EXISTS关键字时，若SCHEMA中存在同名relation，返回ERROR告警。
table_name
要创建的表名。

取值范围：字符串，要符合标识符命名规范。
column_name
可选。新表中要创建的字段名。如果没有指定字段名，那么新表的字段名和SELECT语句输入的字段名一致。

取值范围：字符串，要符合标识符命名规范。
ENGINE
MYSQL模式下支持，仅语法适配，且只支持设置InnoDB，无实际效果。
WITH ( storage_parameter [= value] [, ... ] )
这个子句为表或索引指定一个可选的存储参数。参数的详细说明如下所示。
- FILLFACTOR
  一个表的填充因子（fillfactor）是一个介于10和100之间的百分数。在Ustore存储引擎下，该值的默认值为92。100（完全填充）是默认值。如果指定了较小的填充因子，INSERT操作仅按照填充因子指定的百分率填充表页。每个页上的剩余空间将用于在该页上更新行，这就使得UPDATE有机会在同一页上放置同一条记录的新版本，这比把新版本放置在其他页上更有效。对于一个从不更新的表将填充因子设为100是最佳选择，但是对于频繁更新的表，选择较小的填充因子则更加合适。该参数只对行存表有效。
  
  取值范围：10~100
- ORIENTATION
  取值范围：
  
  COLUMN：表的数据将以列式存储。
  
  ROW（缺省值）：表的数据将以行式存储。
- COMPRESSION
  指定表数据的压缩级别，它决定了表数据的压缩比以及压缩时间。一般来讲，压缩级别越高，压缩比也越大，压缩时间也越长；反之亦然。实际压缩比取决于加载的表数据的分布特征。
  
  取值范围：
  
  行存表不支持压缩。
- hashbucket
  创建hash bucket存储。本参数仅支持行存表和行存range表。
  
  取值范围：on/off
  
  默认值：off
  
  当前版本hashbucket表相关DDL操作性能受限，不建议频繁对hashbucket表进行DDL操作。
ON COMMIT { PRESERVE ROWS | DELETE ROWS }
ON COMMIT选项决定在事务中执行创建临时表操作，当事务提交时，此临时表的后续操作。当前仅支持PRESERVE ROWS和DELETE ROWS选项。
- PRESERVE ROWS（缺省值）：提交时不对临时表执行任何操作，临时表及其表数据保持不变。
- DELETE ROWS：提交时删除临时表中数据。
COMPRESS / NOCOMPRESS
创建一个新表时，需要在创建表语句中指定关键字COMPRESS，这样，当对该表进行批量插入时就会触发压缩特性。该特性会在页范围内扫描所有元组数据，生成字典、压缩元组数据并进行存储。指定关键字NOCOMPRESS则不对表进行压缩。行存表不支持压缩。

缺省值：NOCOMPRESS，即不对元组数据进行压缩。
[ ILM ADD POLICY ROW STORE { COMPRESS ADVANCED } { ROW } AFTER n { day | month | year } OF { NO MODIFICATION } [ ON ( EXPR )]]
创建新表时，可以调用ILM ADD POLICY ROW STORE COMPRESS ADVANCED ROW给行存添加高级压缩策略。
- AFTER n { day | month | year } OF NO MODIFICATION ：表示n天/月/年没有修改的行。
- ON ( EXPR )：行级表达式，用于判断行的冷热。
TABLESPACE tablespace_name
指定新表将要在tablespace_name表空间内创建。如果没有声明，将使用默认表空间。
DISTRIBUTE BY
详细信息见•DISTRIBUTE BY。
TO { GROUP groupname | NODE ( nodename [, ... ] ) }
TO GROUP指定创建表所在的Node Group。TO NODE主要供内部扩容工具使用，一般用户不应该使用。
AS query
一个SELECT VALUES命令或者一个运行预备好的SELECT或VALUES查询的EXECUTE命令。
[ WITH [ NO ] DATA ]
创建表时，是否也插入查询到的数据。默认是要数据，选择“NO”参数时，则不要数据。

示例

不指定字段名时新表字段和SELECT查询结果一致。

-- 创建test1表并向表中插入2条记录。
gaussdb=# CREATE TABLE test1(col1 int PRIMARY KEY,col2 varchar(10));
gaussdb=# INSERT INTO test1 VALUES (1,'col1'),(101,'col101');
-- 查询表中col1<100的数据。
gaussdb=# SELECT * FROM test1 WHERE col1 < 100;
 col1 | col2 
------+------
    1 | col1
(1 row)

-- 创建test2表并向表中插入上面查询的数据。
gaussdb=# CREATE TABLE test2 AS SELECT * FROM test1 WHERE col1 < 100;

-- 查询test2表表结构。
gaussdb=# \d test2;
 Column |         Type          | Modifiers 
--------+-----------------------+-----------
 col1   | integer               | 
 col2   | character varying(10) |

为新表指定字段名。

-- 使用test1复制一个新表test3并指定字段名。
gaussdb=# CREATE TABLE test3(c1,c2) AS SELECT * FROM test1;

-- 查询test3表结构。
gaussdb=# \d test3
            Table "public.test3"
 Column |         Type          | Modifiers 
--------+-----------------------+-----------
 c1     | integer               | 
 c2     | character varying(10) | 

-- 删除。
gaussdb=# DROP TABLE test1,test2,test3;

创建开启ILM策略的表。

      
           --创建ORA兼容的数据库。
gaussdb=# CREATE DATABASE ilmtabledb WITH dbcompatibility = 'ORA';
gaussdb=# \c ilmtabledb

--开启数据库ILM特性。
ilmtabledb=#  ALTER DATABASE SET ILM = on;

--创建一个开启ILM策略的表ilm_table并插入old_table的数值。
ilmtabledb=# CREATE TABLE old_table (a int);
ilmtabledb=# CREATE TABLE ilm_table
  ILM ADD POLICY ROW STORE COMPRESS ADVANCED
  ROW AFTER 3 MONTHS OF NO MODIFICATION
  AS (SELECT * FROM old_table);

--删除。
ilmtabledb=# DROP TABLE old_table,ilm_table;
ilmtabledb=# \c postgres
gaussdb=# DROP DATABASE ilmtabledb;

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

CREATE TABLE AS

功能描述

注意事项

语法格式

参数说明

示例

相关链接

意见反馈

文档内容是否对您有帮助？