VACUUM

La instrucción VACUUM realiza el mantenimiento de las tablas de Apache Iceberg al eliminar los archivos de datos que ya no se necesitan.

nota

VACUUM es transaccional y solo es compatible con las tablas de Apache Iceberg en la versión 3 del motor Athena.

Sinopsis

Para eliminar los archivos de datos que ya no se necesitan para una tabla de Iceberg, use la siguiente sintaxis.

VACUUM target_table

Se recomienda ejecutar la instrucción VACUUM en las tablas de Iceberg para eliminar los archivos de datos que ya no sean relevantes y reducir el tamaño de los metadatos y el consumo de almacenamiento. Tenga en cuenta que, debido a que la instrucción VACUUM realiza llamadas de API a Amazon S3, se aplican cargos por las solicitudes asociadas a Amazon S3.

aviso

Si ejecuta una operación de vencimiento de instantáneas, ya no podrá viajar en el tiempo a instantáneas vencidas.

VACUUM lleva a cabo las siguientes operaciones:

• Elimina las instantáneas que tengan una antigüedad superior a la cantidad de tiempo especificada en la propiedad de la tabla vacuum_max_snapshot_age_seconds. De forma predeterminada, esta propiedad se establece en 432 000 segundos (5 días).

• Elimina las instantáneas que no estén dentro del periodo de conservación y que superen el número especificado en la propiedad de la tabla vacuum_min_snapshots_to_keep. El valor predeterminado de es 1.

  Puede especificar estas propiedades de la tabla en su instrucción CREATE TABLE. Después de crear la tabla, se puede usar la instrucción ALTER TABLE SET PROPERTIES para actualizarla.

• Elimina los metadatos y los archivos de datos a los que no se pueda acceder como resultado de la eliminación de la instantánea. Puede configurar la cantidad de archivos de metadatos antiguos que se van a retener al configurar la propiedad de la tabla vacuum_max_metadata_files_to_keep. El valor predeterminado es 100.

• Elimina los archivos huérfanos que tienen una antigüedad superior al tiempo especificado en la propiedad de la tabla vacuum_max_snapshot_age_seconds. Los archivos huérfanos son archivos del directorio de datos de la tabla que no forman parte del estado de la tabla.

Para obtener más información acerca de la creación y administración de tablas de Apache Iceberg en Athena, consulte Creación de tablas de Iceberg y Administración de tablas de Iceberg.