参数说明

• IF NOT EXISTS

  如果已经存在相同名称的表，不会抛出一个错误，而会发出一个通知，告知表关系已存在。

• subpartition_table_name

  二级分区表的名称。

  取值范围：字符串，要符合标识符命名规范。

• column_name

  新表中要创建的字段名。

  取值范围：字符串，要符合标识符命名规范。

• data_type

  字段的数据类型。

• COLLATE collation

  COLLATE子句指定列的排序规则（该列必须是可排列的数据类型）。如果没有指定，则使用默认的排序规则。排序规则可以使用“SELECT * FROM pg_collation;”命令从pg_collation系统表中查询，默认的排序规则为查询结果中以default开始的行。

• CONSTRAINT constraint_name

  列约束或表约束的名称。可选的约束子句用于声明约束，新行或者更新的行必须满足这些约束才能成功插入或更新。

  定义约束有两种方法：

  • 列约束：作为列定义的一部分，仅影响该列。
  • 表约束：作用于多个列。
    

    在B模式数据库下（即sql_compatibility = 'B'）constraint_name为可选项，在其他模式数据库下，必须加上constraint_name。

• index_name

  索引名。

  

  • index_name仅在B模式数据库下（即sql_compatibility = 'B'）支持，其他模式数据库下不支持。
  • 对于外键约束，constraint_name和index_name同时指定时，索引名为constraint_name。
  • 对于唯一键约束，constraint_name和index_name同时指定时，索引名以index_name。
• USING method

  指定创建索引的方法。

  取值范围参考参数说明中的USING method。

  

  • USING method仅在B模式数据库下（即sql_compatibility = 'B'）支持，其他模式数据库下不支持。
  • 在B模式下，未指定USING method时，对于ASTORE的存储方式，默认索引方法为btree；对于USTORE的存储方式，默认索引方法为ubtree。
• ASC | DESC

  ASC表示指定按升序排序（默认）。DESC指定按降序排序。

  

  ASC|DESC只在B模式数据库下（即sql_compatibility = 'B'）支持，其他模式数据库不支持。

• LIKE source_table [ like_option ... ]

  LIKE子句声明一个表，新表自动从这个表里面继承所有字段名及其数据类型和非空约束。

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

  • 字段缺省表达式只有在声明了INCLUDING DEFAULTS之后才会包含进来。缺省是不包含缺省表达式的，即新表中所有字段的缺省值都是NULL。
  • 如果指定了INCLUDING UPDATE，则原表列的ON UPDATE CURRENT_TIMESTAMP属性会复制到新表列中。默认不复制该属性。
  • 如果指定了INCLUDING GENERATED，则原表列的生成表达式会复制到新表中。默认不复制生成表达式。
  • 非空约束将总是复制到新表中，CHECK约束则仅在指定了INCLUDING CONSTRAINTS的时候才复制，而其他类型的约束则永远也不会被复制。此规则同时适用于表约束和列约束。

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

  • 如果指定了INCLUDING INDEXES，则原表上的索引也将在新表上创建，默认不建立索引。
  • 如果指定了INCLUDING STORAGE，则原表列的STORAGE设置也将被复制，默认情况下不包含STORAGE设置。
  • 如果指定了INCLUDING COMMENTS，则原表列、约束和索引的注释也会被复制过来。默认情况下，不复制原表的注释。
  • 如果指定了INCLUDING RELOPTIONS，则原表的存储参数（即原表的WITH子句）也将复制至新表。默认情况下，不复制原表的存储参数。
  • 如果指定了INCLUDING IDENTITY，则原表的identity功能会复制到新表中，并创建一个与原表SEQUENCE参数相同的SEQUENCE。默认情况下，不复制原表的identity功能。
  • INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING UPDATE、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION、INCLUDING RELOPTIONS和INCLUDING IDENTITY的内容。
• AUTO_INCREMENT [ = ] value

  这个子句为自动增长列指定一个初始值，value必须为正整数，不得超过2¹²⁷-1。

  

  该子句仅在参数sql_compatibility='B'时有效。

