Gestion des tables Iceberg

Athena prend en charge les opérations DDL de table suivantes pour les tables Iceberg.

ALTER TABLE RENAME

Renomme une table.

Étant donné que les métadonnées de table d'une table Iceberg sont stockées dans Simple Storage Service (Amazon S3), vous pouvez mettre à jour la base de données et le nom de la table d'une table gérée Iceberg sans affecter les informations de table sous-jacentes.

Résumé

ALTER TABLE [db_name.]table_name RENAME TO [new_db_name.]new_table_name

Exemple

ALTER TABLE my_db.my_table RENAME TO my_db2.my_table2

ALTER TABLE SET PROPERTIES

Ajoute des propriétés à une table Iceberg et définit les valeurs qui leur sont attribuées.

Conformément aux spécifications Iceberg, les propriétés de la table sont stockées dans le fichier de métadonnées de la table Iceberg plutôt que dans AWS Glue. Athena n'accepte pas les propriétés de table personnalisées. Reportez-vous à la section Propriétés de la table en ce qui concerne les paires clé-valeur autorisées. Si vous souhaitez qu'Athena prenne en charge une propriété de configuration de table open source spécifique, envoyez vos commentaires à [e-mail].

Résumé

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

Exemple

ALTER TABLE iceberg_table SET TBLPROPERTIES (
  'format'='parquet',
  'write_compression'='snappy',
  'optimize_rewrite_delete_file_threshold'='10'
)

ALTER TABLE UNSET PROPERTIES

Supprime les propriétés existantes d'une table Iceberg.

Résumé

ALTER TABLE [db_name.]table_name UNSET TBLPROPERTIES ('property_name' [ , ... ])

Exemple

ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write_compression')

DESCRIBE TABLE

Décrit les informations du tableau.

Résumé

DESCRIBE [FORMATTED] [db_name.]table_name

Lorsque l'option FORMATTED est spécifiée, la sortie affiche des informations supplémentaires telles que l'emplacement de la table et les propriétés.

Exemple

DESCRIBE iceberg_table

DROP TABLE

Supprime une table Iceberg.

Avertissement

Étant donné que les tables Iceberg sont considérées comme des tables gérées dans Athena, la suppression d'une table Iceberg supprime également toutes les données de la table.

Résumé

DROP TABLE [IF EXISTS] [db_name.]table_name

Exemple

DROP TABLE iceberg_table

SHOW CREATE TABLE

Affiche une instruction DDL CREATE TABLE qui peut être utilisée pour recréer la table Iceberg dans Athena. Si Athena ne peut pas reproduire la structure de la table (par exemple, parce que les propriétés de table personnalisées sont spécifiées dans la table), une erreur UNSUPPORTED (NON PRIS EN CHARGE) est générée.

Résumé

SHOW CREATE TABLE [db_name.]table_name

Exemple

SHOW CREATE TABLE iceberg_table

SHOW TABLE PROPERTIES

Affiche une ou plusieurs propriétés de table d'une table Iceberg. Seules les propriétés de table prises en charge par Athena s'affichent.

Résumé

SHOW TBLPROPERTIES [db_name.]table_name [('property_name')]

Exemple

SHOW TBLPROPERTIES iceberg_table