ALTER TABLE

功能描述

修改表，包括修改表的定义、重命名表、重命名表中指定的列、重命名表的约束、设置表的所属模式、添加/更新多个列、打开/关闭行访问控制开关。

注意事项

  • 本章节只包含dolphin新增的语法，原openGauss的语法未做删除和修改。
  • 当一条语句下有多条子命令时，drop index和rename index会优先其他子命令执行，这两种命令的优先级一致。

语法格式

  • 修改表的定义。

1. ALTER TABLE [ IF EXISTS ] { table_name [*] | ONLY table_name | ONLY ( table_name ) } 2. action [, ... ];

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

1. column_clause 2. | {DISABLE | ENABLE} KEYS 3. | DROP INDEX index_name [ RESTRICT | CASCADE ] 4. | DROP PRIMARY KEY [ RESTRICT | CASCADE ] 5. | DROP FOREIGN KEY foreign_key_name [ RESTRICT | CASCADE ] 6. | RENAME INDEX index_name to new_index_name 7. | ADD table_indexclause 8. | MODIFY column_name column_type ON UPDATE CURRENT_TIMESTAMP 9. | AUTOEXTEND_SIZE [=] value 10. | AVG_ROW_LENGTH [=] value 11. | CHECKSUM [=] value 12. | CONNECTION [=] 'connect_string' 13. | {DATA | INDEX} DIRECTORY [=] 'absolute path to directory' 14. | DELAY_KEY_WRITE [=] value 15. | ENCRYPTION [=] 'encryption_string' 16. | ENGINE_ATTRIBUTE [=] 'string' 17. | INSERT_METHOD [=] { NO | FIRST | LAST } 18. | KEY_BLOCK_SIZE [=] value 19. | MAX_ROWS [=] value 20. | MIN_ROWS [=] value 21. | PACK_KEYS [=] value 22. | PASSWORD [=] 'password' 23. | START TRANSACTION 24. | SECONDARY_ENGINE_ATTRIBUTE [=] 'string' 25. | STATS_AUTO_RECALC [=] value 26. | STATS_PERSISTENT [=] value 27. | STATS_SAMPLE_PAGES [=] value 28. | UNION [=] (tbl_name[,tbl_name]...) 29. | TABLESPACE tablespace_name [STORAGE DISK] 30. | [TABLESPACE tablespace_name] STORAGE MEMORY - 对一个表进行重建。

1. ALTER TABLE table_name FORCE; - 重命名表。对名称的修改不会影响所存储的数据。

1. ALTER TABLE [ IF EXISTS ] table_name 2. RENAME { TO | AS } new_table_name; - 对表timestamp列添加ON UPDATE属性。

1. ALTER TABLE table_name 2. MODIFY column_name column_type ON UPDATE CURRENT_TIMESTAMP; - 对表timestamp列删除ON UPDATE属性。

1. ALTER TABLE table_name 2. MODIFY column_name column_type; - ADD table_indexclause

在表上新增一个索引

1. {[FULLTEXT] INDEX | KEY} [index_name] [index_type] (key_part,...)[index_option]...

其中参数index_type为：

1. USING {BTREE | HASH | GIN | GIST | PSORT | UBTREE}

其中参数key_part为：

1. {col_name[(length)] | (expr)} [ASC | DESC]

其中参数index_option为：

1. index_option:{ 2. COMMENT 'string' 3. | index_type 4. | [ VISIBLE | INVISIBLE ] 5. | [WITH PARSER NGRAM] 6. }

COMMENT、index_type、[ VISIBLE | INVISIBLE ] 的顺序和数量任意，但相同字段仅最后一个值生效。WITH PARSER NGRAM 为FULLTEXT INDEX指定的ngram解析器，前提是索引必须指定关键字FULLTEXT，FULLTEXT 默认 WITH PARSER NGRAM。

参数说明

  • {DISABLE | ENABLE} KEYS

禁用和启用一个表的所有非唯一索引。 - DROP INDEX index_name [ RESTRICT | CASCADE ]

删除一个表的索引。 - DROP PRIMARY KEY [ RESTRICT | CASCADE ]

删除一个表的外键。 - DROP FOREIGN KEY foreign_key_name [ RESTRICT | CASCADE ]

删除一个表的外键。 - RENAME INDEX index_name to new_index_name

重命名一个表的索引。 - AUTOEXTEND_SIZE [=] value

用于指定在表空间变满时扩展表空间大小；目前该特性仅有语法支持，不实现功能。参数的取值范围包括非负整数，小数，标识符，非负整数+标识符，小数+标识符。 - AVG_ROW_LENGTH [=] value

用于指定表的平均行长度；目前该特性仅有语法支持，不实现功能。参数的取值范围包括非负整数，小数。 - CHECKSUM [=] value

用于指定是否维护所有行的实时校验和；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数，十六进制数。 - CONNECTION [=] ‘connect_string’

用于指定联合表的连接字符串；目前该特性仅有语法支持，不实现功能。参数的取值范围为任意字符串。 - {DATA | INDEX} DIRECTORY [=] ‘absolute path to directory’

用于指定表数据数据和索引的存储目录；目前该特性仅有语法支持，不实现功能。参数的取值范围为任意字符串。 - DELAY_KEY_WRITE [=] value

