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

  • Artikel

VAN TOEPASSING OP: Nosql MongoDB Gremlin Tabel

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.

Resourcemodel van 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, zijn herstel naar een bepaald tijdstip en continue back-up standaard ingeschakeld voor alle containers en databases die in dit account zijn gemaakt. De continue back-uplaag kan worden ingesteld op Continuous7Days of Continuous30Days. Als er geen laag is opgegeven, Continuous30Days wordt standaard toegepast op het account.

Notitie

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

CreateMode

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

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.

Eigenschapsnaam Beschrijving
restoreMode De herstelmodus moet zijn PointInTime.
restoreSource De instanceId van het bronaccount van 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 Sql-resources herstellen 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 Restorable Gremlin-resources voor meer informatie. Als deze waarde leeg is, wordt het hele account hersteld.
tablesToRestore Lijst met TableRestoreResource objecten om op te geven welke tabellen moeten worden hersteld. Elke resource vertegenwoordigt een tabel onder die database. Zie Restorable Table-resources voor meer informatie. Als deze waarde leeg is, wordt het hele account hersteld.

Voorbeeldresource

De volgende JSON is een voorbeelddatabaseaccountresource waarvoor continue back-up is ingeschakeld:

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/1a97b4bb-f6a0-430e-ade1-638d781830cc",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ....
    }
  }
}

Restorable resources

Er is een set nieuwe resources en API's beschikbaar om u te helpen essentiële informatie over resources te ontdekken, waaronder:

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

Notitie

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

Restorable database-account

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

Eigenschapsnaam Beschrijving
ID De unieke id 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 regionaam van het regionale account.
restorableLocations: regionalDatabaseAccountInstanceId De GUID van het regionale account.
restorableLocations: creationTime De tijd in UTC waarop het regionale account is gemaakt r 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 waarnaar herstel kan worden uitgevoerd. Voor de laag van 30 dagen kan deze tijd vanaf nu maximaal 30 dagen zijn. Voor de laag van zeven dagen kan dit vanaf nu maximaal zeven dagen zijn.

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

Sql-database herstellen

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het maken en verwijderen, die is opgetreden op 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 heeft plaatsgevonden.

Eigenschapsnaam Beschrijving
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 database-gebeurtenis.
database De eigenschappen van de SQL-database op het moment van de gebeurtenis,

Notitie

Mogelijke waarden voor operationType zijn onder andere:

  • Create: gebeurtenis voor het maken van de database
  • Delete: gebeurtenis voor databaseverwijdering
  • Replace: gebeurtenis voor databasewijziging
  • SystemOperation: databasewijzigingsgebeurtenis geactiveerd door het systeem. Deze gebeurtenis wordt niet geïnitieerd door de gebruiker

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

Herstelbare 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 heeft plaatsgevonden.

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

Notitie

Mogelijke waarden voor operationType onder andere:

  • Create: gebeurtenis voor het maken van een container
  • Delete: gebeurtenis voor het verwijderen van containers
  • Replace: gebeurtenis voor containerwijziging
  • SystemOperation: containerwijzigingsgebeurtenis geactiveerd door het systeem. Deze gebeurtenis wordt niet geïnitieerd door de gebruiker

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

Herstelbare SQL-resources

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

Eigenschapsnaam Beschrijving
databaseName De naam van de SQL-database.
collectionNames De lijst met SQL-containers onder deze database.

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

Herstelbare 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 erachter moet komen wanneer die gebeurtenis heeft plaatsgevonden.

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis heeft plaatsgevonden.
ownerId De naam van de MongoDB-database.
ownerResourceId De resource-id van de MongoDB-database.
operationType Het bewerkingstype van deze database-gebeurtenis.

Notitie

Mogelijke waarden voor operationType onder andere:

  • Create: gebeurtenis voor het maken van database
  • Delete: gebeurtenis voor databaseverwijdering
  • Replace: gebeurtenis voor databasewijziging
  • SystemOperation: databasewijzigingsgebeurtenis geactiveerd door het systeem. Deze gebeurtenis wordt niet geïnitieerd door de gebruiker

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

Herstelbare MongoDB-verzameling

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het maken en verwijderen van de MongoDB-verzameling. Deze informatie kan helpen in scenario's waarin de verzameling is gewijzigd of verwijderd en de gebruiker erachter moet komen wanneer die gebeurtenis heeft plaatsgevonden.

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze verzamelings gebeurtenis heeft plaatsgevonden.
ownerId De naam van de MongoDB-verzameling.
ownerResourceId De resource-id van de MongoDB-verzameling.
operationType Het bewerkingstype van deze verzamelingsevenement.

Notitie

Mogelijke waarden voor operationType onder andere:

  • Create: gebeurtenis voor het maken van verzameling
  • Delete: verzamelingsverwijderingsevenement
  • Replace: gebeurtenis voor verzamelingswijziging
  • SystemOperation: wijzigingsgebeurtenis van verzameling geactiveerd door het systeem. Deze gebeurtenis wordt niet geïnitieerd door de gebruiker

Zie Herstelbare MongoDB-resources - lijst voor een lijst met alle containermutaties onder dezelfde database.

Herstelbare MongoDB-resources

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

Eigenschapsnaam Beschrijving
databaseName De naam van de MongoDB-database.
collectionNames De lijst met MongoDB-verzamelingen onder deze database.

Zie Herstelbare MongoDB-resources - lijst voor een lijst met alle MongoDB-database- en -verzamelingscombinaties die aanwezig zijn in het account op de opgegeven tijdstempel en locatie.

Herstelbare Graph-resources

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

Eigenschapsnaam Beschrijving
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 Gremlin-database- en grafiekcombinaties die aanwezig zijn in het account op de opgegeven tijdstempel en locatie.

Herstelbare Graph-database

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

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis heeft plaatsgevonden.
ownerId De naam van de Graph-database.
ownerResourceId De resource-id van de Graph-database.
operationType Het bewerkingstype van deze database-gebeurtenis.

Notitie

Mogelijke waarden voor operationType onder andere:

  • Create: gebeurtenis voor het maken van database
  • Delete: gebeurtenis voor databaseverwijdering
  • Replace: gebeurtenis voor databasewijziging
  • SystemOperation: databasewijzigingsgebeurtenis geactiveerd door het systeem. Deze gebeurtenis wordt niet gestart door de gebruiker.

Zie Herstelbare grafiekdatabases - lijst voor een gebeurtenisfeed van alle mutaties in de Gremlin-database.

Herstelbare grafieken

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

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze verzamelings gebeurtenis heeft plaatsgevonden.
ownerId De naam van de Graph-verzameling.
ownerResourceId De resource-id van de Graph-verzameling.
operationType Het bewerkingstype van deze verzamelingsevenement.

Notitie

Mogelijke waarden voor operationType onder andere:

  • Create: Gebeurtenis voor het maken van grafieken
  • Delete: Grafiekverwijderingsevenement
  • Replace: Gebeurtenis voor grafiekwijziging
  • SystemOperation: gebeurtenis voor het wijzigen van de verzameling die wordt geactiveerd door het systeem. Deze gebeurtenis wordt niet gestart door de gebruiker.

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

Resources voor restorable table

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

Eigenschapsnaam Beschrijving
TableNames De lijst met Tabelcontainers onder dit account.

Zie het artikel Restorable Table Resources - List (Resources voor restorable table - List ) voor informatie over het ophalen van een lijst met tabellen die aanwezig zijn in het account bij de opgegeven tijdstempel en locatie.

Restorable Table

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

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis heeft plaatsgevonden.
ownerId De naam van de tabeldatabase.
ownerResourceId De resource-id van de tabelresource.
operationType Het bewerkingstype van deze Tabel-gebeurtenis.

Notitie

Mogelijke waarden voor operationType zijn onder andere:

  • Create: gebeurtenis voor het maken van tabellen
  • Delete: Tabelverwijderingsevenement
  • Replace: Tabelwijzigingsevenement
  • SystemOperation: databasewijzigingsgebeurtenis geactiveerd door het systeem. Deze gebeurtenis wordt niet geïnitieerd door de gebruiker

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

Volgende stappen