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 Simple Storage Service (Amazon S3).
orc.compress	Spécifie un format de compression pour les données au format ORC. Pour plus d’informations, consultez ORC SerDe.
parquet.compression	Spécifie un format de compression pour les données au format Parquet. Pour plus d’informations, consultez 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 plus d’informations, consultez Utilisation des niveaux de compression ZSTD dans Athena.
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 plus d’informations, consultez 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 plus d’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 plus d’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)