云数据库 GAUSSDB-CREATE TABLE PARTITION | SUBPARTITION AS:参数说明

时间:2024-12-13 17:15:46

参数说明

  • IF NOT EXISTS

    如果指定IF NOT EXISTS关键字,创建表前会在当前SCHEMA中查找是否已有名字相同的relation。若已有同名relation存在,则不会新建,返回NOTICE提示。未指定IF NOT EXISTS关键字时,若SCHEMA中存在同名relation,返回ERROR告警。

  • partition_table_name

    要创建的分区表名。

    取值范围:字符串,要符合标识符命名规范

  • column_name

    可选。新表中要创建的字段名。如果没有指定字段名,那么新表的字段名和SELECT语句输入的字段名一致。

    取值范围:字符串,要符合标识符命名规范

  • ENGINE

    B模式下支持,仅语法适配,且只支持设置InnoDB,无实际效果。

  • WITH ( storage_parameter [= value] [, ... ] )

    这个子句为表或索引指定一个可选的存储参数。参数的详细说明如下所示。

    • FILLFACTOR

      一个表的填充因子(fillfactor)是一个介于10和100之间的百分数。在Ustore存储引擎下,该值得默认值为92,在Astore存储引擎下默认值为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一致。

  • [ 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表空间内创建。如果没有声明,将使用默认表空间。

  • PARTITION BY

    partition_clause与partition_definition_list的各字段详细信息请参见参数说明

  • SUBPARTITION BY

    subpartition_clause与partition_subpartition_definition_list的各字段详细信息请参见参数说明

  • AS query

    一个SELECT VALUES命令或者一个运行预备好的SELECT或VALUES查询的EXECUTE命令。

  • [ WITH [ NO ] DATA ]

    创建分区表时,是否也插入查询到的数据。默认是要数据,选择“NO”参数时,则不要数据。

support.huaweicloud.com/centralized-devg-v8-gaussdb/gaussdb-42-1690.html