• COMMENT [ = ] 'string'
  • COMMENT [ = ] 'string'子句表示给表添加注释。
  • 在column_constraint中的COMMENT 'string'表示给列添加注释。
  • 在table_constraint中的COMMENT 'string'表示给主键和唯一键对应的索引添加注释。

  具体请参见：•COMMENT [ = ] 'string'

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

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

  • FILLFACTOR

    一个表的填充因子（fillfactor）是一个介于10和100之间的百分数。在Ustore存储引擎下，该值的默认值为92，在Astore存储引擎下默认值为100（完全填充）。如果指定了较小的填充因子，INSERT操作仅按照填充因子指定的百分率填充表页。每个页上的剩余空间将用于在该页上更新行，这就使得UPDATE有机会在同一页上放置同一条记录的新版本，这比把新版本放置在其他页上更有效。对于一个从不更新的表将填充因子设为100是最佳选择，但是对于频繁更新的表，选择较小的填充因子则更加合适。

    取值范围：10~100

  • ORIENTATION

    决定了表的数据的存储方式。

    取值范围：

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

      orientation不支持修改。

  • STORAGE_TYPE

    指定存储引擎类型，该参数设置成功后就不再支持修改。

    取值范围：

    • USTORE，表示表支持Inplace-Update存储引擎。
      

      使用USTORE表，需开启track_counts和track_activities参数，否则会引起空间膨胀。

    • ASTORE，表示表支持Append-Only存储引擎。

    默认值：

    不指定表时，默认是Inplace-Update存储。

  • COMPRESSION
    • 行存表不支持压缩。
  • segment

    使用段页式的方式存储。本参数仅支持行存表。不支持临时表、unlog表。

    取值范围：on/off

    默认值：off

  • statistic_granularity

    记录该表在分析统计信息时的默认partition_mode，partition_mode说明详见ANALYZE|ANALYSE参数说明，此参数对非分区表设置无效。

    取值范围：见partition_mode取值范围。

    默认值：AUTO。

  • enable_tde

    指定该表为加密表。数据库会自动将加密表中的数据先加密再存储。使用该参数前，请确保已通过GUC参数enable_tde开启透明加密功能，并通过GUC参数tde_key_info设置访问密钥服务的信息，在《特性指南》中“透明 数据加密 ”章节可获取该参数的详细使用方法。本参数仅支持行存表、段页式表、hashbucket表、临时表和unlogged表。

    取值范围：on/off。设置enable_tde=on时，key_type、tde_cmk_id、dek_cipher参数由数据库自动生成，用户无法手动指定或更改。

    默认值：off

  • encrypt_algo

    指定加密表的加密算法，需与enable_tde结合使用。

    取值范围：字符串，有效值为：AES_128_CTR，SM4_CTR。

    默认值：不设置enable_tde选项时默认为空；设置enable_tde选项设置时，默认为AES_128_CTR。

  • dek_cipher

    数据密钥的密文。用户为表设置enable_tde参数后，数据库自动生成数据密钥。

    取值范围：字符串

    默认值：空

  • key_type

    主密钥的类型。用户为表设置enable_tde参数后，数据库自动从GUC参数tde_key_info中获取主密钥的类型。

    取值范围：字符串

    默认值：空

  • cmk_id

    主密钥的ID。用户为表设置enable_tde参数后，数据库自动从GUC参数tde_key_info中获取主密钥的ID。

    取值范围：字符串

    默认值：空

