数据仓库服务 GAUSSDB(DWS)-CREATE TABLE:参数说明

时间:2024-05-23 15:38:26

参数说明

  • IF NOT EXISTS

    指定IF NOT EXISTS时,若不存在同名表,则可以成功创建表。若已存在同名表,创建时不会报错,仅会提示该表已存在并跳过创建。

  • table_name

    要创建的表名。

    表名长度不超过63个字符,以字母或下划线开头,可包含字母、数字、下划线、$、#。

  • column_name

    新表中要创建的字段名。

    字段名长度不超过63个字符,以字母或下划线开头,可包含字母、数字、下划线、$、#。

  • data_type

    字段的数据类型。

  • LIKE source_table [ like_option ... ]

    LIKE子句声明一个表,新表自动从这个表中继承所有字段名及其数据类型。

    新表与原表之间在创建动作完毕之后是完全无关的。在原表做的任何修改都不会传播到新表中,并且也不可能在扫描原表的时候包含新表的数据。

    被复制的列并不使用相同的名字进行融合。如果明确的指定了相同的名字或者在另外一个LIKE子句中,将会报错。

    HStore表只能从HStore表中进行继承。

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

    这个子句为表指定一个可选的存储参数。

    • ORIENTATION

      指定表数据的存储方式,即时序方式、行存方式、列存方式,该参数设置成功后就不再支持修改。对于HStore表,应当使用列存方式,同时设置enable_hstore为on。

      取值范围:

      • TIMESERIES,表示表的数据将以时序方式存储。
      • COLUMN,表示表的数据将以列存方式存储。
      • ROW,表示表的数据将以行方式存储。

      默认值:ROW。

    • COMPRESSION

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

      取值范围:

      • HStore表和列存表的有效值为YES/NO和/LOW/MIDDLE/HIGH,默认值为LOW。
      • 行存表的有效值为YES/NO,默认值为NO。
    • COMPRESSLEVEL

      指定表数据同一压缩级别下的不同压缩水平,它决定了同一压缩级别下表数据的压缩比以及压缩时间。对同一压缩级别进行了更加详细的划分,为用户选择压缩比和压缩时间提供了更多的空间。总体来讲,此值越大,表示同一压缩级别下压缩比越大,压缩时间越长;反之亦然。该参数只对时序表和列存表有效。

      取值范围:0~3

      默认值:0

    • MAX_BATCHROW

      指定了在数据加载过程中一个存储单元可以容纳记录的最大数目。该参数只对时序表和列存表有效。

      取值范围:10000~60000

      默认值:60000

    • PARTIAL_CLUSTER_ROWS

      指定了在数据加载过程中进行将局部聚簇存储的记录数目。该参数只对时序表和列存表有效。

      取值范围:600000~2147483647

    • enable_delta

      指定了在列存表是否开启delta表。对HStore表不能开启该参数。

      默认值:off

    • enable_hstore

      指定了是否创建为H-Store表(基于列存表实现)。该参数只对列存表有效。该参数仅8.2.0.100及以上集群版本支持。云原生3.0暂不支持该参数。

      默认值:off

      打开该参数时必须设置以下GUC参数用于保证H-Store表的清理,推荐值如下:

      autovacuum=true,autovacuum_max_workers=6,autovacuum_max_workers_hstore=3。

    • SUB_PARTITION_COUNT

      指定二级分区的个数。该参数用于设置在导入阶段二级分区个数。在建表时进行设置,建表后不支持修改。不建议用户随意设置该默认值,可能会影响导入和查询的性能。

      取值范围:1~1024

      默认值:32

    • DELTAROW_THRESHOLD

      指定HStore表导入时小于多少行(SUB_PARTITION_COUNT * DELTAROW_THRESHOLD)的数据进入delta表。

      取值范围:0~60000

      默认值:60000

    • COLVERSION

      指定存储格式的版本。 HStore表只支持2.0版本。

      取值范围:

      1.0:列存表的每列以一个单独的文件进行存储,文件名以relfilenode.C1.0、relfilenode.C2.0、relfilenode.C3.0等命名。

      2.0:列存表的每列合并存储在一个文件中,文件名以relfilenode.C1.0命名。

      默认值:2.0

    • DISTRIBUTE BY

      指定表如何在节点之间分布或者复制。

      取值范围:

      HASH (column_name ) :对指定的列进行Hash,通过映射,把数据分布到指定DN。

    • TO { GROUP groupname | NODE ( nodename [, ... ] ) }

      TO GROUP指定创建表所在的Node Group,目前不支持hdfs表使用。TO NODE主要供内部扩容工具使用,一般用户不应该使用。

    • PARTITION BY

      指定HStore表的初始分区。

support.huaweicloud.com/HybridDevg-dws/dws_15_00005.html