Gerenciar tabelas Iceberg

O Athena oferece suporte às operações DDL a seguir para tabelas Iceberg.

ALTER TABLE RENAME

Renomeia uma tabela.

Como os metadados de uma tabela Iceberg são armazenados no Amazon S3, você pode atualizar o banco de dados e o nome da tabela de uma tabela Iceberg gerenciada sem afetar as informações de tabela subjacentes.

Resumo

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

Exemplo

ALTER TABLE my_db.my_table RENAME TO my_db2.my_table2

ALTER TABLE SET PROPERTIES

Adiciona propriedades a uma tabela Iceberg e define os valores atribuídos a elas.

De acordo com as especificações do Iceberg, as propriedades de tabela são armazenadas no arquivo de metadados da tabela Iceberg, e não em AWS Glue. O Athena não aceita propriedades de tabela personalizadas. Consulte a seção Propriedade das tabelas para ver os pares de chave-valor permitidos. Se você quiser que o Athena suporte uma propriedade específica de configuração de tabela de código aberto, envie comentários para [e-mail].

Resumo

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

Exemplo

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

ALTER TABLE UNSET PROPERTIES

Descarta as propriedades existentes de uma tabela Iceberg.

Resumo

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

Exemplo

ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write_compression')

DESCRIBE TABLE

Descreve informações da tabela.

Resumo

DESCRIBE [FORMATTED] [db_name.]table_name

Quando a opção FORMATTED é especificada, a saída exibe informações adicionais, como localização e propriedades da tabela.

Exemplo

DESCRIBE iceberg_table

DESCARTAR TABELA

Descarta uma tabela Iceberg.

Atenção

Como as tabelas Iceberg são consideradas tabelas gerenciadas no Athena, descartar uma tabela Iceberg remove todos os dados na tabela.

Resumo

DROP TABLE [IF EXISTS] [db_name.]table_name

Exemplo

DROP TABLE iceberg_table

SHOW CREATE TABLE

Exibe uma declaração DDL CREATE TABLE que pode ser usada para recriar a tabela Iceberg no Athena. Se o Athena não puder reproduzir a estrutura da tabela (por exemplo, quando a tabela tiver propriedades personalizadas especificadas), um erro UNSUPPORTED (NÃO SUPORTADO) será gerado.

Resumo

SHOW CREATE TABLE [db_name.]table_name

Exemplo

SHOW CREATE TABLE iceberg_table

SHOW TABLE PROPERTIES

Mostra uma ou mais propriedades de uma tabela Iceberg. Somente as propriedades de tabela compatíveis com o Athena são mostradas.

Resumo

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

Exemplo

SHOW TBLPROPERTIES iceberg_table