• [ 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 {RANGE [COLUMNS] | LIST [COLUMNS] | HASH | KEY} (partition_key)
  • 对于partition_key，分区策略的分区键仅支持1列。
  • 分区键支持的数据类型和一级分区表约束保持一致。
  • COLUMNS关键字只能在sql_compatibility='B'时使用，只能加在RANGE或LIST之后，“RANGE COLUMNS” 语义同 “RANGE”，“LIST COLUMNS” 语义同 “LIST”。
  • KEY关键字只能在sql_compatibility='B'时使用，KEY与HASH同义。
• SUBPARTITION BY {RANGE | LIST | HASH | KEY} (subpartition_key)
  • 对于subpartition_key，分区策略的分区键仅支持1列。
  • 分区键支持的数据类型和一级分区表约束保持一致。
  • KEY关键字只能在sql_compatibility='B'时使用，KEY与HASH同义。
• AUTOMATIC

  创建新表时，若指定关键字AUTOMATIC，则开启列表分区的自动扩展功能，缺省时表示不开启自动扩展功能。只有列表分区可以使用自动扩展功能。

  开启自动扩展功能后，当插入数据无法匹配到已有分区时，会自动创建一个单独的分区。

  

  根据一级分区和二级分区是否开启自动扩展功能，插入数据时会有以下几种情况。

  • 一级分区开启了自动扩展功能，二级分区为任意分区策略：若插入数据没有匹配到一级分区，会自动创建相应的一级分区，对应的二级分区为全集。
  • 二级分区开启了自动扩展功能，一级分区为任意分区策略：若插入数据没有匹配到一级分区，则插入失败；若插入数据匹配到了一级分区，没有匹配到二级分区，会自动创建相应的二级分区。
  • 一级分区跟二级分区都开启了自动扩展功能：若插入数据没有匹配到一级分区或二级分区，会自动创建对应层级的分区。

• PARTITIONS integer

  指定分区个数。

  integer为分区数，必须为大于0的整数，且不得大于1048575。

  • 当在RANGE和LIST分区后指定此子句时，必须显式定义每个分区，且定义分区的数量必须与integer值相等。只能在sql_compatibility='B'时在RANGE和LIST分区后指定此子句。
  • 当在HASH和KEY分区后指定此子句时，若不列出各个分区定义，将自动生成integer个分区，自动生成的分区名为“p+数字”，数字依次为0到integer-1，分区的表空间默认为此表的表空间；也可以显式列出每个分区定义，此时定义分区的数量必须与integer值相等。若既不列出分区定义，也不指定分区数量，将创建唯一一个分区。
• SUBPARTITIONS integer

  指定二级分区数量。

  integer为二级分区个数，必须为大于0的整数，且不得大于1048575。

  • 只能在HASH和KEY二级分区后指定此子句。
    • 若不列出各个二级分区定义，将在每个一级分区内自动生成integer个二级分区，自动生成的二级分区名为“一级分区名+sp+数字”，数字依次为0到integer-1，分区的表空间默认为此表的表空间。
    • 也可以列出每个二级分区定义，此时二级分区的数量必须与integer值相等。
    • 若既不列出每个二级分区定义，也不指定二级分区数量，将创建唯一一个二级分区。
• { ENABLE | DISABLE } ROW MOVEMENT

  行迁移开关。

  如果进行UPDATE操作时，更新了元组在分区键上的值，造成了该元组所在分区发生变化，就会根据该开关给出报错信息，或者进行元组在分区间的转移。

  取值范围：

  • ENABLE（缺省值）：行迁移开关打开。
  • DISABLE：行迁移开关关闭。

  在打开行迁移开关情况下，并发UPDATE、DELETE操作可能会报错，原因如下：

  UPDATE和DELETE操作对于旧数据都是标记为已删除。在打开行迁移开关情况下，如果更新分区键时，导致了跨分区更新，内核会把旧分区中旧数据标记为已删除，在新分区中新增加一条数据，无法通过旧数据找到新数据。

  在以下三个并发场景下，UPDATE和UPDATE并发、DELETE和DELETE并发和UPDATE和DELETE并发，如果并发操作同一行数据时，数据跨分区和非跨分区结果有不同的行为。

  1. 对于数据非跨分区结果，第一个操作执行完后，第二个操作不会报错。
     • 如果第一个操作是UPDATE，第二个操作能成功找到最新的数据，之后对新数据操作。
     • 如果第一个操作是DELETE，第二个操作看到当前数据已经被删除而且找不到最新数据，就终止操作。
  2. 对于数据跨分区结果，第一个操作执行完后，第二个操作会报错。
     • 如果第一个操作是UPDATE，由于新数据在新分区中，第二个操作不能成功找到最新的数据，就无法操作，之后会报错。
     • 如果第一个操作是DELETE，第二个操作当前数据已经被删除而且找不到最新数据，但无法判断删除旧数据的操作是UPDATE还是DELETE。如果是UPDATE，报错处理。如果是DELETE，终止操作。为了保持数据的正确性，只能报错处理。

  如果是UPDATE和UPDATE并发，UPDATE和DELETE并发场景，需要串行执行才能解决问题，如果是DELETE和DELETE并发，关闭行迁移开关可以解决问题。

• NOT NULL

  字段值不允许为NULL。ENABLE用于语法兼容，可省略。

• NULL

  字段值允许NULL ，缺省值。

  该子句只是为和非标准SQL数据库兼容。不建议使用。

• CHECK (condition) [ NO INHERIT ]

  CHECK约束声明一个布尔表达式，每次要插入的新行或者要更新的行的新值必须使表达式结果为真或未知才能成功，否则会抛出一个异常并且不会修改数据库。

  声明为字段约束的检查约束应该只引用该字段的数值，而在表约束里出现的表达式可以引用多个字段。

  用NO INHERIT标记的约束将不会传递到子表中去。

  ENABLE用于语法兼容，可省略。

• DEFAULT default_expr

  DEFAULT子句给字段指定缺省值。该数值可以是任何不含变量的表达式(不允许使用子查询和对本表中的其他字段的交叉引用)。缺省表达式的数据类型必须和字段类型匹配。

  缺省表达式将被用于任何未声明该字段数值的插入操作。如果没有指定缺省值则缺省值为NULL 。

• ON UPDATE update_expr

  ON UPDATE子句为字段的一种属性约束。

  当对表中某元组执行UPDATE操作时，若更新字段的新值和表中旧值不相同，则表中该元组上具有该属性且不在更新字段内的字段值自动更新为当前时间戳；若更新字段的新值和表中旧值相同，则表中该元组上具有该属性且不在更新字段内的字段值不变，保持原有值；若具有该属性的字段在更新字段内，则对应这些字段值直接按指定更新的值更新。

  

  • 该属性仅支持在B模式库中的5.7版本下指定（即sql_compatibility = 'B'、b_format_version='5.7'、b_format_dev_version='s1'）。
  • 语法上update_expr支持CURRENT_TIMESTAMP 、LOCALTIMESTAMP 、NOW()三种关键字，也支持关键字带括号指定或不指定精度。例如：ON UPDATE CURRENT_TIMESTAMP()、ON UPDATE CURRENT_TIMESTAMP(5)、ON UPDATE LOCALTIMESTAMP()、ON UPDATE LOCALTIMESTAMP(6)等。不带括号或空括号时精度为0，其中NOW关键字不支持不带括号。三种关键字互为同义词，属性效果相同。
  • 该属性仅支持在如下类型的列上指定: timestamp、datetime、date、time without time zone、smalldatetime、abstime。
  • CREATE TABLE AS语法不会继承该列属性。
  • CREATE TABLE LIKE语法可通过INCLUDING UPDATE或EXCLUDING UPDATE来选择继承或排除该约束。LIKE语法继承自PostgreSQL的LIKE语法，目前不支持复制旧表的ilm策略信息。
  • 该属性指定的精度和对应列上类型指定的精度可以不一致，通过该属性更新字段值后显示结果按最小精度显示。例如：CREATE TABLE t1 (col1 timestamp(6) ON UPDATE CURRENT_TIMESTAMP(3)); 若UPDATE语法触发该属性生效，则本次更新后col1字段值小数位显示3位。
  • 该属性和生成列约束不能同时指定同一列。
  • 分区表中的分区键不支持指定该属性。
• GENERATED ALWAYS AS ( generation_expr ) [STORED]

  该子句将字段创建为生成列，生成列的值在写入（插入或更新）数据时由generation_expr计算得到，STORED表示像普通列一样存储生成列的值。

  

  • STORED关键字可省略，与不省略STORED语义相同。
  • 生成表达式不能以任何方式引用当前行以外的其他数据。生成表达式不能引用其他生成列，不能引用系统列。生成表达式不能返回结果集，不能使用子查询，不能使用聚集函数，不能使用窗口函数。生成表达式调用的函数只能是不可变（IMMUTABLE）函数。
  • 不能为生成列指定默认值。
  • 生成列不能作为分区键的一部分。
  • 生成列不能和ON UPDATE约束子句的CASCADE、SET NULL、SET DEFAULT动作同时指定。生成列不能和ON DELETE约束子句的SET NULL、SET DEFAULT动作同时指定。
  • 修改和删除生成列的方法和普通列相同。删除生成列依赖的普通列，生成列被自动删除。不能改变生成列所依赖的列的类型。
  • 生成列不能被直接写入。在INSERT或UPDATE命令中，不能为生成列指定值，但是可以指定关键字DEFAULT。
  • 生成列的权限控制和普通列一样。
• GENERATED [ ALWAYS | BY DEFAULT [ ON NULL ] ] AS IDENTITY [ ( identity_options ) ]

  该子句将列创建为IDENTITY列。会根据identity_options自动创建一个隐式序列附加到指定列，在插入数据时将序列中获取的值自动分配给该列。

  • GENERATED ALWAYS AS IDENTITY：该列仅接受插入由序列生成器提供的IDENTITY值，不能接受用户指定值。
  • GENERATED BY DEFAULT AS IDENTITY：该列优先插入用户提供值，若用户不指定值，将插入由序列生成器提供的IDENTITY值。
  • GENERATED BY DEFAULT ON NULL AS IDENTITY：该列优先插入用户提供值，若用户指定NULL值或用户不指定值，将插入由序列生成器提供的IDENTITY值。
  可选的identity_options子句可用于覆盖序列选项。

  • increment：指定隐式序列步长。为正数时将生成一个递增的序列，为负数时将生成一个递减的序列，缺省值为1。
  • MINVALUE minvalue | NO MINVALUE | NOMINVALUE：执行序列的最小值，如果没有声明minvalue或者声明了NO MINVALUE，则递增序序列缺省值为1，递减序列的缺省值为-10^27+1。NOMINVALUE等价于NO MINVALUE。
  • MAXVALUE maxvalue | NO MAXVALUE | NOMAXVALUE：执行序列的最大值，如果没有声明maxvalue或者声明了NO MAXVALUE，则递增序序列缺省值为10^28-1，递减序列的缺省值为-1。NOMAXVALUE等价于NO MAXVALUE。
  • start：指定隐式序列的起始值。缺省值：对于递增序列为minvalue，递减序列为maxvalue。
  • cache：为了快速访问，而在内存中预先存储序列号的个数。缺省值为1，表示一次只能生成一个值，即没有缓存。
  • NOCACHE：未预先存储序列的值。
  • CYCLE：用于使序列达到maxvalue或者minvalue后可循环并继续下去。如果声明了NO CYCLE，则在序列达到其最大或最小值之后任何对nextval的调用都会返回一个错误。NOCYCLE等价于NO CYCLE，缺省值为NO CYCLE。
  • SCALE：用于启用序列的可伸缩性。如果指定，则会在序列的开头附加一个数字偏移量，防止生成值中有重复项。如果声明了NOSCALE，则禁止序列的可伸缩性。缺省值为NOSCALE。
  • EXTEND：扩展数字偏移量长度（默认值为6），将序列生成值对齐到x（默认为6）+y（最大位数）位，指定EXTEND时必须指定SCALE。如果声明了NOEXTEND，则不扩展数字偏移量长度。缺省值为NOEXTEND。

  

  • IDENTITY列只能为smallint、integer、bigint、decimal、numeric、float、double precision或real数字类型。
  • 在A兼容模式下，当创建IDENTITY列为整数数字类型时，将默认创建为numeric数字类型。
  • 修改IDENTITY列的字段类型和普通列相同，但仅限于修改为smallint、integer、bigint、decimal、numeric、float、double precision和real数字类型。
  • IDENTITY列默认有NOT NULL约束。
  • 一张表里只允许有一个IDENTITY列。
  • 删除IDENTITY列的方法和删除普通列相同，删除列时，IDENTITY的隐式序列将会被自动删除。
  • IDENTITY列不能和SET DEFAULT动作同时指定。
  • 自动创建的隐式序列的类型为LARGE SEQUENCE。
  • 用户不能执行DROP LARGE SEQUENCE或ALTER LARGE SEQUENCE对IDENTITY的隐式序列进行修改。
  • 当对该表进行赋权后，插入能正常执行，若要更改IDENTITY列、删除IDENTITY属性或删除IDENTITY列，需要对相应的隐式序列额外赋权。
  • [ SCALE [ EXTEND | NOEXTED ] | NOSCALE ]子句仅用于A兼容模式的集中式下创建IDENTITY列时可用。
  • 在全密态数据库下，不支持创建表时指定加密IDENTITY列。
• AUTO_INCREMENT

  指定列为自动增长列。

  详见：•AUTO_INCREMENT。

• UNIQUE [KEY] index_parameters

  UNIQUE ( column_name [, ... ] ) index_parameters

  UNIQUE约束表示表里的一个字段或多个字段的组合必须在全表范围内唯一。

  对于唯一约束，NULL被认为是互不相等的。

  UNIQUE KEY只能在sql_compatibility='B'时使用，与UNIQUE语义相同。

• PRIMARY KEY index_parameters

  PRIMARY KEY ( column_name [, ... ] ) index_parameters

  主键约束声明表中的一个或者多个字段只能包含唯一的非NULL值。

  一个表只能声明一个主键。

• DEFERRABLE | NOT DEFERRABLE

  这两个关键字设置该约束是否可推迟。一个不可推迟的约束将在每条命令之后马上检查。可推迟约束可以推迟到事务结尾使用SET CONSTRAINTS命令检查。缺省是NOT DEFERRABLE。目前，UNIQUE约束、主键约束、外键约束可以接受这个子句。所有其他约束类型都是不可推迟的。

• INITIALLY IMMEDIATE | INITIALLY DEFERRED

  如果约束是可推迟的，则这个子句声明检查约束的缺省时间。

  • 如果约束是INITIALLY IMMEDIATE（缺省），则在每条语句执行之后就立即检查它；
  • 如果约束是INITIALLY DEFERRED ，则只有在事务结尾才检查它。

  约束检查的时间可以用SET CONSTRAINTS命令修改。

• USING INDEX TABLESPACE tablespace_name

  为UNIQUE或PRIMARY KEY约束相关的索引声明一个表空间。如果没有提供这个子句，这个索引将在default_tablespace中创建，如果default_tablespace为空，将使用数据库的缺省表空间。