Migrera ett Azure Cosmos DB-konto från periodiskt till kontinuerligt säkerhetskopieringsläge

  • Artikel

GÄLLER FÖR: Nosql Mongodb Gremlin Tabell

Azure Cosmos DB-konton med säkerhetskopieringsprinciper för periodiskt läge kan migreras till kontinuerligt läge med hjälp av Azure-portalen, CLI, PowerShell eller Resource Manager-mallar. Migrering från periodiskt läge till kontinuerligt läge är en enkelriktad migrering och kan inte ångras. När du har migrerat från periodiskt till kontinuerligt läge kan du använda fördelarna med kontinuerligt läge.

Det här är de viktigaste anledningarna till att migrera till kontinuerligt läge:

  • Möjligheten att utföra självbetjänad återställning med hjälp av Azure-portalen, CLI eller PowerShell.
  • Möjligheten att återställa vid tidskornighet för en sekund under det senaste 30- eller 7-dagarsfönstret.
  • Möjligheten att se till att säkerhetskopieringen är konsekvent i olika omfattningar eller partitionsnyckelintervall inom en period.
  • Möjligheten att återställa container, databas eller det fullständiga kontot när det tas bort eller ändras.
  • Möjlighet att välja händelser för containern, databasen eller kontot och bestämma när återställningen ska initieras.

Kommentar

Migreringsfunktionen är enkelriktad och det är en oåterkallelig åtgärd. Vilket innebär att när du migrerar från periodiskt läge till kontinuerligt läge kan du inte växla tillbaka till periodiskt läge.

Du kan bara migrera ett konto till läget för kontinuerlig säkerhetskopiering om följande villkor är uppfyllda. Checka också ut begränsningar för återställning till tidpunkt innan du migrerar ditt konto:

  • Om kontot är av typen API för NoSQL, API för Table, Gremlin eller API för MongoDB.
  • Om kontot har en enda skrivregion.
  • Om kontot inte är aktiverat med analysarkivet.

Om kontot använder kundhanterade nycklar måste en hanterad identitet (systemtilldelad eller användartilldelad) deklareras i key vault-åtkomstprincipen och måste anges som standardidentitet för kontot.

Behörigheter

För att utföra migreringen behöver Microsoft.DocumentDB/databaseAccounts/write du behörighet för det konto som migreras.

Prissättning efter migrering

När du har migrerat ditt konto till läget för kontinuerlig säkerhetskopiering kan kostnaden ändras jämfört med det periodiska säkerhetskopieringsläget. Nivåvalet på 30 dagar jämfört med sju dagar påverkar också kostnaden för säkerhetskopieringen. Mer information finns i prissättningen för kontinuerligt säkerhetskopieringsläge.

Migrera med hjälp av portalen

Använd följande steg för att migrera ditt konto från periodisk säkerhetskopiering till läget för kontinuerlig säkerhetskopiering:

  1. Logga in på Azure-portalen.

  2. Gå till ditt Azure Cosmos DB-konto och öppna fönstret Säkerhetskopiering och återställning . Välj fliken Säkerhetskopieringsprinciper och välj vid ändring. När du har valt målläge för kontinuerlig användning väljer du Spara.

    Migrate to continuous mode using Azure portal

  3. När migreringen pågår visas principinställningar för uppdatering av säkerhetskopiering i popup-fönstret. Om du väljer det meddelandet kan du se Uppdatera på kontonivå och Migrera för säkerhetskopieringsprincip vid översikt över kontot. När den är klar skulle säkerhetskopieringsprincipen ha växlat till den valda nivån i kontinuerligt läge. Migreringstiden beror på storleken på data i ditt konto.

    Check the status of migration from Azure portal

