Durata (TTL)

Completato

Azure Cosmos DB consente di impostare il tempo di permanenza dei documenti nel database prima che vengano eliminati automaticamente. Il valore TTL (time-to-live) di un documento viene misurato in secondi dall'ultima modifica e può essere impostato a livello di contenitore con possibilità di eseguire l'override per singoli elementi.

Una volta impostato a livello di contenitore, Azure Cosmos DB elimina automaticamente i documenti quando è trascorso il tempo specificato dall'ultima modifica. Il valore TTL è definito come intero in secondi.

Suggerimento

Il valore TTL massimo è 2147483647.

La scadenza TTL è un'attività eseguita in background usando le unità di richiesta e viene pianificata in periodi di inattività.

Configurazione del TTL in un contenitore

Il valore TTL per un contenitore viene configurato con la proprietà DefaultTimeToLive dell'oggetto JSON del contenitore.

DefaultTimeToLive Scadenza
Non esiste Gli elementi non scadono automaticamente
-1 Gli elementi non scadono per impostazione predefinita
n n secondi dall'ultima modifica

Il valore TTL per un elemento è configurato impostando il percorso ttl dell'elemento. Il valore TTL per un elemento funzionerà solo se la proprietà DefaultTimeToLive è configurata per il contenitore padre. Se il percorso ttl è configurato per l'elemento, eseguirà l'override della proprietà DefaultTimeToLive del contenitore padre.

Esempi

Container.DefaultTimeToLive Item.ttl Scadenza in secondi
1000 Null 1000
1000 -1 Questo elemento non scadrà mai
1000 2000 2000
Container.DefaultTimeToLive Item.ttl Scadenza in secondi
Null Null Questo elemento non scadrà mai
Null -1 Questo elemento non scadrà mai
Null 2000 La durata (TTL) è disabilitata a livello di contenitore. Questo elemento non scadrà mai.