Resourcemodel voor de functie voor herstel naar een bepaald tijdstip van Azure Cosmos DB

  • Van toepassing op: ✅ NoSQL, ✅ MongoDB, ✅ Apache Gremlin, ✅ Table

In dit artikel wordt uitleg gegeven over het resourcemodel voor de functie voor herstel naar een bepaald tijdstip van Azure Cosmos DB. Hierin worden de parameters uitgelegd die ondersteuning bieden voor de continue back-up en resources die kunnen worden hersteld. Deze functie wordt ondersteund in azure Cosmos DB-API voor SQL, Azure Cosmos DB-API voor Gremlin, Table-API en de Azure Cosmos DB-API voor MongoDB.

Het resourcemodel van het databaseaccount

Het resourcemodel van het databaseaccount wordt bijgewerkt met enkele extra eigenschappen ter ondersteuning van de nieuwe herstelscenario's. Deze eigenschappen zijn BackupPolicy, CreateModeen RestoreParameters.

BackupPolicy

Een nieuwe eigenschap in het back-upbeleid op accountniveau met de naam Type onder de backuppolicy parameter maakt continue back-up en herstel naar een bepaald tijdstip mogelijk. Deze modus wordt continue back-up genoemd. U kunt deze modus instellen bij het maken van het account of tijdens het migreren van een account van periodieke naar continue modus. Nadat de continue modus is ingeschakeld, hebben alle containers en databases die in dit account zijn gemaakt, standaard herstel naar een bepaald tijdstip en continue back-up ingeschakeld. De continue back-uplaag kan worden ingesteld op Continuous7Days of Continuous30Days. Als er geen laag is opgegeven, Continuous30Days wordt standaard toegepast op het account.

Opmerking

Momenteel is de functie voor herstel naar een bepaald tijdstip beschikbaar voor Azure Cosmos DB voor NoSQL-, API-, MongoDB-, Table- en Gremlin-accounts. Nadat u een account met continue modus hebt gemaakt, kunt u het niet overschakelen naar een periodieke modus. De Continuous7Days laag is in voorversie.

Creatiemodus

Deze eigenschap geeft aan hoe het account is gemaakt. De mogelijke waarden zijn Standaard en Herstellen. Als u een herstel wilt uitvoeren, stelt u deze waarde in op Herstellen en geeft u de juiste waarden op in de RestoreParameters eigenschap.

publicNetworkAccess

Deze eigenschap moet worden ingesteld op Uitgeschakeld om het account te herstellen zonder openbare netwerktoegang. Als deze eigenschap niet is opgegeven, gaat het herstellen van het account verder met publicNetworkAccess als Enabled.

RestoreParameters

De RestoreParameters resource bevat de details van de herstelbewerking, waaronder de account-id, de tijd die moet worden hersteld en resources die moeten worden hersteld.

Naam van propertie Description
restoreMode De herstelmodus moet zijn PointInTime.
restoreSource De instanceId van het bronaccount waaruit het herstel wordt gestart.
restoreTimestampInUtc Tijdstip in UTC om het account te herstellen.
databasesToRestore Lijst met DatabaseRestoreResource objecten om op te geven welke databases en containers moeten worden hersteld. Elke resource vertegenwoordigt één database en alle verzamelingen onder die database. Zie restorable SQL-resources voor meer informatie. Als deze waarde leeg is, wordt het hele account hersteld.
gremlinDatabasesToRestore Lijst met GremlinDatabaseRestoreResource objecten om op te geven welke databases en grafieken moeten worden hersteld. Elke resource vertegenwoordigt één database en alle grafieken onder die database. Zie voor meer informatie restorable Gremlin resources. Als deze waarde leeg is, wordt het hele account hersteld.
restoreWithTtlDisabled Booleaanse vlagwaarden (waar/onwaar) om Time-To-Live uit te schakelen in het herstelde account na voltooiing van de herstelbewerking. (voorvertoning)
tablesToRestore Lijst met TableRestoreResource objecten om op te geven welke tabellen moeten worden hersteld. Elke resource vertegenwoordigt een tabel onder die database. Voor meer informatie, zie herstelbare tabelresources. Als deze waarde leeg is, wordt het hele account hersteld.

Voorbeeldbron

De volgende JSON is een voorbeeld van een databaseaccountresource waarvoor doorlopende back-up is ingeschakeld.

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "publicNetworkAccess":"Disabled",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreWithTtlDisabled" : "true",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ...
    }
  }
}

Herstelbare bronnen

Er is een set nieuwe resources en API's beschikbaar waarmee u essentiële informatie over resources kunt detecteren, waaronder:

  • Waar de bronnen kunnen worden hersteld
  • Locaties waar de bronnen kunnen worden hersteld
  • Tijdstempels wanneer sleutelbewerkingen op deze resources zijn uitgevoerd.

Opmerking

