通过Spark迁移Hive表至Iceberg表时遭遇AnalysisException错误

这个AnalysisException的本质原因是：Hive/Spark禁止通过ALTER TABLE直接修改表的storage_handler属性，这个限制是为了防止元数据与底层存储数据的格式不匹配，避免引发数据损坏或读取异常。

storage_handler是表的核心元数据，它定义了表依赖的存储引擎（比如原生Hive存储、Iceberg存储）。这个属性在表创建时就已确定，后期修改会破坏元数据与实际存储的一致性：

• 原Hive表的存储格式（如ORC/Parquet）与Iceberg的分层存储结构完全不同
• 直接修改storage_handler后，系统无法自动完成底层数据的格式转换，会导致元数据指向的存储引擎与实际数据不兼容

你执行的SQL试图直接替换存储引擎，违反了Hive/Spark对核心表属性的保护机制，因此触发了该错误。

正确的迁移方式 #

你需要通过数据迁移的方式完成Hive表到Iceberg表的转换，比如：

1. 创建新的Iceberg表并同步数据

-- 创建与原表结构一致的Iceberg表
CREATE TABLE mytable_iceberg
USING iceberg
TBLPROPERTIES ('format-version'='2')
AS SELECT * FROM mytable;

-- 可选：替换原表
DROP TABLE mytable;
ALTER TABLE mytable_iceberg RENAME TO mytable;

2. 若使用支持Iceberg迁移的Hive环境，可使用官方迁移命令：

ALTER TABLE mytable SET TBLPROPERTIES ('iceberg.migrate'='true');

内容的提问来源于stack exchange，提问作者Hanuman95