用于指定是否延迟表的键更新直到表关闭；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数，十六进制数。 - ENCRYPTION [=] ‘encryption_string’

用于指定表启用或禁用页面级数据加密；目前该特性仅有语法支持，不实现功能。参数的取值范围为任意字符串。 - ENGINE_ATTRIBUTE [=] ‘string’

用于指定主存储引擎的表属性；目前该特性仅有语法支持，不实现功能。参数的取值范围为任意字符串。 - INSERT_METHOD [=] { NO | FIRST | LAST }

用于指定应将行插入到的表；目前该特性仅有语法支持，不实现功能。参数的取值范围为NO，FIRST，LAST。 - KEY_BLOCK_SIZE [=] value

用于指定索引键块的字节大小；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数。 - MAX_ROWS [=] value

用于指定计划在表中存储的最大行数；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数。 - MIN_ROWS [=] value

用于指定计划在表中存储的最小行数；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数。 - PACK_KEYS [=] value

用于指定控制压缩索引的方式；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数，十六进制数，DEFAULT。 - PASSWORD [=] ‘password’

此选项未使用；目前该特性仅有语法支持，不实现功能。参数的取值范围为任意字符串。 - SECONDARY_ENGINE_ATTRIBUTE [=] ‘string’

用于指定辅助存储引擎的表属性；目前该特性仅有语法支持，不实现功能。参数的取值范围为任意字符串。 - START TRANSACTION

用于开启事务模式；目前该特性仅有语法支持，不实现功能。 - STATS_AUTO_RECALC [=] value

用于指定是否自动重新计算表的持久统计信息；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数，十六进制数，DEFAULT。 - STATS_PERSISTENT [=] value

用于指定是否为表启用持久统计信息；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数，十六进制数，DEFAULT。 - STATS_SAMPLE_PAGES [=] value

用于指定估计索引列的基数和其他统计信息时要采样的索引页数；目前该特性仅有语法支持，不实现功能。参数的取值范围为非负整数，小数，十六进制数。 - UNION [=] (tbl_name[,tbl_name]…)

用于访问一组相同的表作为一个表；目前该特性仅有语法支持，不实现功能。 - TABLESPACE tablespace_name [STORAGE DISK]

用于指定表存储在磁盘；目前该特性仅有语法支持，不实现功能。 - [TABLESPACE tablespace_name] STORAGE MEMORY

用于指定表存储在内存；目前该特性仅有语法支持，不实现功能。

ALTER TABLE - 图1 说明：

涉及的参数说明可见ALTER TABLE。

示例

— 创建表、外键和非唯一索引。

1. openGauss=# CREATE TABLE alter_table_tbl1 (a INT PRIMARY KEY, b INT);
2. openGauss=# CREATE TABLE alter_table_tbl2 (c INT PRIMARY KEY, d INT);
3. openGauss=# ALTER TABLE alter_table_tbl2 ADD CONSTRAINT alter_table_tbl_fk FOREIGN KEY (d) REFERENCES alter_table_tbl1 (a);
4. openGauss=# CREATE INDEX alter_table_tbl_b_ind ON alter_table_tbl1(b);

— 禁用和启用非唯一索引。

1. openGauss=# ALTER TABLE alter_table_tbl1 DISABLE KEYS;
2. openGauss=# ALTER TABLE alter_table_tbl1 ENABLE KEYS;

— 删除索引。

1. openGauss=# ALTER TABLE alter_table_tbl1 DROP KEY alter_table_tbl_b_ind;

— 删除主键。

1. openGauss=# ALTER TABLE alter_table_tbl2 DROP PRIMARY KEY;

— 删除外键。

1. openGauss=# ALTER TABLE alter_table_tbl2 DROP FOREIGN KEY alter_table_tbl_fk;

— 重建表。

1. openGauss=# ALTER TABLE alter_table_tbl1 FORCE;

— 重命名索引。

1. openGauss=# CREATE INDEX alter_table_tbl_b_ind ON alter_table_tbl1(b);
2. openGauss=# ALTER TABLE alter_table_tbl1 RENAME INDEX alter_table_tbl_b_ind TO new_alter_table_tbl_b_ind;

— 修改表，创建INVISIBLE普通索引

1. openGauss=# ALTER TABLE alter_table_tbl1 ADD INDEX alter_table_tbl_b_ind(b) INVISIBLE;

— 删除表。

1. openGauss=# DROP TABLE alter_table_tbl1, alter_table_tbl2;

— 兼容MySQL全文索引，添加全文索引语法，前提是兼容模式为B的数据库。

1. test=# ALTER TABLE test ADD FULLTEXT INDEX test_index_1 (title, boby) WITH PARSER ngram;
2. ALTER TABLE
3. test=# \d test_index_1
4. Index "fulltext_test.test_index_1"
5. Column    | Type |                   Definition
6. --------------+------+------------------------------------------------
7. to_tsvector  | text | to_tsvector('"ngram"'::regconfig, title::text)
8. to_tsvector1 | text | to_tsvector('"ngram"'::regconfig, boby)
9. gin, for table "fulltext_test.test"

相关链接

ALTER TABLE