在Amazon Athena中对Apache Iceberg v2表执行VACUUM/OPTIMIZE报错求助

核心原因：Athena引擎版本不兼容 #

Athena对Iceberg的OPTIMIZE和VACUUM操作仅支持引擎版本3，如果你的查询使用旧版本（比如引擎2），就会出现这类语法不识别的错误。

解决步骤 #

1. 切换到Athena引擎版本3 #

执行语句前先设置引擎版本：

SET engine_version = 3;

也可以在Athena控制台查询编辑器的右上角，通过「引擎版本」下拉菜单直接选择版本3。

2. 修正OPTIMIZE语句语法 #

原语句中WHERE catalog = 'my_catalog'的写法错误，需直接指定完整表名，或先切换到对应catalog后操作：

-- 方式1：使用完整表名
OPTIMIZE my_catalog.my_database.my_table REWRITE DATA USING BIN_PACK;

-- 方式2：先切换catalog再操作
USE my_catalog.my_database;
OPTIMIZE my_table REWRITE DATA USING BIN_PACK;

3. 修正VACUUM语句语法 #

同样需指定完整表名，或先切换到对应catalog/database：

-- 方式1：使用完整表名
VACUUM my_catalog.my_database.my_table;

-- 方式2：切换后操作
USE my_catalog.my_database;
VACUUM my_table;

额外验证点 #

你的Iceberg表已设置format-version = '2'，且vacuum_max_snapshot_age_seconds参数（28天）符合Athena要求，这部分无需调整。

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