ALTER TABLE SET TBLPROPERTIES - Amazon Athena
RiepilogoParametriEsempi

ALTER TABLE SET TBLPROPERTIES

Aggiunge proprietà di metadati personalizzate o predefinite a una tabella e imposta i valori assegnati. Per visualizzare le proprietà in una tabella, utilizzare il comando SHOW TBLPROPERTIES.

Le tabelle gestite Apache Hive non sono supportate, quindi impostare 'EXTERNAL'='FALSE' non determina alcun effetto.

Riepilogo

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

Parametri

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

Specifica le proprietà dei metadati da aggiungere come property_name e il valore per ognuna di esse come property value. Se property_name esiste già, il suo valore è impostato sul nuovo property_value.

Le seguenti proprietà predefinite della tabella hanno usi speciali.

Proprietà predefinite Descrizione
classification Indica il tipo di dati per AWS Glue. I valori possibili sono csv, parquet, orc, avro o json. Le tabelle create per Athena nella console CloudTrail aggiungono cloudtrail come valore per la proprietà classification. Per ulteriori informazioni, consulta la sezione TBLPROPERTIES di CREATE TABLE.
has_encrypted_data Indica se il set di dati specificato da LOCATION è crittografato. Per ulteriori informazioni, consulta la sezione TBLPROPERTIES di CREATE TABLE e Creare tabelle basate su set di dati crittografati in Amazon S3.
orc.compress Specifica un formato di compressione per i dati in formato ORC. Per ulteriori informazioni, consulta ORC SerDe.
parquet.compression Specifica un formato di compressione per i dati in formato Parquet. Per ulteriori informazioni, consulta SerDe Parquet.
write.compression Specifica un formato di compressione per i dati in formato file di testo o JSON. Per i formati Parquet e ORC, utilizzare rispettivamente le proprietà parquet.compression e orc.compress.
compression_level Specifica un livello di compressione da utilizzare. Questa proprietà si applica solo alla compressione ZSTD. I valori possibili sono compresi tra 1 e 22. Il valore predefinito è 3. Per ulteriori informazioni, consulta Usa i livelli di compressione ZSTD.
projection.* Proprietà personalizzate usate nella proiezione della partizione che consentono ad Athena di sapere quali modelli di partizione aspettarsi quando viene eseguita una query sulla tabella. Per ulteriori informazioni, consulta Proiezione delle partizioni con Amazon Athena.
skip.header.line.count Ignora le intestazioni nei dati quando si definisce una tabella. Per ulteriori informazioni, consulta Ignorare intestazioni.
storage.location.template Specifica un modello di percorso Amazon S3 personalizzato per le partizioni proiettate. Per ulteriori informazioni, consulta proiezione delle partizioni configurata.

Esempi

Nell'esempio seguente viene aggiunto un commento alle proprietà della tabella.

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

L'esempio seguente modifica la tabella existing_table per utilizzare il formato file Parquet con compressione ZSTD e livello di compressione ZSTD 4.

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