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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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 CloudTrail console sont ajoutées en cloudtrail tant que valeur à la classification propriété. 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 ensembles 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, veuillez consulter ORC SerDe.
parquet.compression Spécifie un format de compression pour les données au format Parquet. Pour de plus amples informations, veuillez consulter Parquet SerDe.
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, veuillez consulter Utiliser les 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, veuillez consulter Utiliser la projection de partitions 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, veuillez consulter 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, veuillez consulter Configuration de la projection de partitions.

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)