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 TABLE 및 Amazon S3의 암호화된 데이터세트에 기반한 테이블 생성의 TBLPROPERTIES 단원을 참조하세요.orc.compress
ORC 형식의 데이터에 대해 압축 형식을 지정합니다. 자세한 내용은 ORC SerDe 단원을 참조하세요. parquet.compression
Parquet 형식의 데이터에 대해 압축 형식을 지정합니다. 자세한 내용은 Parquet SerDe 단원을 참조하십시오. write.compression
텍스트 파일 또는 JSON 형식의 데이터에 대한 압축 형식을 지정합니다. Parquet 및 ORC 형식의 경우 각각 parquet.compression
및orc.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)