RENAME TABLE

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

我的收藏

描述

ALTER TABLE ... RENAME TO 语句用于重命名已有的表。重命名操作只修改元数据,不影响表中实际存储的数据。

语法

ALTER TABLE old_table_name RENAME TO new_table_name;
注意:
若目标表名已存在,SQL 执行将报错,请确保目标表名不重复。
表重命名仅变更元数据定义,不涉及底层数据的迁移或重写。

示例

创建源表并执行重命名操作

CREATE TABLE tci_rename_old (
id BIGINT NOT NULL,
name STRING
) USING tci
TBLPROPERTIES ('primary-key' = 'id');

ALTER TABLE tci_rename_old
RENAME TO tci_rename_new;

验证重命名后的表可用

DESCRIBE tci_rename_new;

INSERT INTO tci_rename_new VALUES (1, 'test');

SELECT * FROM tci_rename_new;