openGauss SQL语法 —ALTER TABLE（3）

• 其中列约束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' ]
  

• 其中列的压缩可选项compress_mode为：

[ DELTA | PREFIX | DICTIONARY | NUMSTR | NOCOMPRESS ]

• 其中根据已有唯一索引为表增加主键约束或唯一约束table_constraint_using_index为：

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

• 其中表约束table_constraint为：

  [ CONSTRAINT [ constraint_name ] ]
  	{ CHECK ( expression ) |
  	  UNIQUE [ idx_name ] [ USING method ] ( { { column_name [ ( length ) ] | ( 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 ]
  

• 其中索引参数index_parameters为：

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

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

  ALTER TABLE [ IF EXISTS ] [schema_name.]table_name 
      RENAME TO [new_schema_name.]new_table_name;
  

• 重命名表中指定的列。

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

• 重命名表的约束。

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

• 设置表的所属模式。

  ALTER TABLE [ IF EXISTS ] table_name 
      SET SCHEMA new_schema;
  

  

   说明：

  • 这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。

  • 要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。

  • 除了RENAME和SET SCHEMA之外所有动作都可以捆绑在一个经过多次修改的列表中并行使用。比如，可以在一个命令里增加几个字段或修改几个字段的类型。对于大表，此种操作带来的效率提升更明显，原因在于只需要对该大表做一次处理。

  • 增加一个CHECK或NOT NULL约束将会扫描该表，以保证现有的行符合约束要求。

  • 用一个非空缺省值增加一个字段或者改变一个字段的现有类型会重写整个表。对于大表来说，这个操作可能会花很长时间，并且它还临时需要两倍的磁盘空间。

• 添加多个列。

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

• 更新多个列。

  ALTER TABLE [ IF EXISTS ] table_name 
      MODIFY ( { column_name data_type [ CHARACTER SET | CHARSET charset ] [{[ COLLATE collation ] | [ column_constraint ]} [ ... ] ] [FIRST | AFTER column_name] | column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ] | column_name [ CONSTRAINT constraint_name ] NULL } [, ...] );
  

• 对表timestamp列添加ON UPDATE属性。

  ALTER TABLE table_name
      MODIFY column_name column_type ON UPDATE CURRENT_TIMESTAMP;
  

• 对表timestamp列删除ON UPDATE属性。

  ALTER TABLE table_name
      MODIFY column_name column_type;