Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

管理 Iceberg 表

Athena 支持对 Iceberg 表执行以下表 DDL 操作。

ALTER TABLE RENAME

重命名表。

由于 Iceberg 表的表元数据存储在 Amazon S3 中，因此您可以更新 Iceberg 托管式表的数据库和表名，而不会影响底层表信息。

摘要

ALTER TABLE [db_name.]table_name RENAME TO [new_db_name.]new_table_name

示例

ALTER TABLE my_db.my_table RENAME TO my_db2.my_table2

ALTER TABLE SET PROPERTIES

向 Iceberg 表中添加属性并设置它们的分配值。

根据 Iceberg 规范，表属性存储在 Iceberg 表元数据文件中，而不是存储在 Amazon Glue 中。Athena 不接受自定义表属性。请参阅 表属性 部分，了解允许的键值对。如果您希望 Athena 支持特定的开源表配置属性，请将反馈发送至 athena-feedback@amazon.com。

摘要

ALTER TABLE [db_name.]table_name SET TBLPROPERTIES ('property_name' = 'property_value' [ , ... ])

示例

ALTER TABLE iceberg_table SET TBLPROPERTIES (
  'format'='parquet',
  'write_compression'='snappy',
  'optimize_rewrite_delete_file_threshold'='10'
)

ALTER TABLE UNSET PROPERTIES

从 Iceberg 表中删除现有属性。

摘要

ALTER TABLE [db_name.]table_name UNSET TBLPROPERTIES ('property_name' [ , ... ])

示例

ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write_compression')

DESCRIBE TABLE

描述表格信息。

摘要

DESCRIBE [FORMATTED] [db_name.]table_name

指定 FORMATTED 选项后，输出将显示其他信息（如表位置和属性）。

示例

DESCRIBE iceberg_table

DROP TABLE

删除 Iceberg 表。

摘要

DROP TABLE [IF EXISTS] [db_name.]table_name

示例

DROP TABLE iceberg_table

SHOW CREATE TABLE

显示可用于在 Athena 中重新创建 Iceberg 表的 CREATE TABLE DDL 语句。如果 Athena 无法重现表结构（例如，由于在表中指定了自定义表属性），则将引发不支持错误。

摘要

SHOW CREATE TABLE [db_name.]table_name

示例

SHOW CREATE TABLE iceberg_table

SHOW TABLE PROPERTIES

显示 Iceberg 表的一个或多个表属性。仅显示 Athena 支持的表属性。

摘要

SHOW TBLPROPERTIES [db_name.]table_name [('property_name')]

示例

SHOW TBLPROPERTIES iceberg_table