Periodiek back-upinterval en retentieperiode wijzigen in Azure Cosmos DB

Artikel
08/15/2024

VAN TOEPASSING OP: NoSQL MongoDB Cassandra Gremlin Tafel

Azure Cosmos DB maakt elke 4 uur automatisch een volledige back-up van uw gegevens en op elk moment worden de laatste twee back-ups opgeslagen. Deze configuratie is de standaardoptie en wordt zonder extra kosten aangeboden. U kunt het standaardback-upinterval en de retentieperiode wijzigen tijdens het maken van het Azure Cosmos DB-account of nadat het account is gemaakt. De back-upconfiguratie wordt ingesteld op het niveau van het Azure Cosmos DB-account en u moet deze configureren voor elk account. Nadat u de back-upopties voor een account hebt geconfigureerd, wordt deze toegepast op alle containers binnen dat account. U kunt deze instellingen wijzigen met behulp van Azure Portal, Azure PowerShell of De Azure CLI.

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.

Voordat u begint

Als u uw gegevens per ongeluk hebt verwijderd of beschadigd, moet u, voordat u een ondersteuningsaanvraag voor het herstellen van de gegevens maakt, ervoor zorgen dat u de back-upretentie voor uw account verhoogt tot ten minste zeven dagen. Het is raadzaam om uw retentie binnen 8 uur na deze gebeurtenis te verhogen. Op deze manier heeft het Azure Cosmos DB-team voldoende tijd om uw account te herstellen.

Back-upopties voor een bestaand account wijzigen

Gebruik de volgende stappen om de standaardback-upopties voor een bestaand Azure Cosmos DB-account te wijzigen.

Meld u aan bij het Azure-portaal.
Navigeer naar uw Azure Cosmos DB-account en open het deelvenster Back-up en herstel . Werk het back-upinterval en de bewaarperiode van de back-up zo nodig bij.
- Back-upinterval : dit is het interval waarmee Azure Cosmos DB een back-up van uw gegevens probeert te maken. Het maken van een back-up duurt enige tijd en in sommige gevallen kan dit mislukken vanwege downstreamafhankelijkheden. Azure Cosmos DB probeert het beste een back-up te maken met het geconfigureerde interval, maar het garandeert niet dat de back-up binnen dat tijdsinterval wordt voltooid. U kunt deze waarde in uren of minuten configureren. Het back-upinterval mag niet kleiner zijn dan 1 uur en langer dan 24 uur. Wanneer u dit interval wijzigt, wordt het nieuwe interval van kracht vanaf het moment waarop de laatste back-up is gemaakt.
- Back-upretentie : deze geeft de periode aan waarin elke back-up wordt bewaard. U kunt deze in uren of dagen configureren. De minimale bewaarperiode mag niet minder zijn dan twee keer het back-upinterval (in uren) en kan niet groter zijn dan 720 uur.
- Kopieën van gegevens die worden bewaard : standaard worden er gratis twee back-upkopieën van uw gegevens aangeboden. Er worden extra kosten in rekening gebracht als u meer dan twee exemplaren nodig hebt. Zie de sectie Verbruikte opslag op de pagina met prijzen om de exacte prijs voor extra exemplaren te weten.
- Redundantie van back-upopslag: kies de vereiste optie voor opslagredundantie . Zie back-upopslagredundantie voor meer informatie. Uw bestaande periodieke back-upmodusaccounts hebben standaard geografisch redundante opslag als de regio waar het account wordt ingericht, dit ondersteunt. Anders valt het account terug op de hoogste redundantieoptie die beschikbaar is. U kunt andere opslag, zoals lokaal redundant, kiezen om ervoor te zorgen dat de back-up niet naar een andere regio wordt gerepliceerd. De wijzigingen die zijn aangebracht in een bestaand account, worden alleen toegepast op toekomstige back-ups. Nadat de redundantie van de back-upopslag van een bestaand account is bijgewerkt, kan het tot twee keer zo lang duren voordat de wijzigingen van kracht worden en hebt u onmiddellijk geen toegang meer om de oudere back-ups te herstellen.
Notitie

U moet de rol Azure Cosmos DB-operator hebben toegewezen op abonnementsniveau om redundantie van back-upopslag te configureren.

Gebruik de az cosmosdb update opdracht om de periodieke back-upopties voor een bestaand account bij te werken.

az cosmosdb update \
    --resource-group <resource-group-name> \
    --name <account-name> \
    --backup-interval 480 \
    --backup-retention 24

Gebruik de Update-AzCosmosDBAccount cmdlet om de periodieke back-upopties voor een bestaand account bij te werken.

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    Name = "<account-name>"
    BackupIntervalInMinutes = 480
    BackupRetentionIntervalInHours = 24
}
Update-AzCosmosDBAccount @parameters

