Ändra periodiskt säkerhetskopieringsintervall och kvarhållningsperiod i Azure Cosmos DB

Artikel
08/15/2024

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

Azure Cosmos DB tar automatiskt en fullständig säkerhetskopia av dina data var fjärde timme och när som helst lagras de två senaste säkerhetskopiorna. Den här konfigurationen är standardalternativet och erbjuds utan extra kostnad. Du kan ändra standardintervallet för säkerhetskopiering och kvarhållning under skapandet av Azure Cosmos DB-kontot eller när kontot har skapats. Säkerhetskopieringskonfigurationen anges på Kontonivå för Azure Cosmos DB och du måste konfigurera den för varje konto. När du har konfigurerat säkerhetskopieringsalternativen för ett konto tillämpas det på alla containrar i kontot. Du kan ändra de här inställningarna med hjälp av Azure Portal, Azure PowerShell eller Azure CLI.

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.

Innan du börjar

Om du av misstag har tagit bort eller skadat dina data måste du öka kvarhållningen av säkerhetskopian för ditt konto till minst sju dagar innan du skapar en supportbegäran om att återställa data. Det är bäst att öka kvarhållningen inom 8 timmar efter den här händelsen. På så sätt har Azure Cosmos DB-teamet tillräckligt med tid för att återställa ditt konto.

Ändra säkerhetskopieringsalternativ för ett befintligt konto

Använd följande steg för att ändra standardalternativen för säkerhetskopiering för ett befintligt Azure Cosmos DB-konto.

Logga in på Azure-portalen.
Gå till ditt Azure Cosmos DB-konto och öppna fönstret Säkerhetskopiering och återställning . Uppdatera säkerhetskopieringsintervallet och kvarhållningsperioden för säkerhetskopior efter behov.
- Säkerhetskopieringsintervall – Det är det intervall med vilket Azure Cosmos DB försöker göra en säkerhetskopia av dina data. Säkerhetskopieringen tar en icke-nolltid och i vissa fall kan den eventuellt misslyckas på grund av underordnade beroenden. Azure Cosmos DB gör sitt bästa för att göra en säkerhetskopia med det konfigurerade intervallet, men det garanterar inte att säkerhetskopieringen slutförs inom det tidsintervallet. Du kan konfigurera det här värdet i timmar eller minuter. Säkerhetskopieringsintervallet får inte vara mindre än 1 timme och längre än 24 timmar. När du ändrar det här intervallet börjar det nya intervallet gälla från den tidpunkt då den senaste säkerhetskopieringen gjordes.
- Kvarhållning av säkerhetskopior – den period då varje säkerhetskopia behålls. Du kan konfigurera den i timmar eller dagar. Den minsta kvarhållningsperioden får inte vara mindre än två gånger säkerhetskopieringsintervallet (i timmar) och får inte vara längre än 720 timmar.
- Kopior av lagrade data – Som standard erbjuds två säkerhetskopior av dina data kostnadsfritt. Det tillkommer en extra kostnad om du behöver fler än två kopior. Se avsnittet Förbrukad lagring på prissidan för att veta det exakta priset för extra kopior.
- Redundans för säkerhetskopieringslagring – Välj det alternativ för lagringsredundans som krävs. Mer information finns i Redundans för lagring av säkerhetskopior. Som standard har dina befintliga konton för periodiskt säkerhetskopieringsläge geo-redundant lagring om den region där kontot etableras stöder det. Annars återställs kontot till det högsta tillgängliga redundansalternativet. Du kan välja annan lagring, till exempel lokalt redundant för att säkerställa att säkerhetskopieringen inte replikeras till en annan region. Ändringarna som görs i ett befintligt konto tillämpas endast på framtida säkerhetskopior. När redundansen för säkerhetskopieringslagringen för ett befintligt konto har uppdaterats kan det ta upp till dubbelt så mycket tid för säkerhetskopieringsintervallet att ändringarna börjar gälla, och du förlorar åtkomsten för att återställa de äldre säkerhetskopiorna omedelbart.
Kommentar

Du måste ha rollen Azure Azure Cosmos DB-operatör tilldelad på prenumerationsnivå för att konfigurera redundans för lagring av säkerhetskopior.

az cosmosdb update Använd kommandot för att uppdatera de periodiska säkerhetskopieringsalternativen för ett befintligt konto.

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

Använd cmdleten Update-AzCosmosDBAccount för att uppdatera de periodiska säkerhetskopieringsalternativen för ett befintligt konto.

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

Använd följande Azure Resource Manager JSON-mall för att uppdatera de periodiska säkerhetskopieringsalternativen för ett befintligt konto.

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

Du kan också använda Bicep-varianten av samma mall.

@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'
  }
}

Konfigurera säkerhetskopieringsalternativ för ett nytt konto

Använd de här stegen för att ändra standardalternativen för säkerhetskopiering för ett nytt Azure Cosmos DB-konto.

Kommentar

I illustrativa syften förutsätter dessa exempel att du skapar en Azure Cosmos DB för NoSQL-konto . Stegen är mycket lika för konton som använder andra API:er.

När du etablerar ett nytt konto går du till fliken Säkerhetskopieringsprincip och väljer Princip för periodisk* säkerhetskopiering. Med den periodiska principen kan du konfigurera säkerhetskopieringsintervall, kvarhållning av säkerhetskopior och redundans för lagring av säkerhetskopior. Du kan till exempel välja lagringsalternativ för lokalt redundant säkerhetskopiering eller zonredundant lagring för säkerhetskopiering för att förhindra replikering av säkerhetskopieringsdata utanför din region.

az cosmosdb create Använd kommandot för att skapa ett nytt konto med de angivna alternativen för periodisk säkerhetskopiering.

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

Använd cmdleten New-AzCosmosDBAccount för att skapa ett nytt konto med de angivna periodiska säkerhetskopieringsalternativen.

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

Använd följande Azure Resource Manager JSON-mall för att uppdatera de periodiska säkerhetskopieringsalternativen för ett befintligt konto.

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

Du kan också använda Bicep-varianten av samma mall.

@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'
  }
}

Nästa steg

Begära återställning av data från en säkerhetskopia

Dela via