管理 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 資料表中繼資料檔案中，而不是儲存在 AWS Glue中。Athena 不接受自訂資料表屬性。有關允許使用的鍵值對，請參閱 資料表屬性 部分。如果您希望 Athena 支援特定的開放原始碼資料表組態屬性，請將意見回饋傳送至 [e-mail]。

概要

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 資料表。

警告

因為 Iceberg 資料表在 Athena 中被視為受管資料表，因此捨棄 Iceberg 資料表也會刪除資料表中的所有資料。

概要

DROP TABLE [IF EXISTS] [db_name.]table_name

範例

DROP TABLE iceberg_table

SHOW CREATE TABLE

顯示可用於在 Athena 中重新建立 Iceberg 資料表的 CREATE TABLE DDL 陳述式。如果 Athena 無法重現資料表結構 (例如，由於在資料表中指定了自訂資料表屬性)，則會擲回 UNSUPPORTED (不受支援的) 錯誤。

概要

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