参数说明

• UN LOG GED

  指定表为非日志表。在非日志表中写入的数据不会被写入到预写日志中，这样就会比普通表快很多。但是，非日志表在冲突或异常关机后会被自动删截，非日志表中的内容也不会被复制到备用服务器中，在该类表中创建的索引也不会被自动记录。

  • 使用场景：非日志表不能保证数据的安全性，用户应该在确保数据已经做好备份的前提下使用，例如系统升级时进行数据的备份。
  • 故障处理：当异常关机等操作导致非日志表上的索引发生数据丢失时，用户应该对发生错误的索引进行重建。
• 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

    取值范围：

    ROW（缺省值）：表的数据将以行式存储。

  • COMPRESSION

    指定表数据的压缩级别，它决定了表数据的压缩比以及压缩时间。一般来讲，压缩级别越高，压缩比也越大，压缩时间也越长；反之亦然。实际压缩比取决于加载的表数据的分布特征。

    取值范围：

    该参数仅支持列存压缩。

  • autovacuum_enabled

    自动清理功能是否对该表启用。

    取值范围：on/off

    默认值：on

  • autovacuum_vacuum_threshold

    自动清理功能中，指定在该表中触发VACUUM所需的更新或删除的最小元组数（仅对Astore表生效）。

    取值范围：0~2147483647

    默认值：-1，缺省时与GUC参数autovacuum_vacuum_threshold一致。

  • autovacuum_analyze_threshold

    自动清理功能中，指定在该表中触发ANALYZE所需的插入、更新或删除的最小元组数。

    取值范围：0~2147483647

    默认值：-1，缺省时与GUC参数autovacuum_analyze_threshold一致。

  • autovacuum_vacuum_scale_factor

    自动清理功能中，指定在该表中触发VACUUM所需的插入、更新或删除元组的比例（仅对Astore表生效）。

    取值范围：0.0~100.0

    默认值：-1，缺省时与GUC参数autovacuum_vacuum_scale_factor一致。

  • autovacuum_analyze_scale_factor

    自动清理功能中，指定在该表中触发ANALYZE所需的插入、更新或删除元组的比例。

    取值范围：0.0~100.0

    默认值：-1，缺省时与GUC参数autovacuum_analyze_scale_factor一致。

  • autovacuum_freeze_min_age

    自动清理功能中，在该表参数指定了一个行版本的最小年龄，超过这个年龄的行才会被冻结。

    取值范围：0~1000000000

    默认值：-1，缺省时与GUC参数vacuum_freeze_min_age一致。

  • autovacuum_freeze_max_age

    自动清理功能中，该表pg_class.relfrozenxid字段在超过多少个事务后，就会强制执行VACUUM操作。即使自动清理被禁用，系统也会启动AUTOVACUUM进程。清理操作还允许从pg_clog/子目录中删除旧文件（仅对Astore表生效）。

    取值范围：100000~2000000000

    默认值：-1，缺省时与GUC参数autovacuum_freeze_max_age一致。

  • autovacuum_freeze_table_age

    自动清理功能中，该表被标记为不需要自动清理时，将保持不变的时间。（仅对Astore表生效）。

    取值范围：0~2000000000

    默认值：-1，缺省时与GUC参数vacuum_freeze_table_age一致。

  • 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：提交时删除临时表中数据。
• [ 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”参数时，则不要数据。