Uppdatera periodisk redundans för lagring av säkerhetskopior för Azure Cosmos DB

GÄLLER FÖR: NoSQL MongoDB Kassandra Gremlin Bord

Säkerhetskopieringsdata i Azure Cosmos DB-periodläge replikeras på olika sätt. Om den primära regionen stöder parkopplade regioner lagrar Azure Cosmos DB som standard säkerhetskopieringsdata i periodiskt läge i geo-redundant bloblagring som replikeras till paret. Du kan åsidosätta standardredundansen för lagring av säkerhetskopior. Om du använder en icke-länkad region måste du också uttryckligen välja redundans för lagring av säkerhetskopior. Den här artikeln beskriver hur du uppdaterar redundansen för lagring av säkerhetskopior med hjälp av Azure CLI och PowerShell. Den visar också hur du konfigurerar en Azure-princip på dina konton för att framtvinga nödvändig lagringsredundans.

Förutsättningar

• Ett befintligt Azure Cosmos DB-konto.
  • Om du har en Azure-prenumeration skapar du ett nytt konto.
  • Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
  • Du kan också prova Azure Cosmos DB kostnadsfritt innan du checkar in.

Uppdatera lagringsredundans

Använd följande steg för att uppdatera redundans för lagring av säkerhetskopior.

Azure-portalen

1. Logga in på Azure Portal och gå till ditt Azure Cosmos DB-konto.

2. Öppna fönstret Säkerhetskopiering och återställning , uppdatera redundansen för lagring av säkerhetskopior och välj Skicka. Det tar några minuter innan åtgärden har slutförts.

   

Azure CLI

1. Se till att du har den senaste versionen av Azure CLI eller en version som är högre än eller lika med 2.30.0. Om du har cosmosdb-preview tillägget installerat måste du ta bort det.

2. az cosmosdb locations show Använd kommandot för att hämta alternativen för säkerhetskopieringsredundans i de regioner där ditt konto finns.

   az cosmosdb locations show \
         --location <region-name>
   

   Utdata bör innehålla JSON som liknar det här exemplet:

   {
     "id": "subscriptionId/<Subscription_ID>/providers/Microsoft.DocumentDB/locations/eastus/",
     "name": "East US",
     "properties": {
       "backupStorageRedundancies": [
         "Geo",
         "Zone",
         "Local"
       ],
       "isResidencyRestricted": false,
       "supportsAvailabilityZone": true
     },
     "type": "Microsoft.DocumentDB/locations"
   }
   

   Kommentar

   Föregående kommando visar en lista över tillgängliga säkerhetskopieringsredundanser i den specifika regionen. Värden som stöds visas i egenskapen backupStorageRedundancies . Vissa regioner kan till exempel ha stöd för upp till tre redundansalternativ: Geo, Zon och Lokal. Andra regioner kan ha stöd för en delmängd av dessa alternativ. Innan du uppdaterar väljer du alternativet för redundans för säkerhetskopieringslagring som stöds i alla regioner som ditt Azure Cosmos DB-konto använder.

3. az cosmosdb update Använd kommandot med det valda alternativet för säkerhetskopieringsredundans för att uppdatera redundansen för säkerhetskopiering på ett befintligt konto.

   az cosmosdb update \
       --resource-group <resource-group-name> \
       --name <account_name> \
       --backup-redundancy Zone
   

4. Du kan också använda az cosmosdb create kommandot för att skapa ett nytt konto med det valda alternativet för säkerhetskopieringsredundans.

   az cosmosdb create \
       --resource-group <resource-group-name> \
       --name <account-name> \
       --backup-redundancy Geo \
       --locations regionName=<azure-region>
   

Azure PowerShell

1. Installera den senaste versionen av Azure PowerShell eller en version som är högre än eller lika med 1.4.0.

   $parameters = @{
       Name = "Az.CosmosDB"
       RequiredVersion = "1.4.0"
   }
   Install-Module @parameters
   

2. Använd cmdleten Get-AzCosmosDBLocation för att hämta alternativen för säkerhetskopieringsredundans i de regioner där ditt konto finns.

   $parameters = @{
       Location = "<azure-region>"
   }
   (Get-AzCosmosDBLocation @parameters).Properties
   

   Utdata bör innehålla innehåll som liknar det här exemplet:

   SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
   ------------------------ --------------------- -------------------------
                       True                 False {Geo, Zone, Local}
   

   Kommentar

   Föregående kommando visar en lista över tillgängliga säkerhetskopieringsredundanser i den specifika regionen. Värden som stöds visas i egenskapen BackupStorageRedundancies . Vissa regioner kan till exempel ha stöd för upp till tre redundansalternativ: Geo, Zon och Lokal. Andra regioner kan ha stöd för en delmängd av dessa alternativ. Innan du uppdaterar väljer du alternativet för redundans för säkerhetskopieringslagring som stöds i alla regioner som ditt Azure Cosmos DB-konto använder.

3. Använd cmdleten Update-AzCosmosDBAccount med det valda alternativet för säkerhetskopieringsredundans för att uppdatera redundansen för säkerhetskopiering på ett befintligt konto:

   $parameters = @{
       ResourceGroupName "<resource-group-name>"
       Name = "<account-name>"
       BackupStorageRedundancy = "Zone"
   }
   Update-AzCosmosDBAccount @parameters
   

4. Du kan också använda cmdleten New-AzCosmosDBAccount för att skapa ett nytt konto med det valda alternativet för säkerhetskopieringsredundans:

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       Location = "<azure-region>"
       BackupPolicyType = "Periodic"
       BackupStorageRedundancy = "Geo"
   }
   New-AzCosmosDBAccount @parameters
   

Lägga till en Azure Policy för redundans för lagring av säkerhetskopior

Azure Policy hjälper dig att framtvinga organisationsstandarder och utvärdera efterlevnad i stor skala. Mer information finns i Vad är Azure Policy?.

Följande exempel visar hur du lägger till en Azure-princip för Azure Cosmos DB-konton för att verifiera (med ) auditatt deras säkerhetskopieringsredundans har konfigurerats till Local.

"parameters": {},
"policyRule": {
  "if": {
    "allOf": [
      {
        "field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
        "match": "Local"
      }
    ]
  },
  "then": {
    "effect": "audit"
  }
}

Nästa steg

Ändra säkerhetskopieringsintervallet och kvarhållningsperioden