Duração do tempo de vida (TTL) dos registros - SageMaker Inteligência Artificial da Amazon

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Duração do tempo de vida (TTL) dos registros

A Amazon SageMaker Feature Store oferece a opção de excluir permanentemente os registros da loja on-line após atingir um período de tempo, com a duração de tempo de vida (TTL) (TtlDuration). O registro expirará depois que o EventTime do registro mais a TtlDuration forem atingidos, ou ExpiresAt = EventTime + TtlDuration. O TtlDuration pode ser aplicado em um nível de grupo de atributos, em que todos os registros dentro do grupo de atributos terão o TtlDuration por padrão, ou em um nível de registro individual. Se TtlDuration não for especificado, o valor padrão será null e o registro permanecerá no armazenamento on-line até ser sobrescrito.

Um registro excluído usando TtlDuration é excluído permanentemente ou completamente removido do armazenamento on-line, e o registro excluído é adicionado ao armazenamento offline. Para obter mais informações sobre exclusão definitiva e modos de exclusão, consulte o guia DeleteRecordde referência de SageMaker API da Amazon. Quando um registro é excluído permanentemente, ele fica imediatamente inacessível usando o Feature Store APIs.

Importante

A TTL normalmente exclui itens expirados depois de alguns dias. Dependendo do tamanho e do nível de atividade de uma tabela, a operação de exclusão real de um item expirado pode variar. Como o TTL deve ser um processo em segundo plano, a natureza da capacidade usada para expirar e excluir itens via TTL é variável (mas gratuita). Para obter mais informações sobre como os itens são excluídos de uma tabela do DynamoDB, consulte Como funciona: tempo de vida (TTL) do DynamoDB.

TtlDurationdeve ser um dicionário contendo a Unit e aValue, em que Unit deve ser uma string com valores “Segundos”, “Minutos”, “Horas”, “Dias” ou “Semanas” e Value deve ser um número inteiro maior ou igual a 1. TtlDurationpode ser aplicado ao usar o CreateFeatureGroupUpdateFeatureGroup, PutRecord APIs e. Consulte a sintaxe de solicitação e resposta na documentação do SDK for Python (Boto3) para, e. CreateFeatureGroupUpdateFeatureGroupPutRecord APIs

  • Quando TtlDuration é aplicado em um nível de grupo de recursos (usando o CreateFeatureGroup ou UpdateFeatureGroup APIs), o aplicado TtlDuration se torna o padrão TtlDuration para todos os registros adicionados ao grupo de recursos a partir do momento em que a API é chamada. Ao aplicar a TtlDuration com a API UpdateFeatureGroup, ela não se tornará a TtlDuration padrão para registros criados antes da chamada da API.

    Para remover o TtlDuration padrão de um grupo de atributos existente, use a API UpdateFeatureGroup e defina TtlDuration Unit e Value como null.

  • Quando a TtlDuration é aplicada em um nível de registro (por exemplo, usando a API PutRecord), a duração TtlDuration se aplica a esse registro e é usada em vez da TtlDuration padrão do nível de grupo de atributos.

  • Quando a TtlDuration é aplicada em um nível de grupo de atributos, pode levar alguns minutos que a TtlDuration entre em vigor.

  • Se a TtlDuration for usada quando não houver armazenamento on-line, você receberá um erro Validation Exception (400).

O código de exemplo a seguir mostra como aplicar uma TtlDuration durante a atualização de um grupo de atributos, de forma que os registros adicionados ao grupo de atributos após a execução da API expirem por padrão quatro semanas após o horário do evento.

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

Você pode usar a API DescribeFeatureGroup para ver a TtlDuration padrão.

Para ver os prazos de expiração ExpiresAt (no formato ISO-8601 da hora UTC), ao usar o GetRecord ou BatchGetRecord APIs você deve definir como. ExpirationTimeResponse ENABLED Consulte a sintaxe de solicitação e resposta na documentação do SDK for Python (Boto3) para, e. DescribeFeatureGroupGetRecordBatchGetRecord APIs