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 建立的表格會新增cloudtrail為classification屬性的值。如需詳細資訊，請參閱 CREATE TABLE 的 TBLPROPERTIES 章節。
has_encrypted_data 指出 LOCATION 指定的資料集是否已加密。如需詳細資訊，請參閱CREATE TABLE和根據 Amazon S3 中的加密資料集建立資料表的 TBLPROPERTIES 章節。
orc.compress 以 ORC 格式指定資料的壓縮格式。如需詳細資訊，請參閱 ORC SerDe。
parquet.compression 指定 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.");

下列範例會修改資料表 existing_table，以使用具有 ZSTD 壓縮和 ZSTD 壓縮級別 4 的 Parquet 檔案格式。

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