Dela via

Time to Live i Azure Cosmos DB

  • Artikel

GÄLLER FÖR: NoSQL

Med Time to Live eller TTL tar Azure Cosmos DB bort objekt automatiskt från en container efter en viss tidsperiod. Som standard kan du ange livstid på containernivå och överstyra värdet per objekt. När du har angett TTL på en container eller på objektnivå tar Azure Cosmos DB automatiskt bort dessa objekt efter tidsperioden, sedan de senast ändrades. Time to live-värdet konfigureras i sekunder. När du konfigurerar TTL tar systemet automatiskt bort de utgångna objekten baserat på TTL-värdet, utan att behöva en borttagningsåtgärd som uttryckligen utfärdats av klientprogrammet. Det maximala värdet för TTL är 2 147 483 647 sekunder, den ungefärliga motsvarigheten till 24 855 dagar eller 68 år.

Objekt som har upphört att gälla tas bort som en bakgrundsaktivitet. Ett objekt visas inte längre i frågesvar omedelbart efter att TTL upphör att gälla, även om det ännu inte har tagits bort permanent från containern. Om containern inte har tillräckligt med enheter för begäran (RU: er) för att utföra borttagningen fördröjs borttagningen av data. Data tas bort när tillräckligt många RU:er är tillgängliga för att slutföra borttagningen.

För etablerade dataflödeskonton använder borttagningen av utgångna objekt överblivna RU:er som inte har förbrukats av användarbegäranden.

För serverlösa konton debiteras borttagningen av utgångna objekt i RU:er i samma takt som åtgärderna för att ta bort objekt.

Kommentar

Det här innehållet är relaterat till TTL för Azure Cosmos DB-transaktionslager. Om du letar efter analytisk lagrings TTL, som möjliggör NoETL HTAP-scenarier via Azure Synapse Link, klicka här.

Livslängd för containrar och föremål

Värdet time to live anges i sekunder och tolkas som ett delta från den tidpunkt då ett objekt senast ändrades. Du kan ange tid för att leva på en container eller ett objekt i containern:

  1. Time to Live för en container (anges med DefaultTimeToLive):

    • Om det saknas (eller är inställt på null) upphör objekten inte att gälla automatiskt.

    • Om det finns och värdet är inställt på "-1" är det lika med oändligt och objekt upphör inte att gälla.

    • Om det finns och värdet är inställt på ett icke-nolltal nummer "n," kommer objekten att upphöra att gälla "n" sekunder efter sin senaste ändringstid.

  2. Tidsgräns för ett objekt (ställt in med ttl):

    • Den här egenskapen gäller endast om DefaultTimeToLive finns och inte är null för den överordnade containern.

    • Om det DefaultTimeToLive finns, åsidosätter detta värdet för den överordnade containern.

Time to Live-konfigurationer

  • Om TTL är inställt på "n" på en container upphör objekten i containern att upphöra att gälla efter n sekunder. Om det finns objekt i samma container som har sin egen tid att leva, anger du till -1 (vilket indikerar att de inte upphör att gälla). Om vissa objekt åsidosätter inställningen time to live med ett annat tal upphör dessa objekt att gälla baserat på deras egna konfigurerade TTL-värde.

  • Om TTL inte har angetts för en container, har livstiden för ett objekt i den här containern ingen effekt.

  • Om TTL på en container har angetts till -1, kommer ett objekt i denna container som har time-to-live satt till n att upphöra att gälla efter n sekunder, medan de återstående objekten inte kommer att göra det.

Exempel

Det här avsnittet visar några exempel med olika livslängdsvärden som tilldelats för containrar och objekt.

Kommentar

Det går inte att ange TTL till null för ett objekt. Objektets TTL-värde måste vara ett icke-zero-positivt heltal som är mindre än eller lika med 2147483647, eller -1, vilket innebär att objektet aldrig upphör att gälla. Om du vill använda standard-TTL för ett objekt kontrollerar du att TTL-egenskapen inte finns.

Exempel 1

TTL på containern är inställt på null (DefaultTimeToLive = null)

TTL för objekt Resultat
TTL-egenskapen saknas TTL är inaktiverat. Objektet upphör aldrig att gälla (standard).
ttl = -1 TTL är inaktiverat. Objektet upphör aldrig att gälla.
ttl = 2000 TTL är inaktiverat. Objektet upphör aldrig att gälla.

Exempel 2

TTL på containern är inställt på -1 (DefaultTimeToLive = -1)

TTL för objekt Resultat
TTL-egenskapen saknas TTL är aktiverat. Objektet upphör aldrig att gälla (standard).
ttl = -1 TTL är aktiverat. Objektet upphör aldrig att gälla.
ttl = 2000 TTL är aktiverat. Objektet upphör att gälla efter 2 000 sekunder.

Exempel 3

TTL på containern är inställt på 1000 (DefaultTimeToLive = 1000)

TTL för objekt Result
TTL-egenskapen saknas TTL är aktiverat. Objektet upphör att gälla efter 1 000 sekunder (standard).
ttl = -1 TTL är aktiverat. Objektet upphör aldrig att gälla.
ttl = 2000 TTL är aktiverat. Objektet upphör att gälla efter 2 000 sekunder.

Nästa steg

Lär dig hur du konfigurerar Time to Live i följande artiklar: