Periodieke back-upopslagredundantie bijwerken voor Azure Cosmos DB

VAN TOEPASSING OP: NoSQL MongoDB Cassandra Gremlin Tafel

Back-upgegevens van de azure Cosmos DB-periodemodus worden op verschillende manieren gerepliceerd. Als de primaire regio gekoppelde regio's ondersteunt, slaat Azure Cosmos DB standaard periodieke back-upgegevens op in geografisch redundante blobopslag die naar het paar wordt gerepliceerd. U kunt de standaardredundantie voor back-upopslag overschrijven. Als u een niet-gekoppelde regio gebruikt, moet u ook expliciet de redundantie van de back-upopslag kiezen. In dit artikel wordt uitgelegd hoe u de redundantie van back-upopslag bijwerkt met behulp van Azure CLI en PowerShell. U ziet ook hoe u een Azure-beleid voor uw accounts configureert om de vereiste opslagredundantie af te dwingen.

Vereisten

• Een bestaand Azure Cosmos DB-account.
  • Als u een Azure-abonnement hebt, maakt u een nieuw account.
  • Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
  • U kunt azure Cosmos DB ook gratis proberen voordat u zich doorvoert.

Opslagredundantie bijwerken

Gebruik de volgende stappen om redundantie van back-upopslag bij te werken.

Azure-portal

1. Meld u aan bij Azure Portal en navigeer naar uw Azure Cosmos DB-account.

2. Open het deelvenster Back-up en herstel , werk de redundantie van de back-upopslag bij en selecteer Verzenden. Het duurt enkele minuten voordat de bewerking is voltooid.

   

Azure-CLI

1. Zorg ervoor dat u de nieuwste versie van Azure CLI of een versie hoger dan of gelijk aan 2.30.0 hebt. Als u de cosmosdb-preview extensie hebt geïnstalleerd, moet u deze verwijderen.

2. Gebruik de az cosmosdb locations show opdracht om de opties voor back-upredundantie op te halen die beschikbaar zijn in de regio's waar uw account zich bevindt.

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

   De uitvoer moet JSON bevatten die vergelijkbaar is met dit voorbeeld:

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

   Notitie

   De vorige opdracht toont een lijst met back-upredundantie die beschikbaar is in de specifieke regio. Ondersteunde waarden worden weergegeven in de backupStorageRedundancies eigenschap. Sommige regio's ondersteunen bijvoorbeeld maximaal drie redundantieopties: Geo, Zone en Lokaal. Andere regio's ondersteunen mogelijk een subset van deze opties. Voordat u het bijwerkt, kiest u de optie voor redundantie van back-upopslag die wordt ondersteund in alle regio's die uw Azure Cosmos DB-account gebruikt.

3. Gebruik de az cosmosdb update opdracht met de gekozen optie voor back-upredundantie om de back-upredundantie voor een bestaand account bij te werken.

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

4. U kunt ook de az cosmosdb create opdracht gebruiken om een nieuw account te maken met de gekozen optie voor back-upredundantie.

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

Azure PowerShell

1. Installeer de nieuwste versie van Azure PowerShell of een versie hoger dan of gelijk aan 1.4.0.

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

2. Gebruik de Get-AzCosmosDBLocation cmdlet om de opties voor back-upredundantie op te halen die beschikbaar zijn in de regio's waar uw account zich bevindt.

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

   De uitvoer moet inhoud bevatten die vergelijkbaar is met dit voorbeeld:

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

   Notitie

   De vorige opdracht toont een lijst met back-upredundantie die beschikbaar is in de specifieke regio. Ondersteunde waarden worden weergegeven in de BackupStorageRedundancies eigenschap. Sommige regio's ondersteunen bijvoorbeeld maximaal drie redundantieopties: Geo, Zone en Lokaal. Andere regio's ondersteunen mogelijk een subset van deze opties. Voordat u het bijwerkt, kiest u de optie voor redundantie van back-upopslag die wordt ondersteund in alle regio's die uw Azure Cosmos DB-account gebruikt.

3. Gebruik de Update-AzCosmosDBAccount cmdlet met de gekozen optie voor back-upredundantie om de back-upredundantie voor een bestaand account bij te werken:

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

4. U kunt ook de New-AzCosmosDBAccount cmdlet gebruiken om een nieuw account te maken met de gekozen optie voor back-upredundantie:

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

Een Azure Policy toevoegen voor redundantie van back-upopslag

Met Azure Policy kunt u organisatiestandaarden afdwingen en naleving op schaal beoordelen. Zie voor meer informatie wat Azure Policy is?

In het volgende voorbeeld ziet u hoe u een Azure-beleid voor Azure Cosmos DB-accounts toevoegt om te valideren (met behulp van audit) dat de back-upredundantie is geconfigureerd voor Local.

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

Volgende stappen

Het back-upinterval en de bewaarperiode wijzigen