更新时间:2026-11-06 GMT+08:00
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'); 父主题: DDL语句