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」の「TBLPROPERITERS」セクションを参照してください。
has_encrypted_data LOCATION によって指定されたデータセットが暗号化されているかどうかを示します。詳細については、「CREATE TABLE」の「TBLPROPERITERS」セクション、および「Amazon S3 内の暗号化されたデータセットに基づいてテーブルを作成する」を参照してください。
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.");

次の例では、テーブル existing_table を変更して、ZSTD 圧縮および ZSTD 圧縮レベル 4 の Parquet ファイル形式を使用します。

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