TTL

Concluído

O Azure Cosmos DB permite que você defina o período de tempo em que os documentos permanecem no banco de dados antes de serem automaticamente limpos. O "time-to-live" (TTL) de um documento é medido em segundos a partir da última modificação e pode ser definido no nível do contêiner com a capacidade de substituir por item.

Uma vez definido no nível do contêiner, o Azure Cosmos DB limpará automaticamente os documentos no momento especificado desde que foram modificados pela última vez. O valor TTL é definido como um inteiro em segundos.

Gorjeta

O valor máximo de TTL é 2147483647.

A expiração TTL é uma tarefa em segundo plano executada em segundo plano usando unidades de solicitação e é agendada quando quiescente.

Configurando o TTL em um contêiner

O valor TTL para um contêiner é configurado usando a DefaultTimeToLive propriedade do objeto JSON do contêiner.

DefaultTimeToLive Validade
Não existe Os itens não expiraram automaticamente
-1 Os itens não expirarão por padrão
n n segundos após a hora da última modificação

O valor TTL para um item é configurado definindo o ttl caminho do item. O valor TTL de um item só funcionará se a DefaultTimeToLive propriedade estiver configurada para o contêiner pai. Se o ttl caminho estiver configurado para o item, ele substituirá a DefaultTimeToLive propriedade do contêiner pai.

Exemplos

Container.DefaultTimeToLive Item.ttl Expiração em segundos
1000 nulo 1000
1000 -1 Este item nunca expirará
1000 2000 2000
Container.DefaultTimeToLive Item.ttl Expiração em segundos
nulo nulo Este item nunca expirará
nulo -1 Este item nunca expirará
nulo 2000 O TTL está desativado no nível do contêiner. Este item nunca expirará.