ALTER TABLE（外表）
云原生数据仓库 AnalyticDB MySQL 版支持通过ALTER TABLE修改外表结构，包括修改列名、列数据类型、增加或删除分区。本文介绍ALTER TABLE修改外表的语法。
本文仅适用于外表。内表的ALTER语法，请参见ALTER TABLE。
前提条件
集群的产品系列为企业版、基础版或湖仓版。
列
内核版本为3.2.1.0及以上版本的集群支持该语法。
查看企业版、基础版或湖仓版集群的内核版本，请执行SELECT adb_version();。如需升级内核版本，请联系技术支持。
变更列名
语法
ALTER TABLE table_name RENAME COLUMN column_name to new_column_name示例
将osstest1表中的city_name列更名为city。
ALTER TABLE osstest1 RENAME COLUMN city_name to city;变更列数据类型
语法
ALTER TABLE table_name MODIFY [COLUMN] column_name new_column_type示例
将osstest1表中age列由INT类型更改为BIGINT类型。
ALTER TABLE osstest1 MODIFY COLUMN age BIGINT;变更列的默认值
语法
ALTER TABLE table_name MODIFY [COLUMN] column_name column_type DEFAULT constant|CURRENT_TIMESTAMP示例
将osstest1表中的sex列的默认值设置为0。
ALTER TABLE osstest1 MODIFY COLUMN sex INT DEFAULT 0;变更列的COMMENT
语法
ALTER TABLE table_name MODIFY [COLUMN] column_name column_type COMMENT 'new_comment'示例
将osstest1表中region列的COMMENT更改为地域。
ALTER TABLE osstest1 MODIFY COLUMN region VARCHAR COMMENT '地域';分区
分区相关的语法仅适用于OSS分区外表，其他外表不支持。
内核版本为3.1.8.0及以上版本的集群支持该语法。
查看企业版、基础版或湖仓版集群的内核版本，请执行
SELECT adb_version();。如需升级内核版本，请联系技术支持。
通过ALTER TABLE ADD PARTITION可以手动在分区外表中添加特定的某个分区或某个多级分区。如果需要自动识别OSS路径并添加分区，请参见MSCK REPAIR TABLE。
增加分区
语法
ALTER TABLE table_name ADD PARTITION (partition_key=value[,...]) LOCATION 'location';参数说明
参数 | 说明 |
| 表名。 |
| 增加的分区。 增加多级分区时，此处需配置多个等式（ |
| 指定LOCATION为分区的OSS路径。 例如，OSS文件的路径为oss://testBucketName/testfolder/p1=20230613/data.csv。增加的分区为p1='20230613'。此时需指定 |
示例
增加分区。
ALTER TABLE adb_external_db.partition_table ADD PARTITION (p1='20230613') LOCATION 'oss://testBucketName/testfolder/p1=20230613/';增加多级分区。
ALTER TABLE adb_external_db.partition_table ADD PARTITION (p1='20230613',p2='hangzhou') LOCATION 'oss://testBucketName/testfolder/p1=20230613/p2=hangzhou';
删除分区
语法
ALTER TABLE table_name DROP PARTITION (partition_key=value[,...]);参数说明
参数 | 说明 |
| 表名。 |
| 删除的分区。 删除多级分区时，此处需配置多个等式（ |
示例
删除分区。
ALTER TABLE adb_external_db.partition_table DROP PARTITION (p1='20230613');删除多级分区。
ALTER TABLE adb_external_db.partition_table DROP PARTITION (p1='20230613',p2='hangzhou');