

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 name="feature-store-time-to-live"></a>

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` \$1 `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 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_DeleteRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_DeleteRecord.html)de 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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/howitworks-ttl.html).

`TtlDuration`deve ser um dicionário contendo a `Unit` e a`Value`, 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. `TtlDuration`pode ser aplicado ao usar o `CreateFeatureGroup``UpdateFeatureGroup`, `PutRecord` APIs e. Consulte a sintaxe de solicitação e resposta na documentação do SDK for Python (Boto3) para, e. [https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/create_feature_group.html#SageMaker.Client.create_feature_group](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/create_feature_group.html#SageMaker.Client.create_feature_group) 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. [https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/describe_feature_group.html#describe-feature-group](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker/client/describe_feature_group.html#describe-feature-group) APIs