ALTER TABLE

    • 表的所有者、被授予了表ALTER权限的用户或被授予ALTER ANY TABLE的用户有权限执行ALTER TABLE命令，系统管理员默认拥有此权限。但要修改表的所有者或者修改表的模式，当前用户必须是该表的所有者或者系统管理员，且该用户是新所有者角色的成员。
    • 不能修改分区表的tablespace，但可以修改分区的tablespace。
    • 不支持修改存储参数ORIENTATION。
    • SET SCHEMA操作不支持修改为系统内部模式，当前仅支持用户模式之间的修改。
    • 列存表只支持PARTIAL CLUSTER KEY、UNIQUE、PRIMARY KEY表级约束，不支持外键等表级约束。
    • 列存表只支持添加字段ADD COLUMN、修改字段的数据类型ALTER TYPE、设置单个字段的收集目标SET STATISTICS、支持更改表名称、支持更改表空间，支持删除字段DROP COLUMN。对于添加的字段和修改的字段类型要求是列存支持的数据类型。ALTER TYPE的USING选项只支持常量表达式和涉及本字段的表达式，暂不支持涉及其他字段的表达式。
    • 列存表支持的字段约束包括NULL、NOT NULL和DEFAULT常量值、UNIQUE和PRIMARY KEY；对字段约束的修改当前只支持对DEFAULT值的修改（SET DEFAULT）和删除（DROP DEFAULT），暂不支持对非空约束NULL/NOT NULL的修改。
    • 不支持增加自增列，或者增加DEFAULT值中包含nextval()表达式的列。
    • 不支持对外表、临时表开启行访问控制开关。
    • 通过约束名删除PRIMARY KEY约束时，不会删除NOT NULL约束，如果有需要，请手动删除NOT NULL约束。
    • 使用JDBC时，支持通过PrepareStatement对DEFAULT值进行参数化设置。
    • 重命名时，不能与当前模式下已存在的synonym产生命名冲突。
    • 修改模式时，不能与新模式下已存在的synonym产生命名冲突。
    • 仅支持在B兼容性数据库下指定COMMENT和可见性VISIBLE\INVISIBLE。
    • 使用FIRST | AFTER column_name新增列或修改列，或修改字段的字符集，会带来全表更新开销，影响在线业务。

    • 修改表的定义。

      其中具体表操作action可以是以下子句之一：

      2.     | ADD table_constraint [ NOT VALID ]
      3.     | ADD table_constraint_using_index
      4.     | VALIDATE CONSTRAINT constraint_name
      5.     | DROP CONSTRAINT [ IF EXISTS ]  constraint_name [ RESTRICT | CASCADE ]
      6.     | CLUSTER ON index_name
      7.     | SET WITHOUT CLUSTER
      8.     | SET ( {storage_parameter = value} [, ... ] )
      9.     | RESET ( storage_parameter [, ... ] )
      10.     | OWNER TO new_owner
      11.     | SET TABLESPACE new_tablespace
      12.     | SET {COMPRESS|NOCOMPRESS}
      13.     | TO { GROUP groupname | NODE ( nodename [, ... ] ) }
      14.     | ADD NODE ( nodename [, ... ] )
      15.     | DELETE NODE ( nodename [, ... ] )
      16.     | DISABLE TRIGGER [ trigger_name | ALL | USER ]
      17.     | ENABLE TRIGGER [ trigger_name | ALL | USER ]
      18.     | ENABLE REPLICA TRIGGER trigger_name
      19.     | ENABLE ALWAYS TRIGGER trigger_name
      20.     | DISABLE/ENABLE [ REPLICA | ALWAYS ] RULE
      21.     | DISABLE ROW LEVEL SECURITY
      22.     | ENABLE ROW LEVEL SECURITY
      23.     | FORCE ROW LEVEL SECURITY
      24.     | NO FORCE ROW LEVEL SECURITY
      25.     | ENCRYPTION KEY ROTATION
      26.     | INHERIT parents
      27.     | NO INHERIT parents
      28.     | OF type_name
      29.     | NOT OF
      30.     | REPLICA IDENTITY { DEFAULT | USING INDEX index_name | FULL | NOTHING }
      31.     | AUTO_INCREMENT [ = ] value
      32.     | COMMENT {=| } 'text'
      33.     | ALTER INDEX index_name [ VISBLE | INVISIBLE ]
      34.     | [ [ DEFAULT ] CHARACTER SET | CHARSET [ = ] default_charset ] [ [ DEFAULT ] COLLATE [ = ] default_collation ]
      35.     | CONVERT TO CHARACTER SET | CHARSET charset | DEFAULT [ COLLATE collation ]

      说明：

    • 其中列相关的操作column_clause可以是以下子句之一：

      1. ADD [ COLUMN ] column_name data_type [ CHARACTER SET | CHARSET [ = ] charset ] [ compress_mode ] [ COLLATE collation ] [ column_constraint [ ... ] ] [ COMMENT {=| } 'text' ] [ FIRST | AFTER column_name ]       
      2. | MODIFY column_name data_type  
      3. | MODIFY column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ]
      4. | MODIFY column_name [ CONSTRAINT constraint_name ] NULL
      5. | MODIFY [ COLUMN ] column_name data_type [ CHARACTER SET | CHARSET [ = ] charset ] [{[ COLLATE collation ] | [ column_constraint ]} [ ... ] ] [FIRST | AFTER column_name]
      6. | CHANGE [ COLUMN ] old_column_name new_column_name data_type [ CHARACTER SET | CHARSET [ = ] charset ] [{[ COLLATE collation ] | [ column_constraint ]} [ ... ] ] [FIRST | AFTER column_name]
      8. | ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ USING expression ]    
      9. | ALTER [ COLUMN ] column_name { SET DEFAULT expression | DROP DEFAULT }    
      10. | ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL    
      11. | ALTER [ COLUMN ] column_name SET STATISTICS [PERCENT] integer    
      12. | ADD STATISTICS (( column_1_name, column_2_name [, ...] ))    
      13. | DELETE STATISTICS (( column_1_name, column_2_name [, ...] ))    
      14. | ALTER [ COLUMN ] column_name SET ( {attribute_option = value} [, ... ] )    
      15. | ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] )

    | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }

    2. ![](public_sys-resources/icon-note.gif) **说明：** 
    4. >- **ADD \[ COLUMN \] column\_name data\_type \[ compress\_mode \] \[ COLLATE collation \] \[ column\_constraint \[ ... \] \] [ FIRST | AFTER column_name ]    **
    5. >  向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。其中FIRST | AFTER column\_name表示新增字段到某个位置。
    6. >
    7. >  - **ADD \( \{ column\_name data\_type \[ compress\_mode \] \} \[, ...\] \)**
    8. >    向表中增加多列。
    9. >
    10. >
    11. >  - **MODIFY \( \{ column\_name data\_type | column\_name \[ CONSTRAINT constraint\_name \] NOT NULL \[ ENABLE \] | column\_name \[ CONSTRAINT constraint\_name \] NULL \} \[, ...\] \)**
    12. >    修改表已存在字段的数据类型。
    13. >
    14. >  - **MODIFY \[ COLUMN \] column\_name data\_type \[ CHARACTER SET | CHARSET charset \] \[\{\[ COLLATE collation \] | \[ column\_constraint \]\} \[ ... \] \] \[FIRST | AFTER column\_name\]**
    15. >    修改表已存在字段的定义，将用新定义替换字段原定义，原字段上的索引、独立对象约束（例如：主键、唯一键、CHECK约束等）不会被删除。\[FIRST | AFTER column\_name\]语法表示修改字段定义的同时修改字段在表中的位置。
    16. >    此语法只能在参数sql\_compatibility='B'时使用。不支持列存表，不支持外表，不支持修改加密字段，不支持修改分区键字段的数据类型和排序规则，不支持修改规则引用的字段的数据类型和排序规则，不支持修改物化视图引用的字段的数据类型和排序规则。
    17. >    被修改数据类型或排序规则的字段如果被一个生成列引用，这个生成列的数据将会重新生成。
    18. >    被修改字段若被一些对象调用（比如：自定义函数、存储过程等），修改字段不会处理这些对象。修改字段完毕后，这些对象有可能出现不可用的情况，请修改字段前评估这类影响。
    19. >    修改字段的字符集或字符序会将字段中的数据转换为新的字符集进行编码。
    20. >    此子句与上一子句中“MODIFY column\_name data\_type”部分语法相同，语义功能不同，当GUC参数b\_format\_behavior\_compat\_options含有'enable\_modify\_column'选项时，将按照此子句功能处理。
    21. >
    22. >- **CHANGE \[ COLUMN \] old\_column\_name new\_column\_name data\_type \[ CHARACTER SET | CHARSET charset \] \[\{\[ COLLATE collation \] | \[ column\_constraint \]\} \[ ... \] \] \[FIRST | AFTER column\_name\]**
    23. >  修改表已存在字段的名称和定义，字段新名称不能是已有字段的名称，将用新名称和定义替换字段原名称和定义原字段上的索引、独立对象约束（例如：主键、唯一键、CHECK约束）等不会被删除。\[FIRST | AFTER column\_name\]语法表示修改字段名称和定义的同时修改字段在表中的位置。
    24. >  此语法只能在参数sql\_compatibility='B'时使用。不支持列存表，不支持外表。不支持修改加密字段，不支持修改分区键字段的数据类型和排序规则，不支持修改规则引用的字段的数据类型和排序规则，不支持修改物化视图引用的字段的数据类型和排序规则
    25. >  被修改数据类型或排序规则的字段如果被一个生成列引用，这个生成列的数据将会重新生成。
    26. >  被修改字段若被一些对象依赖（比如：索引、独立对象约束、视图、触发器、行级访问控制策略等），修改字段过程中将会重建这些对象。若被修改后字段定义违反此类对象的约束，修改操作会失败，比如：修改作为视图结果列的字段的数据类型。请修改字段前评估这类影响。
    27. >  被修改字段若被一些对象调用（比如：自定义函数、存储过程等），修改字段不会处理这些对象。修改字段名称后，这些对象有可能出现不可用的情况，请修改字段前评估这类影响。
    28. >  修改字段的字符集或字符序会将字段中的数据转换为新的字符集进行编码。
    29. >
    30. >- **DROP \[ COLUMN \] \[ IF EXISTS \] column\_name \[ RESTRICT | CASCADE \]**
    31. >  从表中删除一个字段，和这个字段相关的索引和表约束也会被自动删除。如果任何表之外的对象依赖于这个字段，必须声明CASCADE ，比如视图。
    33. >
    34. >- **ALTER \[ COLUMN \] column\_name \[ SET DATA \] TYPE data\_type \[ COLLATE collation \] \[ USING expression \]**
    35. >  改变表字段的数据类型。该字段涉及的索引和简单的表约束将被自动地转换为使用新的字段类型，方法是重新分析最初提供的表达式。
    36. >  ALTER TYPE要求重写整个表的特性有时候是一个优点，因为重写的过程消除了表中没用的空间。比如，要想立刻回收被一个已经删除的字段占据的空间，最快的方法是
    37. >
    38. >

    ALTER TABLE table ALTER COLUMN anycol TYPE anytype; ```

    这里的anycol是任何在表中还存在的字段，而anytype是和该字段的原类型一样的类型。这样的结果是在表上没有任何可见的语意的变化，但是这个命令强制重写，这样就删除了不再使用的数据。

    • ALTER [ COLUMN ] column_name { SET DEFAULT expression | DROP DEFAULT } 为一个字段设置或者删除缺省值。请注意缺省值只应用于随后的INSERT命令，它们不会修改表中已经存在的行。也可以为视图创建缺省，这个时候它们是在视图的ON INSERT规则应用之前插入到INSERT句中的。

    • ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL 修改一个字段是否允许NULL值或者拒绝NULL值。如果表在字段中包含非NULL，则只能使用SET NOT NULL。

    • ALTER [ COLUMN ] column_name SET STATISTICS [PERCENT] integer 为随后的ANALYZE操作设置针对每个字段的统计收集目标。目标的范围可以在0到10000之内设置。设置为-1时表示重新恢复到使用系统缺省的统计目标。

    • {ADD | DELETE} STATISTICS ((column_1_name, column_2_name [, …])) 用于添加和删除多列统计信息声明（不实际进行多列统计信息收集），以便在后续进行全表或全库analyze时进行多列统计信息收集。如果关闭GUC参数enable_functional_dependency，每组多列统计信息最多支持32列；如果开启GUC参数enable_functional_dependency，每组多列统计信息最多支持4列。不支持添加/删除多列统计信息声明的表：系统表、外表。

    • ALTER [ COLUMN ] column_name SET ( {attribute_option = value} [, … ] ) ALTER [ COLUMN ] column_name RESET ( attribute_option [, … ] ) 设置/重置属性选项。 目前，属性选项只定义了n_distinct和n_distinct_inherited。n_distinct影响表本身的统计值，而n_distinct_inherited影响表及其继承子表的统计。目前，只支持SET/RESET n_distinct参数，禁止SET/RESET n_distinct_inherited参数。

    • ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } 为一个字段设置存储模式。这个设置控制这个字段是内联保存还是保存在一个附属的表里，以及数据是否要压缩。仅支持对行存表的设置；对列存表没有意义，执行时报错。SET STORAGE本身并不改变表上的任何东西，只是设置将来的表操作时，建议使用的策略。

    • 其中列约束column_constraint为： ```

    [ CONSTRAINT constraint_name ] { NOT NULL | NULL | CHECK ( expression ) | DEFAULT default_expr | GENERATED ALWAYS AS ( generation_expr ) [STORED] | AUTO_INCREMENT | ON UPDATE update_expr | UNIQUE [KEY] index_parameters | PRIMARY KEY index_parameters | ENCRYPTED WITH ( COLUMN_ENCRYPTION_KEY = column_encryption_key, ENCRYPTION_TYPE = encryption_type_value ) |
    REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] [ COMMENT ‘text’ ]

    4. - 其中列的压缩可选项compress\_mode为：
    2. -   其中根据已有唯一索引为表增加主键约束或唯一约束table\_constraint\_using\_index为：

    [ CONSTRAINT constraint_name ] { UNIQUE | PRIMARY KEY } USING INDEX index_name [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ]

    2. -   其中表约束table\_constraint为：

    [ CONSTRAINT [ constraint_name ] ] { CHECK ( expression ) | UNIQUE [ idx_name ][ USING method ] ( { { column_name | ( expression ) } [ ASC | DESC ] } [, … ] ) index_parameters [ VISIBLE | INVISIBLE ] | PRIMARY KEY [ USING method ] ( { column_name [ ASC | DESC ] } [, … ] ) index_parameters [ VISIBLE | INVISIBLE ] | PARTIAL CLUSTER KEY ( column_name [, … ] } FOREIGN KEY [ idx_name ] ( column_name [, … ] ) REFERENCES reftable [ ( refcolumn [, … ] ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] [ COMMENT ‘text’ ]

    2.   其中索引参数index\_parameters为：

    [ WITH ( {storage_parameter = value} [, … ] ) ] [ USING INDEX TABLESPACE tablespace_name ]

    4. -   重命名表。对名称的修改不会影响所存储的数据。

    ALTER TABLE [ IF EXISTS ] table_name RENAME TO new_table_name;

    ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name )} RENAME [ COLUMN ] column_name TO new_column_name;

    2. -   重命名表的约束。

    ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name ) } RENAME CONSTRAINT constraint_name TO new_constraint_name;

    2. -   设置表的所属模式。

    ALTER TABLE [ IF EXISTS ] table_name SET SCHEMA new_schema;

    2.   >![](public_sys-resources/icon-note.gif) **说明：** 
    3.   >-   这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。
    4.   >-   要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。
    5.   >-   除了RENAME和SET SCHEMA之外所有动作都可以捆绑在一个经过多次修改的列表中并行使用。比如，可以在一个命令里增加几个字段或修改几个字段的类型。对于大表，此种操作带来的效率提升更明显，原因在于只需要对该大表做一次处理。
    6.   >-   增加一个CHECK或NOT NULL约束将会扫描该表，以保证现有的行符合约束要求。
    7.   >-   用一个非空缺省值增加一个字段或者改变一个字段的现有类型会重写整个表。对于大表来说，这个操作可能会花很长时间，并且它还临时需要两倍的磁盘空间。
    9. -   添加多个列。

    ALTER TABLE [ IF EXISTS ] table_name ADD ( { column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ … ] ]} [, …] );

    2. -   更新多个列。

    – 创建B模式数据库。 openGauss=# create database test_first_after dbcompatibility ‘b’; openGauss=# \c test_first_after – 创建表t1并插入数据。 openGauss=# drop table if exists t1 cascade; openGauss=# create table t1(f1 int, f2 varchar(20), f3 timestamp, f4 bit(8), f5 bool); openGauss=# insert into t1 values(1, ‘a’, ‘2022-11-08 19:56:10.158564’, x’41’, true), (2, ‘b’, ‘2022-11-09 19:56:10.158564’, x’42’, false); – 指定位置新增字段 openGauss=# alter table t1 add f6 clob first; openGauss=# alter table t1 add f7 blob after f2; openGauss=# alter table t1 add f8 int, add f9 text first, add f10 float after f3; – 查询t1表结构 openGauss=# \d+ t1 – 查询t1表数据 openGauss=# select * from t1; – 修改字段到指定位置 openGauss=# alter table t1 modify f3 timestamp first; openGauss=# alter table t1 modify f1 int after f5; – 查询t1表结构 openGauss=# \d+ t1 – 查询t1表数据 openGauss=# select * from t1; – 修改t1表的默认字符集为utf8mb4，默认字符序为utf8mb4_bin openGauss=# alter table t1 charset utf8mb4 collate utf8mb4_bin; – 将t1表中字符类型字段的数据转化为utf8mb4编码，并设置表和字段的字符序为utf8mb4_bin openGauss=# alter table t1 convert to charset utf8mb4 collate utf8mb4_bin; – 为t1表新增字段并设置字段的字符集为utf8mb4，字符序为utf8mb4_bin openGauss=# alter table t1 add t10 varchar(20) charset utf8mb4 collate utf8mb4_bin; – 修改t1表的t10字段的字符集为utf8mb4，字符序为utf8mb4_unicode_ci openGauss=# alter table t1 modify t10 varchar(20) charset utf8mb4 collate utf8mb4_unicode_ci; – 创建INVISIBLE唯一索引 openGauss=# alter table t1 add constraint uniq_a unique (f1) invisible; – 修改索引为VISIBLE openGauss=# alter table t1 alter index uniq_a visible;

    4. ## 相关链接<a name="zh-cn_topic_0283137126_zh-cn_topic_0237122076_zh-cn_topic_0059779051_s489a6430be6447c193a4011257dc4994"></a>