Migrera med hjälp av PowerShell

  1. Installera den senaste versionen av Azure PowerShell eller någon version som är högre än 6.2.0.

  2. Om du vill använda Continous7Days läge för etablering eller migrering måste du använda förhandsversionen av cosmosdb tillägget. Använda Install-Module -Name Az.CosmosDB -AllowPrerelease

  3. Kör sedan följande steg:

    1. Anslut till ditt Azure-konto:

      Connect-AzAccount

    2. Migrera ditt konto från periodiskt till kontinuerligt säkerhetskopieringsläge med continuous30days nivå eller continuous7days dagar. Om ett nivåvärde inte anges antas det vara continuous30days:

      Update-AzCosmosDBAccount ` 
   -ResourceGroupName "myrg" ` 
   -Name "myAccount" `
   -BackupPolicyType "Continuous"

         Update-AzCosmosDBAccount ` 
   -ResourceGroupName "myrg" ` 
   -Name "myAccount" `
   -BackupPolicyType "Continuous" `
   -ContinuousTier "Continuous7Days"

Migrera med CLI

  1. Installera den senaste versionen av Azure CLI:
  • Om du inte redan har Installerat Azure CLI kan du läsa installera Azure CLI. Du kan också använda Azure Cloud Shell från Azure-portalen.

  1. Logga in på ditt Azure-konto och kör följande kommando för att migrera ditt konto till kontinuerligt läge:

    az login

  2. Migrera kontot till continuous30days eller continuous7days nivån. Om nivåvärdet inte anges antas det vara continuous30days:

    az cosmosdb update -n <myaccount> -g <myresourcegroup> --backup-policy-type continuous

    az cosmosdb update -g "my-rg" -n "my-continuous-backup-account" --backup-policy-type "Continuous" --continuous-tier "Continuous7Days"

  3. När migreringen har slutförts visar backupPolicy utdata objektet, som innehåller type egenskapen med värdet Continuous.

     {
   "apiProperties": null,
   "backupPolicy": {
        "continuousModeProperties": {
                "tier": "Continuous7Days"
        },
        "migrationState": null,
        "type": "Continuous"
   },
      …
 }

Kontrollera migreringsstatusen

Kör följande kommando och kontrollera egenskaperna status och targetType för objektet backupPolicy . Statusen är pågående när migreringen har startat:

az cosmosdb show -n "myAccount" -g "myrg"

Check the migration status using PowerShell command

När migreringen är klar ändras säkerhetskopieringstypen till Kontinuerlig och visar den valda nivån. Om ingen nivå angavs skulle nivån vara inställd på Continuous30Days. Kör samma kommando igen för att kontrollera statusen:

az cosmosdb show -n "myAccount" -g "myrg"

Backup type changes to continuous after the migration is complete

Migrera från periodiskt läge till kontinuerligt läge med hjälp av Resource Manager-mall

Om du vill migrera till läget för kontinuerlig säkerhetskopiering med hjälp av ARM-mallen letar du upp avsnittet backupPolicy i mallen och uppdaterar type egenskapen. Om din befintliga mall till exempel har en säkerhetskopieringsprincip som följande JSON-objekt:

"backupPolicy": {
   "type": "Periodic",
   "periodicModeProperties": {
   "backupIntervalInMinutes": 240,
   "backupRetentionIntervalInHours": 8
   }
}

Ersätt det med följande JSON-objekt:

"backupPolicy": { 
   "type": "Continuous", 
   "continuousModeProperties": { 
      "tier": "Continuous7Days" 
    } 
}

Distribuera sedan mallen med hjälp av Azure PowerShell eller CLI. I följande exempel visas hur du distribuerar mallen med ett CLI-kommando:

az deployment group create -g <ResourceGroup> --template-file <ProvisionTemplateFilePath>

Ändra nivåerna för kontinuerligt läge

Du kan växla mellan Continuous30Days och Continous7Days i Azure PowerShell, Azure CLI eller Azure-portalen.

I portalen för det angivna Azure Cosmos DB-kontot väljer du Fönstret Återställning till tidpunkt, väljer på ändringslänk bredvid Säkerhetskopieringsprincipläge för att visa alternativet Kontinuerlig (30 dagar) eller Kontinuerlig (7 dagar). Välj det mål som krävs och välj på Spara.

Screenshot of dialog to select tier of continuous mode.

Följande Azure CLI-kommando visar hur du växlar ett befintligt konto till Continous7Days:

az cosmosdb update \ 
    --resource-group "my-rg" \ 
    --name "my-continuous-backup-account" \ 
    --backup-policy-type "Continuous" \ 
    --continuous-tier "Continuous7Days"

Följande Azure PowerShell-kommando visar hur du växlar ett befintligt konto till Continous7Days:

Update-AzCosmosDBAccount ` 
    -ResourceGroupName "myrg" ` 
    -Name "myAccount" `
    -BackupPolicyType Continuous `
    -ContinuousTier Continuous7Days

Du kan också använda en ARM-mall i en metod som liknar att använda Azure CLI och Azure PowerShell.

Kommentar

När du byter från nivån 30 till 7 dagar är möjligheten att återställa mer än 7 dagar i historien omedelbart otillgänglig. När du byter från nivån 7 till 30 dagar kan du inte återställa mer än 7 dagar omedelbart. Den tidigaste tiden för återställning kan extraheras från kontometadata som är tillgängliga via Azure Powershell eller Azure CLI. Prispåverkan vid växling mellan nivåerna 7 och 30 dagar skulle också vara omedelbart synlig.

Vad kan man förvänta sig under och efter migreringen?

När du migrerar från periodiskt läge till kontinuerligt läge kan du inte köra några kontrollplansåtgärder som utför uppdateringar eller borttagningar på kontonivå. Åtgärder som att lägga till eller ta bort regioner, redundansväxling av konton, uppdatera säkerhetskopieringsprinciper osv. kan till exempel inte köras medan migreringen pågår. Tiden för migrering beror på storleken på data och antalet regioner i ditt konto. Återställningsåtgärden för de migrerade kontona lyckas bara från den tidpunkt då migreringen har slutförts.

Du kan återställa ditt konto när migreringen har slutförts. Om migreringen slutförs kl. 13:00 PST kan du återställa tidpunkten från 13:00 PST.

Vanliga frågor och svar

Sker migreringen bara på kontonivå?

Ja.

Vilka konton kan användas för migrering av säkerhetskopiering?

För närvarande stöder API för NoSQL, API för Tabell, Gremlin API och API för MongoDB-konton med en enda skrivregion som har migrering av delat, etablerat eller autoskalningsetablerad dataflöde.

Konton som är aktiverade med analyslagring och regioner med flera skrivningar stöds inte för migrering.

Tar migreringen tid? Vad är den typiska tiden?

Migreringen tar en varierande tid som till stor del beror på storleken på data och antalet regioner i ditt konto. Du kan hämta migreringsstatusen med hjälp av Azure CLI- eller PowerShell-kommandon. För stora konton med tiotals terabyte data kan migreringen ta upp till några dagar att slutföra.

Orsakar migreringen någon tillgänglighetspåverkan/stilleståndstid?

Nej, migreringsåtgärden sker i bakgrunden. Därför påverkas inte klientbegäranden. Vi måste dock utföra vissa serverdelsåtgärder under migreringen, och det kan ta extra tid om kontot är hårt belastat.

Vad händer om migreringen misslyckas? Kommer jag fortfarande att få periodiska säkerhetskopior eller få kontinuerliga säkerhetskopior?

När migreringsprocessen har startats aktiveras kontot i kontinuerligt läge. Om migreringen misslyckas måste du initiera migreringen igen tills den lyckas.

Hur gör jag för att utföra en återställning till en tidsstämpel före/under/efter migreringen?

Anta att du har påbörjat migreringen vid t1 och slutfört vid t5. Du kan inte använda en återställningstidsstämpel mellan t1 och t5.

Anta också att ditt konto nu är i kontinuerligt läge. Om du vill återställa till en tid efter t5utför du återställningen med Hjälp av Azure-portalen, CLI eller PowerShell som normalt med ett kontinuerligt konto. Den här självbetjäningsåterställningsbegäran kan bara göras när migreringen har slutförts.

Om du vill återställa till en tid före t1kan du öppna ett supportärende som vanligt med ett periodiskt säkerhetskopieringskonto. Efter migreringen har du upp till 30 dagar på dig att utföra den periodiska återställningen. Under dessa 30 dagar kan du återställa baserat på kvarhållning/intervall för säkerhetskopior för ditt konto före migreringen. Om säkerhetskopian till exempel har konfigurerats för att behålla 24 kopior med 1 timmes intervall kan du återställa till när som helst mellan (t1 – 24 hours) och t1.

Vilka kontrollplansåtgärder på kontonivå blockeras under migreringen?

Åtgärder som att lägga till/ta bort region, redundans, ändra säkerhetskopieringsprincip och eventuella dataflödesändringar som resulterar i dataförflyttning blockeras under migreringen.

Om migreringen misslyckas för något underliggande problem, skulle den fortfarande blockera kontrollplansåtgärden tills den har gjorts om och slutförts?

Misslyckad migrering blockerar inte några kontrollplansåtgärder. Om migreringen misslyckas rekommenderar vi att du försöker igen tills den lyckas innan du utför andra kontrollplansåtgärder.

Går det att avbryta migreringen?

Det går inte att avbryta migreringen eftersom migreringar inte är en reversibel åtgärd.

Finns det något verktyg som kan hjälpa dig att uppskatta migreringstiden baserat på dataanvändningen och antalet regioner?

Det finns inget verktyg för att uppskatta tid. Våra tester och skalningskörningar indikerar att ett enskilt regionkonto med 1 TB data tar ungefär 90 minuter.

För konton i flera regioner beräknar du den totala datastorleken som Number_of_regions * Data_in_single_region.

Eftersom läget för kontinuerlig säkerhetskopiering nu är ALLMÄNT rekommenderar du fortfarande att du återställer en kopia av ditt konto? Rekommenderar du att du försöker migrera kopian innan du bestämmer dig för att migrera produktionskontot?

Vi rekommenderar att du testar funktionen för kontinuerligt säkerhetskopieringsläge för att se att den fungerar som förväntat innan du migrerar produktionskonton. Migrering är en enkelriktad åtgärd och är inte reversibel.

Nästa steg

Mer information om läget för kontinuerlig säkerhetskopiering finns i följande artiklar: