Amazon Athena创建Apache Iceberg表报错，请求排查SQL语句问题

错误原因 #

Athena中创建Apache Iceberg表的语法与传统Hive表存在差异，你使用的PARTITIONED BY子句不符合Iceberg表的创建规范，这是导致语法错误的直接原因。Iceberg表在Athena中要求通过表属性定义分区策略，而非直接使用PARTITIONED BY关键字。

修正后的SQL语句 #

你可以通过以下两种正确写法创建Iceberg表：

写法1：使用TBLPROPERTIES定义分区 #

CREATE TABLE iceberg_table (id int, data string, category string)
LOCATION 's3://xxxxxxxx/iceberg_table/'
TBLPROPERTIES (
        'table_type' = 'ICEBERG',
        'format' = 'parquet',
        'write_target_data_file_size_bytes' = '536870912',
        'partitioning' = '["category", "bucket(16, id)"]'
);

写法2：使用WITH子句（推荐） #

CREATE TABLE iceberg_table (id int, data string, category string)
LOCATION 's3://xxxxxxxx/iceberg_table/'
WITH (
  table_type = 'ICEBERG',
  format = 'parquet',
  write_target_data_file_size_bytes = 536870912,
  partitioning = ARRAY['category', 'bucket(16, id)']
);

关键说明 #

• Iceberg表的分区策略必须通过partitioning表属性定义，支持字段分区、桶分区等多种策略，格式为字符串数组（写法1）或数组类型（写法2）。
• 原语句中的PARTITIONED BY是Hive表的语法，不适用于Athena Iceberg表，因此会触发语法解析错误。
• Iceberg cannot found the requested entity错误是由于语法错误导致表创建失败，后续操作无法找到对应实体，修正语法后该错误会自动解决。

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