全部产品
Search
文档中心

云原生数据仓库AnalyticDB:ALTER TABLE(外表)

更新时间:Feb 21, 2025

云原生数据仓库 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';

参数说明

参数

说明

table_name

表名。

(partition_key=value[,...])

增加的分区。

增加多级分区时,此处需配置多个等式(paritition_key=value),等式之间以半角逗号(,)分隔。例如:ADD PARTITION (date='20230613',city='hangzhou')

location

指定LOCATION为分区的OSS路径。

例如,OSS文件的路径为oss://testBucketName/testfolder/p1=20230613/data.csv。增加的分区为p1='20230613'。此时需指定LOCATION 'oss://testBucketname/testfolder/'

示例

  • 增加分区。

    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[,...]);

参数说明

参数

说明

table_name

表名。

(partition_key=value[,...])

删除的分区。

删除多级分区时,此处需配置多个等式(paritition_key=value),等式之间以半角逗号(,)分隔。删除多级分区示例:DROP PARTITION (date='20230613',city='hangzhou')

示例

  • 删除分区。

    ALTER TABLE adb_external_db.partition_table DROP PARTITION (p1='20230613');
  • 删除多级分区。

    ALTER TABLE adb_external_db.partition_table DROP PARTITION (p1='20230613',p2='hangzhou');

相关文档

CREATE EXTERNAL TABLE