RENAME COLUMN

最近更新时间:2026-05-20 14:11:22

我的收藏

描述

ALTER TABLE ... RENAME COLUMN 语句用于重命名表中的列。支持重命名顶层列和嵌套结构体中的字段。嵌套重命名只会修改叶子字段名。

语法

ALTER TABLE table_name RENAME COLUMN old_name TO new_name;
注意:
嵌套重命名命令只修改叶子字段的名称。例如 RENAME COLUMN location.lat TO latitude 会将 location.lat 改名为 location.latitude
列重命名仅变更元数据定义,不涉及底层数据的迁移或重写。

示例

创建基础表及数据

DROP TABLE IF EXISTS tci_rename_col;
CREATE TABLE tci_rename_col (
id BIGINT NOT NULL,
old_name STRING,
old_email STRING
) USING tci
TBLPROPERTIES ('primary-key' = 'id');

INSERT INTO tci_rename_col
VALUES (1, 'Alice', 'alice@test.com'), (2, 'Bob', 'bob@test.com');

RENAME COLUMN

ALTER TABLE tci_rename_col
RENAME COLUMN old_name TO username;

再次 RENAME

ALTER TABLE tci_rename_col
RENAME COLUMN old_email TO user_email;

验证新列名可用

DESCRIBE tci_rename_col;
SELECT id, username, user_email FROM tci_rename_col;