Resursmodell för Azure Cosmos DB-funktionen för återställning till tidpunkt

Artikel
08/15/2024

GÄLLER FÖR: NoSQL MongoDB Gremlin Bord

I den här artikeln beskrivs resursmodellen för Azure Cosmos DB-funktionen för återställning till tidpunkt. Den förklarar de parametrar som stöder kontinuerlig säkerhetskopiering och resurser som kan återställas. Den här funktionen stöds i Azure Cosmos DB API för SQL, Azure Cosmos DB API för Gremlin, Tabell-API och Azure Cosmos DB API för MongoDB.

Databaskontots resursmodell

Databaskontots resursmodell uppdateras med några extra egenskaper för att stödja de nya återställningsscenarierna. Dessa egenskaper är BackupPolicy, CreateModeoch RestoreParameters.

BackupPolicy

En ny egenskap i säkerhetskopieringsprincipen på kontonivå med namnet Type under parametern backuppolicy möjliggör kontinuerlig säkerhetskopiering och återställning till tidpunkt. Det här läget kallas kontinuerlig säkerhetskopiering. Du kan ange det här läget när du skapar kontot eller när du migrerar ett konto från periodiskt till kontinuerligt läge. När kontinuerligt läge har aktiverats har alla containrar och databaser som skapats i det här kontot återställning till tidpunkt och kontinuerlig säkerhetskopiering aktiverat som standard. Nivån för kontinuerlig säkerhetskopiering kan anges till Continuous7Days eller Continuous30Days. Om ingen nivå anges Continuous30Days tillämpas som standard på kontot.

Kommentar

För närvarande är funktionen för återställning till tidpunkt tillgänglig för Azure Cosmos DB för NoSQL-, API för MongoDB-, Table- och Gremlin-konton. När du har skapat ett konto med kontinuerligt läge kan du inte växla det till ett periodiskt läge. Nivån Continuous7Days är i förhandsversion.

CreateMode

Den här egenskapen anger hur kontot skapades. Möjliga värden är Standard och Återställ. Om du vill utföra en återställning anger du det här värdet till Återställ och anger lämpliga värden i egenskapen RestoreParameters .

publicNetworkAccess

Den här egenskapen måste vara inställd på "Inaktiverad" för att återställa kontot utan åtkomst till det offentliga nätverket. Om den här egenskapen inte anges fortsätter återställningen av kontot med publicNetworkAccess som Enabled.

RestoreParameters

Resursen RestoreParameters innehåller information om återställningsåtgärden, inklusive konto-ID, tid för återställning och resurser som måste återställas.

Egenskapsnamn	beskrivning
`restoreMode`	Återställningsläget ska vara `PointInTime`.
`restoreSource`	InstanceId för källkontot som återställningen ska initieras från.
`restoreTimestampInUtc`	Tidpunkt i UTC för att återställa kontot.
`databasesToRestore`	`DatabaseRestoreResource` Lista över objekt för att ange vilka databaser och containrar som ska återställas. Varje resurs representerar en enskild databas och alla samlingar under databasen. Mer information finns i Återställningsbara SQL-resurser. Om det här värdet är tomt återställs hela kontot.
`gremlinDatabasesToRestore`	`GremlinDatabaseRestoreResource` Lista över objekt för att ange vilka databaser och grafer som ska återställas. Varje resurs representerar en enskild databas och alla grafer under den databasen. Mer information finns i Återställningsbara Gremlin-resurser. Om det här värdet är tomt återställs hela kontot.
`restoreWithTtlDisabled`	booleska flaggvärden (sant/falskt) för att inaktivera Time-To-Live i det återställda kontot när återställningen har slutförts. (förhandsversion)
`tablesToRestore`	`TableRestoreResource` Lista över objekt för att ange vilka tabeller som ska återställas. Varje resurs representerar en tabell under databasen. Mer information finns i Återställningsbara tabellresurser. Om det här värdet är tomt återställs hela kontot.

Exempelresurs

Följande JSON är en exempeldatabaskontoresurs med kontinuerlig säkerhetskopiering aktiverad:

{
  "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"
      ...
    }
  }
}

Återställningsbara resurser

Det finns en uppsättning nya resurser och API:er som hjälper dig att identifiera viktig information om resurser, bland annat:

Där resurserna kan återställas
Platser där resurserna kan återställas från
Tidsstämplar när nyckelåtgärder utfördes på dessa resurser.

Kommentar

Alla API:ar som används för att räkna upp dessa resurser kräver följande behörigheter:

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

Återställningsbart databaskonto

Den här resursen innehåller en databaskontoinstans som kan återställas. Databaskontot kan antingen vara ett borttaget eller ett livekonto. Den innehåller information som gör att du kan hitta det källdatabaskonto som du vill återställa.

