ALTER TABLE SET TBLPROPERTIES - Amazon Athena
RiepilogoParametersEsempi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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' [ , ... ])

Parameters

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 Description
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 CloudTrail console vengono aggiunte cloudtrail come valore per la classification proprietà. Per ulteriori informazioni, consulta la sezione TBLPROPERTIES di CREATE TABLE.
has_encrypted_data Indica se il set di dati specificato da LOCATION è crittografato con CSE-KMS. Per ulteriori informazioni, consulta la sezione TBLPROPERTIES di CREATE TABLE e Creare tabelle basate su set di dati crittografati in Amazon S3.
encryption_option Indica il livello massimo di crittografia utilizzato nel set di dati sottostante specificato da. LOCATION Per ulteriori informazioni, consulta la sezione TBLPROPERTIES di CREATE TABLE e Creare tabelle basate su set di dati crittografati in Amazon S3.
kms_key Indica l'ARN della chiave AWS KMS utilizzata per crittografare e decrittografare i file di dati SSE-KMS o CSE-KMS nel set di dati sottostante specificato da. LOCATION 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 ORCO SerDe.
parquet.compression Specifica un formato di compressione per i dati in formato Parquet. Per ulteriori informazioni, consulta Parquet SerDe.
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)