Iceberg テーブルの管理

Athena は、Iceberg テーブルに対して次のテーブル DDL オペレーションをサポートしています。

ALTER TABLE RENAME

テーブル名を変更します。

Iceberg テーブルのテーブルメタデータが Simple Storage Service (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 仕様に従って、テーブルプロパティは、AWS Glue ではなく、Iceberg テーブルメタデータファイルに保存されます。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 テーブルを削除します。

警告

Athena では Iceberg テーブルがマネージドテーブルと見なされるため、Iceberg テーブルを削除すると、テーブル内のデータもすべて削除されます。

概要

DROP TABLE [IF EXISTS] [db_name.]table_name

例

DROP TABLE iceberg_table

SHOW CREATE TABLE

CREATE TABLE DDL ステートメントを表示します。Athena で Iceberg テーブルを再作成するために使用できます。Athena がテーブル構造を再現できない場合 (たとえば、テーブルにカスタムテーブルプロパティが指定されているため)、「UNSUPPORTED」(サポートされていません) というエラーがスローされます。

概要

SHOW CREATE TABLE [db_name.]table_name

例

SHOW CREATE TABLE iceberg_table

SHOW TABLE PROPERTIES

Iceberg テーブルのテーブルプロパティを 1 つ以上表示します。Athena でサポートされているテーブルプロパティのみが表示されます。

概要

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

例

SHOW TBLPROPERTIES iceberg_table