Egenskapsnamn	beskrivning
`ID`	Resursens unika identifierare.
`accountName`	Namnet på det globala databaskontot.
`creationTime`	Tiden i UTC när kontot skapades eller migrerades.
`deletionTime`	Tiden i UTC när kontot togs bort. Det här värdet är tomt om kontot är live.
`apiType`	API-typen för Azure Cosmos DB-kontot.
`restorableLocations`	Listan över platser där kontot fanns.
`restorableLocations: locationName`	Regionnamnet för det regionala kontot.
`restorableLocations: regionalDatabaseAccountInstanceId`	GUID för det regionala kontot.
`restorableLocations: creationTime`	Tiden i UTC när det regionala kontot skapades migrerades.
`restorableLocations: deletionTime`	Tiden i UTC när det regionala kontot togs bort. Det här värdet är tomt om det regionala kontot är live.
`OldestRestorableTimeStamp`	Den tidigaste tiden i UTC som återställning kan utföras till. För 30-dagarsnivån kan den här tiden vara högst 30 dagar från och med nu, för sjudagarsnivån kan den här tiden vara upp till sju dagar från och med nu.

En lista över alla återställningsbara konton finns i Artikeln Om återställningsbara databaskonton – lista eller Återställningsbara databaskonton – lista efter plats .

Återställningsbar SQL-databas

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i SQL Database. Den här informationen kan vara till hjälp i scenarier där databasen togs bort av misstag och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när databasen skapas eller tas bort.
`ownerId`	Namnet på SQL-databasen.
`ownerResourceId`	Resurs-ID för SQL-databasen,
`operationType`	Åtgärdstypen för den här databashändelsen.
`database`	Egenskaperna för SQL-databasen vid tidpunkten för händelsen,

Kommentar

Möjliga värden för operationType inkluderar:

Create: händelse för att skapa databas
Delete: databasborttagningshändelse
Replace: händelse för databasändring
SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren

En lista över alla databasmutationer finns i artikeln Restorable NoSQL Databases – List ( Återställningsbara NoSQL-databaser – lista).

Återställningsbar SQL-container

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i SQL-containern. Den här informationen kan vara till hjälp i scenarier där containern har ändrats eller tagits bort och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när den här containerhändelsen inträffade.
`ownerId`	Namnet på SQL-containern.
`ownerResourceId`	Resurs-ID för SQL-containern.
`operationType`	Åtgärdstypen för den här containerhändelsen.
`container`	Egenskaperna för SQL-containern vid tidpunkten för händelsen.

Kommentar

Möjliga värden för operationType inkluderar:

Create: händelse för att skapa container
Delete: händelse för borttagning av containrar
Replace: händelse för containerändring
SystemOperation: händelse för containerändring som utlöses av systemet. Den här händelsen initieras inte av användaren

Information om hur du hämtar en lista över alla containermutationer under samma databas finns i artikeln Återställbara NoSQL-containrar – lista .

Återställningsbara SQL-resurser

Varje resurs representerar en enskild databas och alla containrar under databasen.

Egenskapsnamn	beskrivning
`databaseName`	Namnet på SQL-databasen.
`collectionNames`	Listan över SQL-containrar under den här databasen.

En lista över SQL-databas- och containerkombinationer som finns på kontot vid den angivna tidsstämpeln och platsen finns i artikeln Återställningsbara NoSQL-resurser – lista .

Återställningsbar MongoDB-databas

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i MongoDB-databasen. Den här informationen kan vara till hjälp i scenariot där databasen togs bort av misstag och användaren måste ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när den här databashändelsen inträffade.
`ownerId`	Namnet på MongoDB-databasen.
`ownerResourceId`	Resurs-ID för MongoDB-databasen.
`operationType`	Åtgärdstypen för den här databashändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

Create: händelse för att skapa databas
Delete: databasborttagningshändelse
Replace: händelse för databasändring
SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren

En lista över alla databasmutationer finns i artikeln Restorable Mongodb Databases – List .

Återställningsbar MongoDB-samling

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i MongoDB-samlingen. Den här informationen kan vara till hjälp i scenarier där samlingen har ändrats eller tagits bort, och användaren måste ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när den här samlingshändelsen inträffade.
`ownerId`	Namnet på MongoDB-samlingen.
`ownerResourceId`	Resurs-ID för MongoDB-samlingen.
`operationType`	Åtgärdstypen för den här samlingshändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

Create: händelse för att skapa samling
Delete: händelse för borttagning av samling
Replace: händelse för insamlingsändring
SystemOperation: händelse för insamlingsändring som utlöses av systemet. Den här händelsen initieras inte av användaren

Information om hur du hämtar en lista över alla containermutationer under samma databas finns i avsnittet om återställningsbara MongoDB-resurser – lista.

Återställningsbara MongoDB-resurser

