Share via

Meest recente herstelbare tijdstempel voor Azure Cosmos DB-accounts met continue back-upmodus

  • Artikel

VAN TOEPASSING OP: Nosql MongoDB Gremlin Tabel

Azure Cosmos DB biedt een API voor het ophalen van de meest recente herstelbare tijdstempel van een container. Deze API is beschikbaar voor accounts waarvoor continue back-upmodus is ingeschakeld. De meest recente restorable timestamp vertegenwoordigt de meest recente tijdstempel in UTC-indeling waarvan een back-up van uw gegevens is gemaakt. Met deze API kunt u de herstelbare tijdstempel ophalen om het live-account te herstellen of te bewaken dat er op tijd een back-up van uw gegevens wordt gemaakt.

Deze API neemt ook de accountlocatie als invoerparameter en retourneert de meest recente herstelbare tijdstempel voor de opgegeven container op deze locatie. Als een account op meerdere locaties bestaat, kan de meest recente herstelbare tijdstempel voor een container op verschillende locaties verschillen omdat de back-ups op elke locatie onafhankelijk worden gemaakt.

Deze API werkt standaard alleen op containerniveau, maar kan eenvoudig worden uitgebreid om te werken op database- of accountniveau. Dit artikel helpt u inzicht te krijgen in de semantiek van api, hoe deze wordt berekend en gebruiksvoorbeelden voor de API. Zie voor meer informatie de meest recente hersteltijdstempel voor API voor NoSQL-, MongoDB-, Table- en Gremlin-accounts.

Gebruiksgevallen

In de volgende gebruiksvoorbeelden kunt u de meest recente tijdstempels voor restorable gebruiken:

  • U kunt het meest recente herstelbare tijdstempel voor een container, database of een account ophalen en dit gebruiken om de herstelbewerking te activeren. Deze tijdstempel vertegenwoordigt de gegevens van de opgegeven resource of alle onderliggende resources waarvan een back-up is gemaakt.

  • U kunt deze API gebruiken om te bepalen dat er een back-up van uw gegevens is gemaakt voordat u het account verwijdert. Als de tijdstempel die door deze API wordt geretourneerd, kleiner is dan de laatste tijdstempel voor schrijven, betekent dit dat er nog geen back-up van gegevens is gemaakt. In dat geval moet u deze API aanroepen totdat de tijdstempel gelijk is aan of groter is dan de laatste tijdstempel voor schrijven. Als een account op meerdere locaties bestaat, moet u de meest recente tijdstempel ophalen op alle locaties om ervoor te zorgen dat er een back-up van gegevens is gemaakt in alle regio's voordat u het account verwijdert.

  • U kunt deze API gebruiken om te controleren of er op tijd een back-up van uw gegevens wordt gemaakt. Deze tijdstempel is over het algemeen binnen een paar honderd seconden van de huidige tijdstempel, hoewel het soms meer kan verschillen.

Semantiek

De meest recente herstelbare tijdstempel voor een container is de minimale tijdstempel tot en met welke back-up van alle partities op een locatie is gemaakt. Deze API berekent de meest recente herstelbare tijdstempel door de meest recente back-uptijdstempel voor elke partitie van de container op een locatie op te halen en retourneert de minimale tijdstempel van al deze tijdstempels. Als er een back-up van de gegevens voor alle partities wordt gemaakt en er geen nieuwe gegevens naar deze partities zijn geschreven, retourneert deze het maximum van de huidige tijdstempel en de laatste tijdstempel voor de back-up van gegevens.

Als een partitie nog geen back-up heeft gemaakt, maar er een back-up van enkele gegevens moet worden gemaakt, retourneert deze het minimale Unix-tijdstempel (epoch) dat is, 1 januari 1970, middernacht UTC (Coordinated Universal Time). In dergelijke gevallen moet de gebruiker het opnieuw proberen totdat een tijdstempel groter is dan tijdstempel van epoch.

Meest recente tijdstempelberekening

In het volgende voorbeeld wordt het verwachte resultaat van de meest recente restorable timestamp-API in verschillende scenario's beschreven. In elk scenario bespreken we de huidige back-upstatus van het logboek van de partitie, wachtend op gegevens waarvan een back-up moet worden gemaakt en hoe dit van invloed is op de algehele meest recente herstelbare tijdstempelberekening voor een container.

Stel dat we een account hebben dat bestaat in twee regio's (VS - oost, VS - west). We hebben een container 'cont1', met twee partities (Partition1,Partition2). Als we een aanvraag verzenden om de meest recente herstelbare tijdstempel voor deze container op tijdstempel 't3' op te halen, wordt de algehele meest recente herstelbare tijdstempel voor deze container als volgt berekend:

Case1: Er is nog geen back-up gemaakt van gegevens voor alle partities

REGIO VS - oost:

  • Partitie 1: Laatste back-uptijd = t2, maar er moet na t2 een back-up van meer gegevens worden gemaakt.
  • Partitie 2: Laatste back-uptijd = t3 en alle bijbehorende gegevens worden geback-upt.
  • Laatste restorable timestamp = min (t2, t3) = t2

REGIO VS - west:

  • Partitie 1: Laatste back-uptijd = t1, maar er moet na t1 een back-up van meer gegevens worden gemaakt.
  • Partitie 2: Laatste back-uptijd = t2, maar er moet na t2 een back-up van meer gegevens worden gemaakt.
  • Laatste restorable timestamp = min (t1, t2) = t1
Case2: Er wordt een back-up gemaakt van gegevens voor alle partities

REGIO VS - oost:

  • Partitie 1: Laatste back-uptijd = t2 en alle bijbehorende gegevens worden geback-upt.
  • Partitie 2: Laatste back-uptijd = t3 en alle bijbehorende gegevens worden geback-upt.
  • Meest recente herstelbare tijdstempel = max (huidige tijdstempel, t2, t3)

REGIO VS - west:

  • Partitie 1: Laatste back-uptijd = t3 en alle bijbehorende gegevens worden geback-upt.
  • Partitie 2: Laatste back-uptijd = t3 en alle bijbehorende gegevens worden geback-upt.
  • Laatste herstelbare tijdstempel = max (huidige tijdstempel, t3, t3)
Case3: Wanneer een of meer partities nog geen back-up hebben gemaakt

REGIO VS - oost:

  • Partitie 1: er is nog geen logboekback-up gemaakt voor deze partitie.
  • Partitie 2: Laatste back-uptijd = t3
  • Laatste restorable timestamp = 1/1/1970 12:00:00 am

Veelgestelde vragen

Kan ik deze API gebruiken voor accounts met periodieke back-up?

Nee Deze API kan alleen worden gebruikt voor accounts met continue back-upmodus.

Kan ik deze API gebruiken voor accounts die zijn gemigreerd naar continue modus?

Ja. Deze API kan worden gebruikt voor het account dat is ingericht met de modus voor continue back-up of is gemigreerd naar de modus voor continue back-up.

Wat is de typische vertraging tussen de meest recente tijdstempel voor schrijven en de meest recente tijdstempel die kan worden teruggeschreven?

Er wordt elke 100 seconden een back-up van de logboekback-upgegevens gemaakt. In sommige uitzonderlijke gevallen kunnen back-ups echter langer dan 100 seconden worden vertraagd.

Werkt een tijdstempel die kan worden teruggehaald voor verwijderde resources?

Nee Dit geldt alleen voor liveresources (databases, verzamelingen of accounts). U kunt de herstelbare tijdstempel ophalen om het live-account te herstellen of te controleren of er op tijd een back-up van uw gegevens wordt gemaakt.

Volgende stappen