Período de vida (TTL)

Completado

Azure Cosmos DB permite establecer el período de vida de los documentos en la base de datos antes de su purga automática. El período de vida (TTL) de un documento se mide en segundos desde la última modificación y se puede establecer en el nivel de contenedor con la capacidad de invalidación por elemento.

Una vez establecido en el nivel de contenedor, Azure Cosmos DB purgará automáticamente los documentos en el momento especificado desde que se modificaron por última vez. El valor de TTL se define como un entero en segundos.

Sugerencia

El valor máximo de TTL es 2147483647.

La expiración de TTL es una tarea que se realiza en segundo plano mediante unidades de solicitud y se programa cuando está en modo inactivo.

Configuración de TTL en un contenedor

El valor de TTL de un contenedor se configura mediante la propiedad DefaultTimeToLive del objeto JSON del contenedor.

DefaultTimeToLive Expiración
No existe Los elementos no expiran automáticamente
-1 Los elementos no expirarán de forma predeterminada
n n segundos después de la hora de la última modificación

El valor de TTL de un elemento se configura estableciendo la ruta de acceso ttl del elemento. El valor de TTL de un elemento solo funcionará si la propiedad DefaultTimeToLive está configurada para el contenedor principal. Si la ruta de acceso ttl está configurada para el elemento, invalidará la propiedad DefaultTimeToLive del contenedor principal.

Ejemplos

Container.DefaultTimeToLive Item.ttl Expiración en segundos
1000 null 1000
1000 -1 Este elemento nunca expirará
1000 2000 2000
Container.DefaultTimeToLive Item.ttl Expiración en segundos
null null Este elemento nunca expirará
null -1 Este elemento nunca expirará
null 2000 TTL está deshabilitado en el nivel de contenedor. Este elemento nunca expirará.