# Iceberg 테이블 관리 Athena는 Iceberg 테이블에 관한 다음 테이블 DDL 작업을 지원합니다. **Topics** + [ALTER TABLE RENAME](querying-iceberg-alter-table-rename.md) + [ALTER TABLE SET TBLPROPERTIES](querying-iceberg-alter-table-set-properties.md) + [ALTER TABLE UNSET TBLPROPERTIES](querying-iceberg-alter-table-unset-properties.md) + [DESCRIBE](querying-iceberg-describe-table.md) + [DROP TABLE](querying-iceberg-drop-table.md) + [SHOW CREATE TABLE](querying-iceberg-show-create-table.md) + [SHOW TBLPROPERTIES](querying-iceberg-show-table-properties.md) # 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 TBLPROPERTIES Iceberg 테이블에 속성을 추가하고 할당된 값을 설정합니다. [Iceberg 사양](https://iceberg.apache.org/#spec/#table-metadata-fields)에 따라 테이블 속성은 AWS Glue가 아닌 Iceberg 테이블 메타데이터 파일에 저장됩니다. Athena는 사용자 정의 테이블 속성을 허용하지 않습니다. 허용되는 키-값 페어는 [테이블 속성 지정](querying-iceberg-creating-tables.md#querying-iceberg-table-properties) 섹션을 참조하세요. 또한 `ALTER TABLE SET TBLPROPERTIES`와 `ALTER TABLE UNSET TBLPROPERTIES`를 사용하여 Iceberg 테이블 속성인 `write.data.path`와 `write.object-storage.path`를 설정하거나 제거할 수 있습니다. Athena가 특정 오픈 소스 테이블 구성 속성을 지원하도록 하려면 [athena-feedback@amazon.com](mailto: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' ) ``` 다음 예제에서는 기존 Iceberg 테이블에 `write.data.path` 속성을 설정합니다. ``` ALTER TABLE iceberg_table SET TBLPROPERTIES ( 'write.data.path'='s3://amzn-s3-demo-bucket/your-folder/data' ) ``` # ALTER TABLE UNSET TBLPROPERTIES Iceberg 테이블에서 기존 속성을 삭제합니다. ## 시놉시스 ``` ALTER TABLE [db_name.]table_name UNSET TBLPROPERTIES ('property_name' [ , ... ]) ``` ## 예제 ``` ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write_compression') ``` 다음 예제에서는 Iceberg 테이블에서 `write.data.path` 속성을 제거합니다. ``` ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write.data.path') ``` # DESCRIBE 테이블 정보를 설명합니다. ## 시놉시스 ``` 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 TBLPROPERTIES Iceberg 테이블의 하나 이상의 테이블 속성을 표시합니다. Athena에서 지원되는 테이블 속성만 표시됩니다. ## 시놉시스 ``` SHOW TBLPROPERTIES [db_name.]table_name [('property_name')] ``` ## 예제 ``` SHOW TBLPROPERTIES iceberg_table ```