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
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