更新时间: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');

相关文档