Tiempo de vida (TTL) duración de los registros - Amazon SageMaker

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Tiempo de vida (TTL) duración de los registros

Amazon SageMaker Feature Store ofrece la opción de eliminar de forma definitiva los registros de la tienda en línea una vez transcurrido un tiempo, con el tiempo de vida (TTL) duration (TtlDuration). El registro caducará cuando se alcance el EventTime más TtlDuration del registro, o ExpiresAt = EventTime + TtlDuration. La TtlDuration se puede aplicar a nivel de grupo de características, donde todos los registros del grupo de características tendrán la TtlDuration de forma predeterminada, o a nivel de registro individual. Si no se especifica la TtlDuration, el valor predeterminado es null y el registro permanecerá en el almacenamiento en línea hasta que se sobrescriba.

Un registro eliminado mediante TtlDuration se elimina de forma permanente, es decir, se elimina definitivamente del almacenamiento en línea, y el registro eliminado se agrega al almacenamiento sin conexión. Para obtener más información sobre los modos de borrado y borrado definitivos, consulta DeleteRecordla guía de SageMaker API referencia de Amazon. Cuando un registro se elimina de forma permanente, se vuelve inmediatamente inaccesible mediante Feature StoreAPIs.

importante

TTLnormalmente elimina los elementos caducados en unos pocos días. En función del tamaño y el nivel de actividad de una tabla, la operación de eliminación real de un elemento vencido puede variar. Dado que se TTL trata de un proceso en segundo plano, la naturaleza de la capacidad utilizada para caducar y eliminar elementos TTL es variable (pero gratuita). Para obtener más información sobre cómo se eliminan los elementos de una tabla de DynamoDB, consulte Cómo funciona: DynamoDB Time to Live (). TTL

TtlDurationdebe ser un diccionario que contenga a Unit y aValue, donde Unit debe ser una cadena con los valores «segundos», «minutos», «horas», «días» o «semanas» y Value debe ser un número entero mayor o igual a 1. TtlDurationse puede aplicar mientras se utilizan los CreateFeatureGroup caracteres,UpdateFeatureGroup, y PutRecordAPIs. Consulte la sintaxis de solicitud y respuesta en la SDK documentación de Python (Boto3) para CreateFeatureGroupUpdateFeatureGroup, y. PutRecordAPIs

  • Cuando TtlDuration se aplica a nivel de grupo de entidades (mediante CreateFeatureGroup o UpdateFeatureGroupAPIs), la aplicada TtlDuration pasa a ser la predeterminada TtlDuration para todos los registros que se agreguen al grupo de entidades desde el momento en que API se llama a. Si se aplica TtlDuration con UpdateFeatureGroupAPI, no se convertirá en el valor predeterminado TtlDuration para los registros que se crearon antes de que API se llamara al.

    Para eliminar el valor predeterminado TtlDuration de un grupo de características existente, utilice UpdateFeatureGroup API y Value defina TtlDuration Unit y ennull.

  • Cuando TtlDuration se aplica a nivel de registro (por ejemplo, utilizando PutRecordAPI), la TtlDuration duración se aplica a ese registro y se utiliza en lugar del nivel de grupo de entidades predeterminadoTtlDuration.

  • Cuando la TtlDuration se aplica a nivel de grupo de características, es posible que la TtlDuration tarde unos minutos en surtir efecto.

  • Si la TtlDuration se usa cuando no hay un almacenamiento en línea, recibirá un mensaje de error Validation Exception (400).

El siguiente código de ejemplo muestra cómo aplicar TtlDuration al actualizar un grupo de entidades, de modo que los registros que se agreguen al grupo de entidades tras su ejecución caduquen, de forma predeterminada, cuatro semanas después de la hora del evento. API

import boto3

sagemaker_client = boto3.client("sagemaker")
feature_group_name = '<YOUR_FEATURE_GROUP_NAME>'

sagemaker_client.update_feature_group(
    FeatureGroupName=feature_group_name,
    OnlineStoreConfig={
        TtlDuration:{
            Unit: "Weeks",
            Value: 4
        }
    }
)

Puede utilizar el DescribeFeatureGroup API para ver el valor predeterminadoTtlDuration.

Para ver los tiempos de caducidad ExpiresAt (en formato de UTC hora ISO -8601), mientras usa el GetRecord o BatchGetRecord APIs debe ExpirationTimeResponse configurarlo ENABLED en. Consulte la sintaxis de solicitud y respuesta en la SDK documentación de Python (Boto3) para DescribeFeatureGroupGetRecord, y. BatchGetRecordAPIs