ALTER TABLE SET TBLPROPERTIES - Amazon Athena

ALTER TABLE SET TBLPROPERTIES

테이블에 사용자 지정 또는 미리 정의된 메타데이터 속성을 추가하고 할당된 값을 설정합니다. 테이블의 속성을 보려면 SHOW TBLPROPERTIES 명령을 사용합니다.

Apache Hive 관리형 테이블이 지원되지 않으므로 'EXTERNAL'='FALSE' 설정은 효과가 없습니다.

시놉시스

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

파라미터

SET TBLPROPERTIES ('property_name' = 'property_value' [ , ... ])

추가할 메타데이터 속성을 property_name으로 지정하고 각각의 값을 property value로 지정합니다. property_name이 이미 존재하는 경우, 해당 값은 새로 지정된 property_value로 설정됩니다.

다음의 미리 정의된 테이블 속성은 특별한 용도로 사용됩니다.

미리 정의된 속성 설명
classification AWS Glue의 데이터 형식을 나타냅니다. 가능한 값은 csv, parquet, orc, avro 또는 json입니다. CloudTrail 콘솔에서 Athena용으로 생성된 테이블은 classification 속성 값으로 cloudtrail을 추가합니다. 자세한 내용은 CREATE TABLE의 TBLPROPERTIES 단원을 참조하세요.
has_encrypted_data LOCATION에 의해 지정된 데이터 집합이 암호화되었는지 여부를 나타냅니다. 자세한 내용은 CREATE TABLEAmazon S3의 암호화된 데이터세트에 기반한 테이블 생성의 TBLPROPERTIES 단원을 참조하세요.
orc.compress ORC 형식의 데이터에 대해 압축 형식을 지정합니다. 자세한 내용은 ORC SerDe 단원을 참조하세요.
parquet.compression Parquet 형식의 데이터에 대해 압축 형식을 지정합니다. 자세한 내용은 Parquet SerDe 단원을 참조하십시오.
write.compression 텍스트 파일 또는 JSON 형식의 데이터에 대한 압축 형식을 지정합니다. Parquet 및 ORC 형식의 경우 각각 parquet.compressionorc.compress 속성을 사용합니다.
compression_level 사용할 압축 수준을 지정합니다. 이 속성은 ZSTD 압축에만 적용됩니다. 가능한 값은 1~22입니다. 기본값은 3입니다. 자세한 내용은 ZSTD 압축 수준 사용 단원을 참조하십시오.
projection.* 파티션 프로젝션에 이러한 사용자 지정 속성을 사용하면 Athena가 테이블에서 쿼리를 실행할 때 예상되는 파티션 패턴을 알 수 있습니다. 자세한 내용은 Amazon Athena에서 파티션 프로젝션 사용 단원을 참조하세요.
skip.header.line.count 테이블을 정의할 때 데이터의 헤더를 무시합니다. 자세한 내용은 헤더 무시 단원을 참조하세요.
storage.location.template 프로젝션된 파티션에 대한 사용자 지정 Amazon S3 경로 템플릿을 지정합니다. 자세한 내용은 파티션 프로젝션 설정 단원을 참조하십시오.

예시

다음 예제에서는 테이블 속성에 주석 메모를 추가합니다.

ALTER TABLE orders SET TBLPROPERTIES ('notes'="Please don't drop this table.");

다음 예제에서는 ZSTD 압축 및 ZSTD 압축 수준 4와 함께 Parquet 파일 형식을 사용하도록 테이블 existing_table을 수정합니다.

ALTER TABLE existing_table SET TBLPROPERTIES ('parquet.compression' = 'ZSTD', 'compression_level' = 4)