Voor alle API's die worden gebruikt om deze resources op te sommen, zijn de volgende machtigingen vereist:

  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read
  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read

Herstelbare database-account

Deze resource bevat een databaseaccountvoorbeeld dat kan worden hersteld. Het databaseaccount kan een verwijderd of een actief account zijn. Het bevat informatie waarmee u het brondatabaseaccount kunt vinden dat u wilt herstellen.

Naam van propertie Description
ID De unieke identificatie van de resource.
accountName De naam van het globale databaseaccount.
creationTime De tijd in UTC waarop het account is gemaakt of gemigreerd.
deletionTime De tijd in UTC waarop het account is verwijderd. Deze waarde is leeg als het account live is.
apiType Het API-type van het Azure Cosmos DB-account.
restorableLocations De lijst met locaties waar het account bestond.
restorableLocations: locationName De naam van de regio van het regionale account.
restorableLocations: regionalDatabaseAccountInstanceId De GUID van het regionale account.
restorableLocations: creationTime De tijd in UTC waarop het regionale account is gemaakt of gemigreerd.
restorableLocations: deletionTime De tijd in UTC waarop het regionale account is verwijderd. Deze waarde is leeg als het regionale account live is.
OldestRestorableTimeStamp De vroegste tijd in UTC waarop herstel kan worden uitgevoerd. Voor de laag van 30 dagen kan deze tijd maximaal 30 dagen vanaf nu zijn, voor de laag zeven dagen, deze tijd kan vanaf nu maximaal zeven dagen zijn.

Zie de artikelen Restorable Database Accounts - list of Restorable Database Accounts - list by location voor een lijst met alle restorable accounts.

Restorable SQL-database

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het maken en verwijderen van de SQL Database. Deze informatie kan helpen in scenario's waarin de database per ongeluk is verwijderd en als u wilt weten wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop de database wordt gemaakt of verwijderd.
ownerId De naam van de SQL-database.
ownerResourceId De resource-id van de SQL-database,
operationType Het bewerkingstype van deze databasegebeurtenis.
database De eigenschappen van de SQL-database op het moment van de gebeurtenis,

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: gebeurtenis voor het maken van databases
  • Delete: gebeurtenis voor het verwijderen van databases
  • Replace: gebeurtenis voor databasewijziging
  • SystemOperation: gebeurtenis voor databasewijziging die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker

Zie het artikel Restorable NoSQL Databases - List voor een lijst met alle databasemutaties.

Restorable SQL-container

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het maken en verwijderen van de SQL-container. Deze informatie kan helpen in scenario's waarin de container is gewijzigd of verwijderd, en als u wilt weten wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop deze containerevenement heeft plaatsgevonden.
ownerId De naam van de SQL-container.
ownerResourceId De resource-id van de SQL-container.
operationType Het bewerkingstype van deze containergebeurtenis.
container De eigenschappen van de SQL-container op het moment van de gebeurtenis.

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: gebeurtenis voor het aanmaken van containers
  • Delete: containerverwijderingsgebeurtenis
  • Replace: gebeurtenis van containerwijziging
  • SystemOperation: gebeurtenis voor containerwijziging die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker

Zie het artikel Restorable NoSQL Containers - List voor een lijst met alle containermutaties onder dezelfde database.

Herstelbare SQL-bronnen

Elke resource vertegenwoordigt één database en alle containers onder die database.

Naam van propertie Description
databaseName De naam van de SQL-database.
collectionNames De lijst met SQL-containers onder deze database.

Zie het artikel Restorable NoSQL-resources - List voor een lijst met SQL-databases en containercombinaties die aanwezig zijn in het account op de opgegeven tijdstempel en locatie.

Restorable MongoDB-database

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het maken en verwijderen van de MongoDB-database. Deze informatie kan helpen in het scenario waarin de database per ongeluk is verwijderd en de gebruiker moet achterhalen wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis is opgetreden.
ownerId De naam van de MongoDB-database.
ownerResourceId De bron-ID van de MongoDB-database.
operationType Het bewerkingstype van deze databasegebeurtenis.

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: gebeurtenis voor het maken van databases
  • Delete: gebeurtenis voor het verwijderen van databases
  • Replace: gebeurtenis voor databasewijziging
  • SystemOperation: gebeurtenis voor databasewijziging die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker

Zie Restorable Mongodb Databases - List article voor een lijst met alle databasemutaties.

Restorable MongoDB-verzameling

Elke resource bevat informatie over een mutatiegebeurtenis die zich heeft voorgedaan, zoals het creëren en verwijderen binnen de MongoDB-collectie. Deze informatie kan helpen in scenario's waarin de verzameling is gewijzigd of verwijderd en de gebruiker moet achterhalen wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop dit verzamelingsevenement heeft plaatsgevonden.
ownerId De naam van de MongoDB-verzameling.
ownerResourceId De resource-id van de MongoDB-verzameling.
operationType Het bewerkingstype van deze verzamelingsgebeurtenis.

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: gebeurtenis voor het maken van verzamelingen
  • Delete: gebeurtenis voor het verwijderen van verzamelingen
  • Replace: gebeurtenis voor het wijzigen van verzamelingen
  • SystemOperation: gebeurtenis voor het wijzigen van verzamelingen die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker

Als u een lijst met alle containermutaties onder dezelfde database wilt ophalen, bekijkt u restorable MongoDB resources: lijst.

Herstelbare MongoDB-resources

Elke resource vertegenwoordigt één database en alle verzamelingen onder die database.

Naam van propertie Description
databaseName De naam van de MongoDB-database.
collectionNames De lijst met MongoDB-verzamelingen onder deze database.

Als u een lijst wilt opzoeken van alle combinaties van MongoDB-databases en -collecties die aanwezig zijn in het account op de opgegeven tijdstempel en locatie, raadpleegt u de lijst met restorable MongoDB-resources.

Restorable Graph-resources

Elke resource vertegenwoordigt één database en alle grafieken onder die database.

Naam van propertie Description
gremlinDatabaseName De naam van de Graph-database.
graphNames De lijst met grafieken onder deze database.

Zie het artikel Restorable Graph Resources - List voor een lijst met alle combinaties van Gremlin-database en grafiek die op het account bestaan op het gegeven tijdstip en locatie.

Restorable Graph-database

Elke resource bevat informatie over een mutatiegebeurtenis, zoals een creatie en verwijdering die is opgetreden in de Graph-database. Deze informatie kan helpen in het scenario waarin de database per ongeluk is verwijderd en de gebruiker moet achterhalen wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis is opgetreden.
ownerId De naam van de Graph-database.
ownerResourceId De resource-id van de Graph-database.
operationType Het bewerkingstype van deze databasegebeurtenis.

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: gebeurtenis voor het maken van databases
  • Delete: gebeurtenis voor het verwijderen van databases
  • Replace: gebeurtenis voor databasewijziging
  • SystemOperation: gebeurtenis voor databasewijziging die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker.

Wanneer u een gebeurtenisfeed wilt ontvangen van alle mutaties op de Gremlin-database, raadpleeg dan de lijst met restorable grafiekdatabases.

Restorable Graphs

Elke resource bevat informatie over een mutatie-event, zoals het aanmaken en verwijderen dat heeft plaatsgevonden op de grafiek. Deze informatie kan helpen bij scenario's waarin de grafiek is gewijzigd of verwijderd en als u wilt weten wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop dit verzamelingsevenement heeft plaatsgevonden.
ownerId De naam van de Graph-verzameling.
ownerResourceId De resource-id van de Graph-verzameling.
operationType Het bewerkingstype van deze verzamelingsgebeurtenis.

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: Grafiekcreatiegebeurtenis
  • Delete: Gebeurtenis voor het verwijderen van een grafiek
  • Replace: Gebeurtenis voor het wijzigen van een diagram
  • SystemOperation: gebeurtenis voor het wijzigen van verzamelingen die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker.

Zie het artikel Graph Restorable Graphs - List voor een lijst met alle containermutaties onder dezelfde database.

Tabelresources die kunnen worden geplaatst

Een lijst met alle restorable Azure Cosmos DB-tabellen die beschikbaar zijn voor een specifiek databaseaccount op een bepaald tijdstip en op een bepaalde locatie. Houd er rekening mee dat de API voor Table geen expliciete database opgeeft.

Naam van propertie Description
TableNames De lijst met tabelcontainers onder dit account.

Zie het artikel Restorable Table Resources - List voor een lijst met tabellen die aanwezig zijn in het account op de opgegeven tijdstempel en locatie.

Herstelbare Tabel

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het aanmaken en verwijderen dat op de tabel heeft plaatsgevonden. Deze informatie kan helpen in scenario's waarin de tabel is gewijzigd of verwijderd en als u wilt weten wanneer die gebeurtenis is opgetreden.

Naam van propertie Description
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis is opgetreden.
ownerId De naam van de tabeldatabase.
ownerResourceId De Resource-ID van de tabelresource.
operationType Het bewerkingstype van deze tabel-gebeurtenis.

Opmerking

Mogelijke waarden zijn operationType onder andere:

  • Create: Gebeurtenis voor het maken van tabellen
  • Delete: Gebeurtenis voor tabelverwijdering
  • Replace: Gebeurtenis van tabelwijziging
  • SystemOperation: gebeurtenis voor databasewijziging die door het systeem wordt geactiveerd. Deze gebeurtenis wordt niet gestart door de gebruiker

Zie het artikel Restorable Table - List voor een lijst met alle tabelmutaties onder dezelfde database.

Volgende stappen 

  • Last updated on