Modificare l'intervallo di backup periodico e il periodo di conservazione in Azure Cosmos DB

Articolo
08/15/2024

SI APPLICA A: NoSQL MongoDB Cassandra Gremlin Tabella

Azure Cosmos DB esegue automaticamente un backup completo dei dati ogni 4 ore e in qualsiasi momento, e i due backup più recenti vengono archiviati. Questa configurazione è l'opzione predefinita e viene offerta senza alcun costo aggiuntivo. L'intervallo di backup e il periodo di conservazione predefiniti possono essere modificati durante o dopo la creazione dell'account Azure Cosmos DB. La configurazione del backup è impostata a livello di account Azure Cosmos DB e deve essere eseguita in ogni account. Dopo che le opzioni di backup vengono configurate per un account, vengono applicate a tutti i contenitori all'interno di tale account. È possibile modificare queste impostazioni tramite il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure.

Prerequisiti

Un account Azure Cosmos DB esistente.
- Se si dispone di una sottoscrizione di Azure, creare un nuovo account.
- Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
- In alternativa, è possibile provare Azure Cosmos DB gratuitamente prima di eseguire il commit.

Prima di iniziare

Se i dati sono stati eliminati o danneggiati accidentalmente, prima di creare una richiesta di supporto per il ripristino, assicurarsi di aumentare ad almeno sette giorni il periodo di conservazione del backup per l'account. È consigliabile aumentare il periodo di conservazione entro 8 ore dall'evento. In questo modo, il team di Azure Cosmos DB avrà tempo a sufficienza per ripristinare l'account.

Modificare le opzioni di backup per un account esistente

Usare la procedura seguente per modificare le opzioni di backup predefinite per un account Azure Cosmos DB esistente.

Accedere al portale di Azure.
Passare all'account Azure Cosmos DB e aprire il riquadro Backup e ripristino. Aggiornare l'intervallo di backup e il periodo di conservazione dei backup in base alle esigenze.
- Intervallo di backup: è l'intervallo in cui Azure Cosmos DB tenta di eseguire un backup dei dati. Il backup richiede un periodo di tempo diverso da zero e, in alcuni casi, potrebbe avere esito negativo a causa di dipendenze downstream. Azure Cosmos DB tenta di eseguire un backup a intervalli configurati, ma non garantisce che il backup venga completato entro tale intervallo di tempo. È possibile configurare questo valore in ore o minuti. L'intervallo di backup non può essere inferiore a 1 ora e maggiore di 24 ore. Quando si modifica questo intervallo, il nuovo intervallo diventa effettivo a partire dal momento in cui è stato eseguito l'ultimo backup.
- Conservazione dei backup: rappresenta il periodo in cui viene conservato ogni backup. È possibile configurarlo in ore o giorni. Il periodo di conservazione minimo non può essere minore di due volte l'intervallo di backup (in ore) e non può essere maggiore di 720 ore.
- Copie dei dati mantenute: per impostazione predefinita, vengono offerte due copie di backup dei dati gratuitamente. Se occorrono più di due copie, è previsto un costo aggiuntivo. Vedere la sezione Archiviazione utilizzata nella pagina dei prezzi per conoscere il prezzo esatto per le copie aggiuntive.
- Ridondanza dell'archivio di backup: scegliere l'opzione di ridondanza di archiviazione necessaria. Per altre informazioni, vedere Ridondanza dell'archivio di backup. Per impostazione predefinita, gli account della modalità di backup periodica esistenti dispongono di archiviazione con ridondanza geografica se l'area in cui viene eseguito il provisioning dell'account lo supporta. In caso contrario, viene eseguito il fallback dell'account all'opzione di ridondanza più elevata disponibile. È possibile scegliere altre risorse di archiviazione, ad esempio con ridondanza locale, per assicurarsi che il backup non venga replicato in un'altra area. Le modifiche apportate a un account esistente vengono applicate solo ai backup futuri. Dopo l'aggiornamento della ridondanza dell'archiviazione di backup di un account esistente, l'intervallo di backup potrebbe richiedere fino al doppio del tempo di esecuzione delle modifiche e si perderà l'accesso per ripristinare immediatamente i backup meno recenti.
Nota

Per configurare la ridondanza dell'archiviazione di backup, è necessario avere il ruolo di Operatore di Azure Cosmos DB assegnato a livello di sottoscrizione.

Usare il comando az cosmosdb update per aggiornare le opzioni di backup periodiche per un account esistente.

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

Usare il cmdlet Update-AzCosmosDBAccount per aggiornare le opzioni di backup periodiche per un account esistente.

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

Usare il modello JSON di Azure Resource Manager seguente per aggiornare le opzioni di backup periodiche per un account esistente.

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

In alternativa, è possibile usare la variante Bicep dello stesso modello.

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

Configurare le opzioni di backup per un nuovo account

Usare i passaggi seguenti per modificare le opzioni di backup predefinite per un nuovo account Azure Cosmos DB.

Nota

A scopo illustrativo, questi esempi presuppongono la creazione di un account di Azure Cosmos DB for NoSQL. I passaggi sono molto simili per gli account che usano altre API.

Quando si esegue il provisioning di un nuovo account, nella scheda Criteri di backup selezionare il criterio di backup Periodico*. I criteri periodici consentono di configurare l'intervallo di backup, la conservazione dei backup e la ridondanza dell'archiviazione di backup. Ad esempio, è possibile scegliere l'archiviazione di backup con ridondanza locale o l'archiviazione di backup con ridondanza della zona per impedire la replica dei dati di backup all'esterno dell'area.

Usare il comando az cosmosdb create per creare un nuovo account con le opzioni di backup periodiche specificate.

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

Usare il cmdlet New-AzCosmosDBAccount per creare un nuovo account con le opzioni di backup periodiche specificate.

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

Usare il modello JSON di Azure Resource Manager seguente per aggiornare le opzioni di backup periodiche per un account esistente.

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

In alternativa, è possibile usare la variante Bicep dello stesso modello.

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

Passaggi successivi

Richiedere il ripristino dei dati da un backup

Condividi tramite