# ALTER语句
#### 概述
ALTER语句用于修改已注册到Catalog中的对象定义，包括表、视图、数据库、函数和Catalog。通过ALTER语句可在不重建对象的情况下完成Schema演进、属性修改、重命名等操作。
#### 适用场景
- **Schema演进**：业务需求变更时通过ALTER TABLE ADD/DROP COLUMN在线调整表结构，无需重建表。
- **参数调优**：运行中需要调整连接器配置参数，通过ALTER TABLE SET修改WITH属性。
- **对象管理**：对表或视图进行重命名，修正命名不规范问题。
 
#### 约束与限制
- ALTER TABLE添加的列默认追加到表末尾，不支持指定列的位置。
- 修改Watermark或主键约束时，需确保与现有列定义兼容。
- ALTER DATABASE修改的属性取决于Catalog实现，不同Catalog支持不同的属性。
- ALTER VIEW仅支持重命名和修改属性，不支持修改视图的查询定义。
- 对正在被作业使用的表执行ALTER操作可能导致作业异常，建议在作业停止后执行。
- ALTER TABLE仅修改元数据，是否可以修改物理表结构取决于连接器实现。
 
#### 语法结构
**ALTER TABLE**
-- 重命名表
```
ALTER TABLE [catalog_name.][db_name.]table_name RENAME TO new_table_name;
```
-- 修改表属性
```
ALTER TABLE [catalog_name.][db_name.]table_name SET (key1=val1, key2=val2, ...);
```
-- 添加列
```
ALTER TABLE [catalog_name.][db_name.]table_name ADD (col_name col_type [COMMENT col_comment], ...);
```
-- 删除列
```
ALTER TABLE [catalog_name.][db_name.]table_name DROP (col_name, ...);
```
-- 添加Watermark
```
ALTER TABLE [catalog_name.][db_name.]table_name ADD WATERMARK FOR rowtime_col AS watermark_expr;
```
-- 删除Watermark
```
ALTER TABLE [catalog_name.][db_name.]table_name DROP WATERMARK;
```
-- 添加主键
```
ALTER TABLE [catalog_name.][db_name.]table_name ADD PRIMARY KEY (col_name, ...) NOT ENFORCED;
```
-- 删除主键
```
ALTER TABLE [catalog_name.][db_name.]table_name DROP PRIMARY KEY;
```
-- 修改列名
```
ALTER TABLE [catalog_name.][db_name.]table_name RENAME col_name TO new_col_name;
```
-- 修改列类型
```
ALTER TABLE [catalog_name.][db_name.]table_name MODIFY (col_name new_col_type [COMMENT col_comment], ...);
```
**ALTER VIEW**
-- 重命名视图
```
ALTER VIEW [catalog_name.][db_name.]view_name RENAME TO new_view_name;
```
-- 修改视图属性
```
ALTER VIEW [catalog_name.][db_name.]view_name SET (key1=val1, key2=val2, ...);
```
**ALTER DATABASE**
-- 修改数据库属性
```
ALTER DATABASE [catalog_name.]db_name SET (key1=val1, key2=val2, ...);
```
**ALTER FUNCTION**
-- 修改函数定义
```
ALTER [SYSTEM] FUNCTION [IF EXISTS] [catalog_name.][db_name.]function_name
AS class_identifier
[LANGUAGE JAVA|SCALA|PYTHON];
```
**ALTER CATALOG**
-- 修改Catalog属性
```
ALTER CATALOG catalog_name SET (key1=val1, key2=val2, ...);
```
#### 使用示例
**示例：ALTER TABLE添加列和修改属性**
```
-- ALTER TABLE paimon_append_source ADD (email STRING COMMENT '用户邮箱');
-- ALTER TABLE paimon_append_source SET ('rows-per-second' = '200');
```