Varje resurs representerar en enskild databas och alla samlingar under databasen.

Egenskapsnamn	beskrivning
`databaseName`	Namnet på MongoDB-databasen.
`collectionNames`	Listan över MongoDB-samlingar under den här databasen.

Information om hur du hämtar en lista över alla MongoDB-databas- och samlingskombinationer som finns på kontot vid den angivna tidsstämpeln och platsen finns i avsnittet om återställningsbara MongoDB-resurser – lista.

Återställningsbara Graph-resurser

Varje resurs representerar en enskild databas och alla grafer under den databasen.

Egenskapsnamn	beskrivning
`gremlinDatabaseName`	Namnet på Graph-databasen.
`graphNames`	Listan över grafer under den här databasen.

En lista över alla Gremlin-databas- och grafkombinationer som finns på kontot vid den angivna tidsstämpeln och platsen finns i artikeln Restorable Graph Resources – List .

Återställningsbar Graph-databas

Varje resurs innehåller information om en mutationshändelse, till exempel en skapande och borttagning som inträffade i Graph-databasen. Den här informationen kan vara till hjälp i scenariot där databasen togs bort av misstag och användaren måste ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när den här databashändelsen inträffade.
`ownerId`	Namnet på Graph-databasen.
`ownerResourceId`	Resurs-ID för Graph-databasen.
`operationType`	Åtgärdstypen för den här databashändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

Create: händelse för att skapa databas
Delete: databasborttagningshändelse
Replace: händelse för databasändring
SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren.

Information om hur du hämtar en händelsefeed av alla mutationer i Gremlin-databasen finns i avsnittet om återställningsbara grafdatabaser – lista.

Återställningsbara diagram

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i graph. Den här informationen kan vara till hjälp i scenarier där diagrammet ändrades eller togs bort och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när den här samlingshändelsen inträffade.
`ownerId`	Namnet på Graph-samlingen.
`ownerResourceId`	Resurs-ID för Graph-samlingen.
`operationType`	Åtgärdstypen för den här samlingshändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

Create: Händelse för att skapa diagram
Delete: Händelse för grafborttagning
Replace: Händelse för grafändring
SystemOperation: händelse för insamlingsändring som utlöses av systemet. Den här händelsen initieras inte av användaren.

Information om hur du hämtar en lista över alla containermutationer under samma databas finns i artikeln Graph Restorable Graphs – List .

Återställningsbara tabellresurser

Visar en lista över alla återställningsbara Azure Cosmos DB-tabeller som är tillgängliga för ett specifikt databaskonto vid en viss tidpunkt och plats. Observera att API:et för tabell inte anger någon explicit databas.

Egenskapsnamn	beskrivning
`TableNames`	Listan över tabellcontainrar under det här kontot.

Information om hur du hämtar en lista över tabeller som finns på kontot vid den angivna tidsstämpeln och platsen finns i artikeln Återställningsbara tabellresurser – lista .

Återställningsbar tabell

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i tabellen. Den här informationen kan vara till hjälp i scenarier där tabellen har ändrats eller tagits bort och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn	beskrivning
`eventTimestamp`	Tiden i UTC när den här databashändelsen inträffade.
`ownerId`	Namnet på tabelldatabasen.
`ownerResourceId`	Resurs-ID för tabellresursen.
`operationType`	Åtgärdstypen för den här tabellhändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

Create: Händelse för att skapa tabell
Delete: Händelse för tabellborttagning
Replace: Händelse för tabelländring
SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren

Information om hur du hämtar en lista över alla tabellmutationer under samma databas finns i artikeln Återställbar tabell – lista .

Nästa steg

Etablera kontinuerlig säkerhetskopiering med Hjälp av Azure-portalen, PowerShell, CLI eller Azure Resource Manager.
Återställa ett konto med Hjälp av Azure-portalen, PowerShell, CLI eller Azure Resource Manager.
Migrera till ett konto från periodisk säkerhetskopiering till kontinuerlig säkerhetskopiering.
Hantera behörigheter som krävs för att återställa data med läget för kontinuerlig säkerhetskopiering.

Dela via

Resursmodell för Azure Cosmos DB-funktionen för återställning till tidpunkt

Databaskontots resursmodell

BackupPolicy

CreateMode

publicNetworkAccess

RestoreParameters

Exempelresurs

Återställningsbara resurser

Återställningsbart databaskonto

Återställningsbar SQL-databas

Återställningsbar SQL-container

Återställningsbara SQL-resurser

Återställningsbar MongoDB-databas

Återställningsbar MongoDB-samling

Återställningsbara MongoDB-resurser

Återställningsbara Graph-resurser

Återställningsbar Graph-databas

Återställningsbara diagram

Återställningsbara tabellresurser

Återställningsbar tabell

Nästa steg

Feedback

Ytterligare resurser