ALTER 命令参考

功能概述

修改云器 Lakehouse 中已有对象的定义、属性或配置。

语法

ALTER <object_type> <object_name> <actions>

参数说明

参数说明是否必填

参数	说明	是否必填
`<object_type>` <object_type>	要修改的对象类型，如 `TABLE` TABLE 、 `SCHEMA` SCHEMA 、 `VCLUSTER` VCLUSTER 等	是
`<object_name>` <object_name>	对象名称，可包含 schema 前缀	是
`<actions>` <actions>	具体操作，如 `ADD COLUMN` ADD COLUMN 、 `SET COMMENT` SET COMMENT 、 `RENAME TO` RENAME TO 等	是

<object_type>

<object_type>

要修改的对象类型，如

TABLE

TABLE

、

SCHEMA

SCHEMA

、

VCLUSTER

VCLUSTER

等

是

<object_name>

<object_name>

对象名称，可包含 schema 前缀

是

<actions>

具体操作，如

ADD COLUMN

ADD COLUMN

、

SET COMMENT

SET COMMENT

、

RENAME TO

RENAME TO

等

是

支持的对象类型

对象类型	语法示例	说明
工作空间	`ALTER WORKSPACE <name> SET ...` ALTER WORKSPACE <name> SET ...	修改工作空间配置
计算集群	`ALTER VCLUSTER <name> ...` ALTER VCLUSTER <name> ...	修改 VCluster 规格/状态
数据分享	`ALTER SHARE <name> ...` ALTER SHARE <name> ...	修改 Share 配置
Schema	`ALTER SCHEMA <name> ...` ALTER SCHEMA <name> ...	修改 Schema 属性
外部 Schema	`ALTER EXTERNAL SCHEMA <name> ...` ALTER EXTERNAL SCHEMA <name> ...	修改外部 Schema 配置
普通表	`ALTER TABLE <name> ...` ALTER TABLE <name> ...	修改表属性、添加/删除列等
表列	`ALTER TABLE <name> ALTER COLUMN ...` ALTER TABLE <name> ALTER COLUMN ...	列级别结构变更
动态表	`ALTER DYNAMIC TABLE <name> ...` ALTER DYNAMIC TABLE <name> ...	暂停/恢复/重命名动态表
物化视图	`ALTER MATERIALIZED VIEW <name> ...` ALTER MATERIALIZED VIEW <name> ...	修改物化视图属性
外部表	`ALTER EXTERNAL TABLE <name> ...` ALTER EXTERNAL TABLE <name> ...	修改外部表配置
管道	`ALTER PIPE <name> ...` ALTER PIPE <name> ...	修改 Pipe 调度配置
用户	`ALTER USER <name> ...` ALTER USER <name> ...	修改用户属性

权限要求

执行

ALTER

ALTER

操作通常需要对目标对象具有

OWNERSHIP

OWNERSHIP

或相应的管理权限。部分操作（如修改 VCLUSTER 配置）还需要工作空间级别的管理权限。

注意事项

```
ALTER
```
ALTER
语句用于修改已有对象，不需要删除并重建
```
ALTER TABLE COLUMN
```
ALTER TABLE COLUMN
专门用于列级别的结构变更（增加、删除、修改列）
动态表不支持通过
```
ALTER
```
ALTER
修改 SQL 定义，需使用
```
CREATE OR REPLACE
```
CREATE OR REPLACE

ALTER 命令参考

功能概述

语法

参数说明

支持的对象类型

权限要求

注意事项

语法参考

实例与工作空间

计算与共享

Schema 与 Catalog

数据对象

管道与连接

用户与角色