Gebruik de volgende Azure Resource Manager JSON-sjabloon om de periodieke back-upopties voor een bestaand account bij te werken.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "newAccountName": {
      "type": "string",
      "defaultValue": "[format('nosql-{0}', toLower(uniqueString(resourceGroup().id)))]",
      "metadata": {
        "description": "Name of the existing Azure Cosmos DB account."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for the Azure Cosmos DB account."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2022-05-15",
      "name": "[parameters('newAccountName')]",
      "location": "[parameters('location')]",
      "kind": "GlobalDocumentDB",
      "properties": {
        "databaseAccountOfferType": "Standard",
        "locations": [
          {
            "locationName": "[parameters('location')]"
          }
        ],
        "backupPolicy": {
            "type": "Periodic",
            "periodicModeProperties": {
                "backupIntervalInMinutes": 480,
                "backupRetentionIntervalInHours": 24,
                "backupStorageRedundancy": "Local"
            }
        }
      }
    }
  ]
}

U kunt ook de Bicep-variant van dezelfde sjabloon gebruiken.

@description('Name of the existing Azure Cosmos DB account.')
param newAccountName string = 'nosql-${toLower(uniqueString(resourceGroup().id))}'

@description('Location for the Azure Cosmos DB account.')
param location string = resourceGroup().location

resource account 'Microsoft.DocumentDB/databaseAccounts@2022-05-15' = {
  name: newAccountName
  location: location
  kind: 'GlobalDocumentDB'
  properties: {
    databaseAccountOfferType: 'Standard'
    locations: [
      {
        locationName: location
      }
    ]
    backupPolicy:
      type: 'Periodic'
      periodicModeProperties:
        backupIntervalInMinutes: 480,
        backupRetentionIntervalInHours: 24,
        backupStorageRedundancy: 'Local'
  }
}

Back-upopties voor een nieuw account configureren

Gebruik deze stappen om de standaardback-upopties voor een nieuw Azure Cosmos DB-account te wijzigen.

Notitie

Voor illustratieve doeleinden wordt ervan uitgegaan dat u een Azure Cosmos DB for NoSQL-account maakt. De stappen zijn vergelijkbaar voor accounts die andere API's gebruiken.

Wanneer u een nieuw account inricht, selecteert u op het tabblad Back-upbeleid periodieke* back-upbeleid. Met het periodieke beleid kunt u het back-upinterval, de back-upretentie en redundantie van back-upopslag configureren. U kunt bijvoorbeeld lokaal redundante back-upopslag of zone-redundante opties voor back-upopslag kiezen om replicatie van back-upgegevens buiten uw regio te voorkomen.

Gebruik de az cosmosdb create opdracht om een nieuw account te maken met de opgegeven periodieke back-upopties.

az cosmosdb create \
    --resource-group <resource-group-name> \
    --name <account-name> \
    --locations regionName=<azure-region> \
    --backup-interval 360 \
    --backup-retention 12

Gebruik de New-AzCosmosDBAccount cmdlet om een nieuw account te maken met de opgegeven periodieke back-upopties.

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    Name = "<account-name>"
    Location = "<azure-region>"
    BackupPolicyType = "Periodic"
    BackupIntervalInMinutes = 360
    BackupRetentionIntervalInHours = 12
}
New-AzCosmosDBAccount @parameters

Gebruik de volgende Azure Resource Manager JSON-sjabloon om de periodieke back-upopties voor een bestaand account bij te werken.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "newAccountName": {
      "type": "string",
      "defaultValue": "[format('nosql-{0}', toLower(uniqueString(resourceGroup().id)))]",
      "metadata": {
        "description": "New Azure Cosmos DB account name. Max length is 44 characters."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for the new Azure Cosmos DB account."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2022-05-15",
      "name": "[parameters('newAccountName')]",
      "location": "[parameters('location')]",
      "kind": "GlobalDocumentDB",
      "properties": {
        "databaseAccountOfferType": "Standard",
        "locations": [
          {
            "locationName": "[parameters('location')]"
          }
        ],
        "backupPolicy": {
            "type": "Periodic",
            "periodicModeProperties": {
                "backupIntervalInMinutes": 360,
                "backupRetentionIntervalInHours": 12,
                "backupStorageRedundancy": "Zone"
            }
        }
      }
    }
  ]
}

U kunt ook de Bicep-variant van dezelfde sjabloon gebruiken.

@description('New Azure Cosmos DB account name. Max length is 44 characters.')
param newAccountName string = 'sql-${toLower(uniqueString(resourceGroup().id))}'

@description('Location for the new Azure Cosmos DB account.')
param location string = resourceGroup().location

resource account 'Microsoft.DocumentDB/databaseAccounts@2022-05-15' = {
  name: newAccountName
  location: location
  kind: 'GlobalDocumentDB'
  properties: {
    databaseAccountOfferType: 'Standard'
    locations: [
      {
        locationName: location
      }
    ]
    backupPolicy:
      type: 'Periodic'
      periodicModeProperties:
        backupIntervalInMinutes: 360,
        backupRetentionIntervalInHours: 12,
        backupStorageRedundancy: 'Zone'
  }
}

Volgende stappen

Herstel van gegevens aanvragen vanuit een back-up

Delen via