Schéma évolutif de la table Iceberg

Les mises à jour du schéma Iceberg sont des modifications de métadonnées uniquement. Aucun fichier de données n'est modifié lorsque vous effectuez une mise à jour du schéma.

Le format Iceberg prend en charge les modifications suivantes de l'évolution du schéma :

• Add (Ajouter) – Ajoute une nouvelle colonne à une table ou à un struct imbriqué.

• Drop (Supprimer) – Supprime une colonne existante d'une table ou d'un struct imbriqué.

• Rename (Renommer) – Renomme une colonne ou un champ existant dans un struct imbriqué.

• Reorder (Réorganiser) – Modifie l'ordre des colonnes.

• Type promotion (Promotion de type) – Élargit le type d'une colonne, d'un champ struct, d'une clé map, d'une valeur map, ou d'un élément list. Actuellement, les cas suivants sont pris en charge pour les tables Iceberg :

  • entier à grand nombre entier

  • float à double

  • augmentation de la précision d'un type décimal

ALTER TABLE ADD COLUMNS

Ajoute une ou plusieurs colonnes à une table Iceberg existante.

Résumé

ALTER TABLE [db_name.]table_name ADD COLUMNS (col_name data_type [,...])

Exemples

L'exemple suivant ajoute une colonne comment de type string sur une table Iceberg.

ALTER TABLE iceberg_table ADD COLUMNS (comment string)

L'exemple suivant ajoute une colonne point de type struct sur une table Iceberg.

ALTER TABLE iceberg_table 
ADD COLUMNS (point struct<x: double, y: double>)

L'exemple suivant ajoute une colonne points qui est un tableau de structures à une table Iceberg.

ALTER TABLE iceberg_table 
ADD COLUMNS (points array<struct<x: double, y: double>>)

ALTER TABLE DROP COLUMN

Supprime une colonne d'une table Iceberg existante.

Résumé

ALTER TABLE [db_name.]table_name DROP COLUMN col_name

Exemple

ALTER TABLE iceberg_table DROP COLUMN userid

ALTER TABLE CHANGE COLUMN

Modifie le nom, le type, l'ordre ou le commentaire d'une colonne.

Note

ALTER TABLE REPLACE COLUMNS n’est pas pris en charge. Étant donné que REPLACE COLUMNS supprime toutes les colonnes, puis en ajoute de nouvelles, elle n'est pas prise en charge pour Iceberg. CHANGE COLUMN est la syntaxe préférée pour l'évolution du schéma.

Résumé

ALTER TABLE [db_name.]table_name
  CHANGE [COLUMN] col_old_name col_new_name column_type 
  [COMMENT col_comment] [FIRST|AFTER column_name]

Exemple

ALTER TABLE iceberg_table CHANGE comment blog_comment string AFTER id

SHOW COLUMNS

Affiche les colonnes d'un tableau.

Résumé

SHOW COLUMNS (FROM|IN) [db_name.]table_name

Exemple

SHOW COLUMNS FROM iceberg_table