Resourcemodel voor de functie voor herstel naar een bepaald tijdstip van Azure Cosmos DB
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
, CreateMode
en 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/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 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 databasesDelete
: gebeurtenis voor het verwijderen van databasesReplace
: gebeurtenis voor databasewijzigingSystemOperation
: 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 containersDelete
: gebeurtenis voor het verwijderen van containersReplace
: gebeurtenis voor containerwijzigingSystemOperation
: 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 databasesDelete
: gebeurtenis voor het verwijderen van databasesReplace
: gebeurtenis voor databasewijzigingSystemOperation
: 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 verzamelingenDelete
: gebeurtenis voor het verwijderen van verzamelingenReplace
: gebeurtenis voor het wijzigen van verzamelingenSystemOperation
: 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 databasesDelete
: gebeurtenis voor het verwijderen van databasesReplace
: gebeurtenis voor databasewijzigingSystemOperation
: 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 grafiekenDelete
: Gebeurtenis voor het verwijderen van grafiekenReplace
: Gebeurtenis voor het wijzigen van grafiekenSystemOperation
: 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 tabellenDelete
: Gebeurtenis voor tabelverwijderingReplace
: Gebeurtenis voor tabelwijzigingSystemOperation
: 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
- Continue back-up inrichten met behulp van Azure Portal, PowerShell, CLI of Azure Resource Manager.
- Een account herstellen met behulp van Azure Portal, PowerShell, CLI of Azure Resource Manager.
- Migreren naar een account van periodieke back-up naar continue back-up.
- Machtigingen beheren die nodig zijn om gegevens te herstellen met de modus voor continue back-up.
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor