Administración de tablas de Iceberg

Athena admite las siguientes operaciones de DDL de una tabla para tablas de Iceberg.

ALTER TABLE RENAME

Cambia el nombre de una tabla.

Dado que los metadatos de tabla de una tabla de Iceberg se almacenan en Simple Storage Service (Amazon S3), puede actualizar la base de datos y el nombre de la tabla de una tabla administrada de Iceberg sin afectar a la información subyacente de la tabla.

Sinopsis

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

Ejemplo

ALTER TABLE my_db.my_table RENAME TO my_db2.my_table2

ALTER TABLE SET PROPERTIES

Agrega propiedades a una tabla de Iceberg y establece sus valores asignados.

De acuerdo con las especificaciones de Iceberg, las propiedades de la tabla se almacenan en el archivo de metadatos de la tabla de Iceberg en lugar de en el AWS Glue. Athena no acepta propiedades de tabla personalizadas. Consulte la sección Propiedades de la tabla para conocer los pares clave-valor permitidos. Si desea que Athena incluya compatibilidad con una propiedad de configuración de tabla específica de código abierto, envíe sus comentarios a [e-mail].

Sinopsis

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

Ejemplo

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

ALTER TABLE UNSET PROPERTIES

Esto descarta las propiedades existentes de una tabla de Iceberg.

Sinopsis

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

Ejemplo

ALTER TABLE iceberg_table UNSET TBLPROPERTIES ('write_compression')

DESCRIBE TABLE

Describe información de la tabla.

Sinopsis

DESCRIBE [FORMATTED] [db_name.]table_name

Cuando se especifica la opción FORMATTED, la salida muestra información adicional, como la ubicación y las propiedades de la tabla.

Ejemplo

DESCRIBE iceberg_table

DROP TABLE

Esto descarta una tabla de Iceberg.

aviso

Dado que las tablas de Iceberg se consideran tablas administradas en Athena, cuando se descarta una tabla Iceberg también se eliminan todos los datos de la tabla.

Sinopsis

DROP TABLE [IF EXISTS] [db_name.]table_name

Ejemplo

DROP TABLE iceberg_table

SHOW CREATE TABLE

Se muestra la instrucción DDL CREATE TABLE que se puede utilizar para recrear la tabla de Iceberg en Athena. Si Athena no puede reproducir la estructura de la tabla (por ejemplo, porque las propiedades de tabla personalizadas se especifican en la tabla), se genera el error UNSUPPORTED.

Sinopsis

SHOW CREATE TABLE [db_name.]table_name

Ejemplo

SHOW CREATE TABLE iceberg_table

MOSTRAR LAS PROPIEDADES DE LA TABLA

Se muestra una o más propiedades de tabla de una tabla de Iceberg. Solo se muestran las propiedades de tabla compatibles con Athena.

Sinopsis

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

Ejemplo

SHOW TBLPROPERTIES iceberg_table