Usar a vida útil (TTL) no DynamoDB

A vida útil (TTL) para DynamoDB é um método econômico para excluir itens que não são mais relevantes. A TTL permite definir um carimbo de data e hora de validade por item que indica quando um item não é mais necessário. O DynamoDB exclui automaticamente os itens expirados alguns dias após o vencimento, sem consumir o throughput de gravação.

Para usar a TTL, primeiro habilite-a em uma tabela e, depois, defina um atributo específico para armazenar o carimbo de data e hora de vencimento da TTL. O carimbo de data/hora deve ser armazenado como um tipo de dados de número no formato de hora de época do Unix na granularidade de segundos. Itens com um atributo TTL que não seja do tipo de número são ignorados pelo processo TTL. Sempre que um item é criado ou atualizado, é possível calcular o prazo de validade e salvá-lo no atributo TTL.

Os itens com atributos TTL válidos e expirados podem ser excluídos pelo sistema a qualquer momento, normalmente dentro de alguns dias após a expiração. Você ainda pode atualizar os itens expirados que estão pendentes de exclusão, incluindo alterar ou remover os atributos TTL. Se você atualizar o atributo TTL de um item para um timestamp futuro (ou remover o atributo TTL) antes que o item seja excluído, ele deixará de ser considerado expirado e o processo de TTL não o excluirá. Ao atualizar um item expirado, recomendamos usar uma expressão de condição para garantir que o item não tenha sido excluído posteriormente. Use expressões de filtro para remover itens expirados dos resultados de Scan e Query.

Os itens excluídos funcionam de forma semelhante aos excluídos por meio de operações de exclusão típicas. Depois da exclusão, os itens entram no DynamoDB Streams como exclusões de serviço, e não como exclusões de usuário, e são removidos dos índices secundários locais e globais da mesma forma que outras operações de exclusão.

Se estiver usando Global Tables versão 2019.11.21 (atual) das tabelas globais e também usar o recurso TTL, o DynamoDB replicará as exclusões de TTL em todas as tabelas de réplica. A exclusão inicial de TTL não consome unidades de capacidade de gravação (WCU) na região onde a TTL expira. No entanto, a exclusão de TTL replicada para as tabelas de réplica consume uma unidade de capacidade de gravação replicada ao usar a capacidade provisionada ou a unidade de gravação replicada ao usar o modo de capacidade sob demanda, em cada uma das regiões de réplica, e serão aplicadas cobranças.

Para obter mais informações sobre TTL, consulte estes tópicos: