Caducidad de registros para tablas

De forma predeterminada, los registros de las tablas de S3 no caducan. Para ayudarlo a minimizar los costos de almacenamiento de las tablas, puede habilitar y configurar la caducidad de los registros de las tablas. Con esta opción, Amazon S3 elimina automáticamente los registros de una tabla cuando los registros caducan.

Si habilita la caducidad de los registros de una tabla, debe especificar el número de días que se retendrán en la tabla antes de que caduquen. Puede ser cualquier número de días, desde 1 día hasta 2 147 483 647 días. Por ejemplo, para retener los registros de la tabla durante un año, especifique 365 días. A continuación, los registros persisten durante 365 días. Después de 365 días, los registros caducan y Amazon S3 los elimina automáticamente.

Puede habilitar y configurar la caducidad de los registros para las tablas administradas de AWS que almacenan conjuntos de datos específicos de determinados Servicios de AWS, actualmente Lente de almacenamiento de Amazon S3 y catálogo de Amazon SageMaker. Las opciones de caducidad de los registros no están disponibles actualmente para otras tablas administradas de AWS. La excepción son las tablas de diario de metadatos de Amazon S3. Las tablas de diario utilizan distintas configuraciones de caducidad de registros que se especifican por servicio. Para obtener información sobre cómo configurar la caducidad de los registros para este tipo de tabla, consulte Caducidad de los registros de la tabla de diario. Tenga en cuenta que las opciones de caducidad de los registros no están disponibles para las tablas de S3 que cree.

Después de habilitar la caducidad de los registros de una tabla, puede desactivarla en cualquier momento. Amazon S3 deja de caducar y de eliminar registros de la tabla.

Cómo funciona la caducidad de los registros

La caducidad de los registros elimina automáticamente los registros de una tabla de S3 cuando son anteriores al número de días especificado en la configuración de caducidad de los registros de la tabla. Para determinar cuándo caducan los registros, Amazon S3 utiliza marcas temporales específicas en los registros. La elección de la columna de marca temporal se deriva directamente del esquema de una tabla. No es necesario especificar qué columna de marca temporal utilizar. Las tablas las administra AWS y Amazon S3 elige automáticamente la columna adecuada para utilizarla cuando se habilita la caducidad de los registros de una tabla.

Puede habilitar y configurar los ajustes de caducidad de los registros para las tablas administradas de AWS que almacenan métricas de Lente de almacenamiento de Amazon S3 o metadatos de catálogo de Amazon SageMaker específicos. Las opciones de caducidad de los registros están disponibles para las siguientes tablas administradas de AWS para esos servicios:

Tras habilitar la caducidad de registros para una tabla, Amazon S3 comienza a ejecutar trabajos de caducidad de registros que realizan las siguientes operaciones para la tabla:

La eliminación también se basa en la caducidad de la instantánea y en los ajustes de eliminación de archivos no referenciados incluidos en la configuración de mantenimiento de la tabla. Para obtener más información sobre estas configuración, consulte Mantenimiento de tablas.

Configuración de la caducidad de los registros de una tabla

Puede habilitar, configurar y administrar de otro modo la configuración de caducidad de los registros de una tabla de S3 mediante la consola de Amazon S3, la API de REST de Amazon S3, AWS Command Line Interface (AWS CLI) o los AWS SDK.

Antes de intentar realizar estas tareas para una tabla, asegúrese de que tiene los siguientes permisos de AWS Identity and Access Management (IAM):

En las siguientes secciones se explica cómo habilitar, configurar y desactivar los ajustes de caducidad de registros de una tabla mediante la consola de Amazon S3 y la AWS CLI. Para realizar estas tareas con la API de REST de Amazon S3 o un AWS SDK, utilice la operación PutTableRecordExpirationConfiguration. Para obtener más información, consulte Desarrollo con Amazon S3 en la Referencia de la API de Amazon Simple Storage Service.

{
    "status": "enabled",
        "settings": {
            "days": 30
        {
}

{
    "status": "disabled"
}

aws s3tables put-table-record-expiration-configuration \
    --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table \
    --value file://./record-expiration-config.json

Supervisión de la caducidad de los registros de una tabla

Para supervisar el estado y los resultados de las operaciones de caducidad de los registros de las tablas de S3, utilice la operación GetTableRecordExpirationJobStatus o, si utiliza la AWS CLI, ejecute el comando get-table-record-expiration-job-status. En la solicitud, especifique el nombre de recurso de Amazon (ARN) de la tabla.

Por ejemplo, el comando AWS CLI siguiente recupera el estado de las operaciones de caducidad de los registros de una tabla específica de un bucket de tablas. Para utilizar este ejemplo, sustituya user input placeholders por su propia información.

aws s3tables get-table-record-expiration-job-status \
    --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table

Si la solicitud es correcta, recibirá una respuesta con detalles como la última vez que Amazon S3 ejecutó operaciones de caducidad de registros para la tabla y el estado de esa ejecución. Si la ejecución más reciente se realizó correctamente, la respuesta también incluye métricas de procesamiento, por ejemplo, el número de archivos de datos y registros que se eliminaron y el tamaño total de los datos que se eliminaron. Si se produjeron errores durante la ejecución más reciente, la respuesta incluye un mensaje de error que describe el motivo del error en la ejecución.

Consideraciones

Al configurar y administrar los ajustes de caducidad de los registros de las tablas de S3 administradas de AWS, tenga en cuenta lo siguiente: