Delen via

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

  • Artikel

VAN TOEPASSING OP: NoSQL MongoDB Gremlin Tafel

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, 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.

Notitie

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 preview.

CreateMode

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.

Eigenschapsnaam Beschrijving
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 restorable Gremlin-resources voor meer informatie. 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. (preview)
tablesToRestore Lijst met TableRestoreResource objecten om op te geven welke tabellen moeten worden hersteld. Elke resource vertegenwoordigt een tabel onder die database. Zie tabelresources die u kunt herstellen 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",
    "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"
      ...
    }
  }
}

Restorable resources

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

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

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 databaseaccount

Deze resource bevat een databaseaccountexemplaren die kunnen 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 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 Restorable Database Accounts - list or Restorable Database Accounts - list or Restorable Database Accounts- list by location articles 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.

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 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.

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze container gebeurtenis is opgetreden.
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 zijn operationType onder andere:

  • Create: gebeurtenis voor het maken van containers
  • Delete: gebeurtenis voor het verwijderen van containers
  • Replace: gebeurtenis voor 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.

Restorable 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 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.

Eigenschapsnaam Beschrijving
eventTimestamp De tijd in UTC waarop deze database-gebeurtenis is opgetreden.
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 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, 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 moet achterhalen wanneer die gebeurtenis is opgetreden.

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

Notitie

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, raadpleegt u de restorable MongoDB-resources - lijst.

Restorable 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.

Als u een lijst wilt ophalen van alle Combinaties van MongoDB-databases en -verzamelingen 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.

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 combinaties van Gremlin-databases en grafieken die in het account aanwezig zijn op het account.

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.

Eigenschapsnaam Beschrijving
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 database-gebeurtenis.

Notitie

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.

Als u een gebeurtenisfeed wilt krijgen van alle mutaties op de Gremlin-database, raadpleegt u de lijst met restorable grafiekdatabases.

Restorable Graphs

Elke resource bevat informatie over een mutatiegebeurtenis, zoals het maken en verwijderen van gebeurtenissen in 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.

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

Notitie

Mogelijke waarden zijn operationType onder andere:

  • Create: Gebeurtenis voor het maken van grafieken
  • Delete: Gebeurtenis voor het verwijderen van grafieken
  • Replace: Gebeurtenis voor het wijzigen van grafieken
  • 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.

Eigenschapsnaam Beschrijving
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.

Tabel die kan worden geplaatst

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

Eigenschapsnaam Beschrijving
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.

Notitie

Mogelijke waarden zijn operationType onder andere:

  • Create: Gebeurtenis voor het maken van tabellen
  • Delete: Gebeurtenis voor tabelverwijdering
  • Replace: Gebeurtenis voor 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