大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:ALTER TABLE REPLACE

· 52CE 我爱测

如果 参数为 ,则替换后,名称为 表中的数据为原 表中的数据。而名称为 表中的数据为原 表中的数据。即两张表数据发生了互换。

描述

对两个表进行原子的替换操作。该操作仅适用于 OLAP 表。

ALTER TABLE [db.]tbl1 REPLACE WITH TABLE tbl2
[PROPERTIES('swap' = 'true')];

将表 tbl1 替换为表 tbl2。

如果 swap 参数为 true,则替换后,名称为 tbl1 表中的数据为原 tbl2 表中的数据。而名称为 tbl2 表中的数据为原 tbl1 表中的数据。即两张表数据发生了互换。

如果 swap 参数为 false,则替换后,名称为 tbl1 表中的数据为原 tbl2 表中的数据。而名称为 tbl2 表被删除。

原理

替换表功能,实际上是将以下操作集合变成一个原子操作。

假设要将表 A 替换为表 B,且 swap 为 true,则操作如下:

  1. 将表 B 重名为表 A。
  2. 将表 A 重名为表 B。

如果 swap 为 false,则操作如下:

  1. 删除表 A。
  2. 将表 B 重名为表 A。

注意事项

  1. swap 参数默认为 true。即替换表操作相当于将两张表数据进行交换。
  2. 如果设置 swap 参数为 false,则被替换的表(表 A)将被删除,且无法恢复。
  3. 替换操作仅能发生在两张 OLAP 表之间,且不会检查两张表的表结构是否一致。
  4. 替换操作不会改变原有的权限设置。因为权限检查以表名称为准。

示例

  1. 将 tbl1 与 tbl2 进行原子交换,不删除任何表(注:如果删除的话,实际上删除的是 tbl1,只是将 tbl2 重命名为 tbl1。)
ALTER TABLE tbl1 REPLACE WITH TABLE tbl2;

或

ALTER TABLE tbl1 REPLACE WITH TABLE tbl2 PROPERTIES('swap' = 'true') ;
  1. 将 tbl1 与 tbl2 进行交换,删除 tbl2 表(保留名为tbl1,数据为tbl2的表)
ALTER TABLE tbl1 REPLACE WITH TABLE tbl2 PROPERTIES('swap' = 'false') ;

关键词

ALTER, TABLE, REPLACE, ALTER TABLE

最佳实践

  1. 原子的覆盖写操作

    某些情况下,用户希望能够重写某张表的数据,但如果采用先删除再导入的方式进行,在中间会有一段时间无法查看数据。这时,用户可以先使用 CREATE TABLE LIKE 语句创建一个相同结构的新表,将新的数据导入到新表后,通过替换操作,原子的替换旧表,以达到目的。分区级别的原子覆盖写操作,请参阅 临时分区文档。

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。