ALTER TABLE SET TBLPROPERTIES - Amazon Athena
RésuméParamètresExemples

ALTER TABLE SET TBLPROPERTIES

Ajoute des propriétés de métadonnées personnalisées ou prédéfinies à une table et définit les valeurs qui leur sont attribuées. Pour afficher les propriétés d'une table, utilisez la commande SHOW TBLPROPERTIES.

Les Tables gérées par Apache Hive ne sont pas prises en charge, le paramètre 'EXTERNAL'='FALSE' n'a donc aucun effet.

Résumé

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

Paramètres

SET TBLPROPERTIES ('nom_propriété' = 'valeur_propriété' [ , ... ])

Spécifie les propriétés de métadonnées à ajouter en tant que property_name et la valeur pour chacune d'entre elles en tant que property value. Si property_name existe déjà, sa valeur est définie sur la valeur property_value nouvellement spécifiée.

Les propriétés de table prédéfinies suivantes ont des utilisations spéciales.

Propriété prédéfinie Description
classification Indique le type de données pour AWS Glue. Les valeurs possibles sont csv, parquet, orc, avro ou json. Les tables créées pour Athena dans la console CloudTrail ajoutent cloudtrail comme valeur pour la propriété classification. Pour plus d'informations, voir la section TBLPROPERTIES de CREATE TABLE.
has_encrypted_data Indique si le jeu de données spécifié par LOCATION est chiffré. Pour plus d'informations, voir la section TBLPROPERTIES de CREATE TABLE et Création de tables basées sur des jeux de données chiffrés dans Amazon S3.
orc.compress Spécifie un format de compression pour les données au format ORC. Pour de plus amples informations, consultez SerDe ORC.
parquet.compression Spécifie un format de compression pour les données au format Parquet. Pour de plus amples informations, consultez SerDe Parquet.
write.compression Spécifie un format de compression pour les données au format JSON ou fichier texte. Pour les formats Parquet et ORC, utilisez les propriétés parquet.compression et orc.compress, respectivement.
compression_level Spécifie le niveau de compression à utiliser. Cette propriété s’applique uniquement à la compression ZSTD. Les valeurs possibles sont comprises entre 1 et 22. La valeur par défaut est 3. Pour de plus amples informations, consultez Utilisation des niveaux de compression ZSTD.
projection.* Propriétés personnalisées utilisées dans la projection de partition qui permettent à Athena de savoir à quels modèles de partition s'attendre lorsqu'il exécute une requête sur une table. Pour de plus amples informations, consultez Utilisation de la projection de partition avec Amazon Athena.
skip.header.line.count Ignore les en-têtes dans les données lorsque vous définissez une table. Pour de plus amples informations, consultez Omission des en-têtes.
storage.location.template Spécifie un modèle de chemin Simple Storage Service (Amazon S3) personnalisé pour les partitions projetées. Pour de plus amples informations, consultez Configuration de la projection de partition.

Exemples

L’exemple suivant ajoute une note de commentaire aux propriétés de la table.

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

L’exemple suivant modifie la table existing_table pour utiliser le format de fichier Parquet avec une compression ZSTD et un niveau de compression ZSTD 4.

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