Schema della tabella Iceberg in evoluzione

Gli aggiornamenti dello schema Iceberg sono modifiche solo ai metadati. Nessun file di dati viene modificato quando si esegue un aggiornamento dello schema.

Il formato Iceberg supporta le seguenti modifiche all'evoluzione dello schema:

• Add (Aggiungi): aggiunge una nuova colonna a una tabella o a uno struct nidificato.

• Drop (Elimina): rimuove una colonna esistente da una tabella o uno struct nidificato.

• Rename (Rinomina): rinomina una colonna o un campo esistente in uno struct nidificato.

• Riordina: Modifica l'ordine delle colonne.

• Type promotion (Promozione del tipo): amplia il tipo di colonna, il campo struct, la chiave map, il valore map o l'elemento list. Attualmente sono supportati i seguenti casi per le tabelle Iceberg:

  • da intero a intero grande

  • da float a double

  • aumento della precisione di un tipo decimale

ALTER TABLE ADD COLUMNS

Aggiunge una o più colonne a una tabella Iceberg esistente.

Riepilogo

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

Esempi

Nell'esempio seguente viene aggiunta una colonna comment di tipo string in una tabella Iceberg.

ALTER TABLE iceberg_table ADD COLUMNS (comment string)

Nell'esempio seguente viene aggiunta una colonna point di tipo struct in una tabella Iceberg.

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

Nell'esempio seguente viene aggiunta una colonna points che è una matrice di strutture a una tabella Iceberg.

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

ALTER TABLE ADD COLUMNS

Elimina le proprietà esistenti da una tabella Iceberg.

Riepilogo

ALTER TABLE [db_name.]table_name DROP COLUMN col_name

Esempio

ALTER TABLE iceberg_table DROP COLUMN userid

ALTER TABLE CHANGE COLUMN

Modifica il nome, il tipo, l'ordine o il commento di una colonna.

Nota

ALTER TABLE REPLACE COLUMNS non è supportato. Poiché REPLACE COLUMNS rimuove tutte le colonne e ne aggiunge di nuove, non è supportata per Iceberg. CHANGE COLUMN è la sintassi preferita per l'evoluzione dello schema.

Riepilogo

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

Esempio

ALTER TABLE iceberg_table CHANGE comment blog_comment string AFTER id

SHOW COLUMNS

Mostra le colonne in una tabella.

Riepilogo

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

Esempio

SHOW COLUMNS FROM iceberg_table