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 사양에 따라 테이블 속성은 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 테이블을 삭제합니다.

주의

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