Gestione di tabelle Iceberg

Athena supporta le seguenti operazioni DDL della tabella per le tabelle Iceberg.

ALTER TABLE RENAME

Rinominare una tabella

Poiché i metadati della tabella di una tabella Iceberg sono archiviati in Amazon S3, è possibile aggiornare il database e il nome della tabella gestita da Iceberg senza influire sulle informazioni della tabella sottostante.

Riepilogo

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

Esempio

ALTER TABLE my_db.my_table RENAME TO my_db2.my_table2

ALTER TABLE SET PROPERTIES

Aggiunge proprietà a una tabella Iceberg e imposta i relativi valori assegnati.

In conformità con le specifiche Iceberg, le proprietà della tabella sono archiviate nel file di metadati della tabella Iceberg anziché in AWS Glue. Athena non accetta proprietà personalizzate della tabella. Consulta la sezione Proprietà tabella per le coppie chiave-valore consentite. Se si desidera che Athena supporti una specifica proprietà di configurazione della tabella open source, inviare un feedback all'indirizzo [e-mail].

Riepilogo

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

Esempio

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

ALTER TABLE UNSET PROPERTIES

Elimina le proprietà esistenti da una tabella Iceberg.

Riepilogo

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

Esempio

ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write_compression')

DESCRIBE TABLE

Descrive le informazioni della tabella.

Riepilogo

DESCRIBE [FORMATTED] [db_name.]table_name

Quando l'opzione FORMATTED è specificata, l'output visualizza informazioni aggiuntive come la posizione della tabella e le proprietà.

Esempio

DESCRIBE iceberg_table

DROP TABLE

Elimina una tabella Iceberg.

avvertimento

Poiché le tabelle Iceberg sono considerate tabelle gestite in Athena, l'eliminazione di una tabella Iceberg rimuove tutti i dati anche dalla tabella.

Riepilogo

DROP TABLE [IF EXISTS] [db_name.]table_name

Esempio

DROP TABLE iceberg_table

SHOW CREATE TABLE

Visualizza un'istruzione DDL CREATE TABLE che può essere utilizzata per ricreare la tabella Iceberg in Athena. Se Athena non è in grado di riprodurre la struttura della tabella (ad esempio, poiché nella tabella sono specificate proprietà personalizzate), viene generato un errore NON SUPPORTATO.

Riepilogo

SHOW CREATE TABLE [db_name.]table_name

Esempio

SHOW CREATE TABLE iceberg_table

SHOW TABLE PROPERTIES (MOSTRA PROPRIETÀ TABELLA)

Mostra una o più proprietà della tabella di una tabella Iceberg. Vengono visualizzate solo le proprietà della tabella supportate da Athena.

Riepilogo

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

Esempio

SHOW TBLPROPERTIES iceberg_table