Effettuare il provisioning di un account Azure Cosmos DB con backup continuo e ripristino temporizzato

SI APPLICA A: API SQL di Azure Cosmos DB per MongoDB

La funzionalità di ripristino temporizzato di Azure Cosmos DB consente di eseguire il ripristino da una modifica accidentale all'interno di un contenitore, ripristinare una risorsa eliminata o ripristinarla in qualsiasi area in cui sono presenti i backup. La modalità di backup continuo consente di eseguire il ripristino in qualsiasi momento negli ultimi 30 o 7 giorni. Il tempo trascorso dipende dal livello della modalità continua per l'account.

Questo articolo illustra come effettuare il provisioning di un account con backup continuo e ripristino temporizzato usando modelli di portale di Azure, PowerShell, interfaccia della riga di comando e Resource Manager.

Importante

Il supporto per il backup continuo di 7 giorni in scenari di provisioning e migrazione è ancora in anteprima. Usare PowerShell e l'interfaccia della riga di comando di Azure per eseguire la migrazione o il provisioning di un account con backup continuo configurato al livello di 7 giorni.

Nota

È possibile effettuare il provisioning dell'account in modalità di backup continuo solo se si verificano le condizioni seguenti:

  • Se l'account è di tipo API SQL o API per MongoDB.
  • Se l'account è di tipo API Table o API Gremlin.
  • Se l'account ha una singola area di scrittura.

Effettuare il provisioning con portale di Azure

Quando si crea un nuovo account Azure Cosmos DB, nella scheda Criteri di backup scegliere la modalità continua per abilitare la funzionalità di ripristino temporizzato per il nuovo account. Con il ripristino temporizzato, i dati vengono ripristinati in un nuovo account, attualmente non è possibile eseguire il ripristino in un account esistente.

Effettuare il provisioning di un account Azure Cosmos DB con configurazione di backup continuo.

L'API Tabella e l'API Gremlin sono in anteprima e possono essere sottoposte a provisioning con PowerShell e l'interfaccia della riga di comando di Azure.

Effettuare il provisioning con Azure PowerShell

Per i comandi di PowerShell e dell'interfaccia della riga di comando, il valore del livello è facoltativo, se non è già specificato. Se non viene specificato, il backup dell'account verrà conservato per 30 giorni. I livelli sono rappresentati dai valori Continuous7Days o Continuous30Days.

  1. Installare la versione più recente di Azure PowerShell.

    • Prima di effettuare il provisioning dell'account, installare qualsiasi versione di Azure PowerShell successiva alla versione 6.2.0. Per altre informazioni sulla versione più recente di Azure PowerShell, vedere la versione più recente di Azure PowerShell.
    • Per il provisioning del Continuous7Days livello, è necessario installare la versione di anteprima del modulo eseguendo Install-Module -Name Az.CosmosDB -AllowPrerelease.
  2. Connettersi quindi all'account Azure e selezionare la sottoscrizione necessaria con i comandi seguenti:

    1. Accedere ad Azure usando il comando seguente:

      Connect-AzAccount
      
    2. Selezionare una sottoscrizione specifica con il comando seguente:

      Select-AzSubscription -Subscription <SubscriptionName>
      

Account API SQL

Per effettuare il provisioning di un account con backup continuo, aggiungere l'argomento -BackupPolicyType Continuous insieme al normale comando di provisioning.

Il cmdlet seguente presuppone un account di scrittura in una singola area, Pitracct, nell'area Stati Uniti occidentali nel gruppo di risorse MyRG . L'account dispone di criteri di backup continui abilitati. Il backup continuo viene configurato a Continuous7days livello:

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous7Days `
  -Name "pitracct" `
  -ApiKind "Sql"

API per MongoDB

Il cmdlet seguente è un esempio di account di backup continuo configurato con il Continuous30days livello :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous30Days `
  -Name "Pitracct" `
  -ApiKind "MongoDB" `
  -ServerVersion "3.6"

Account DELL'API Tabella

Per effettuare il provisioning di un account con backup continuo, aggiungere un argomento -BackupPolicyType Continuous insieme al normale comando di provisioning.

Il cmdlet seguente è un esempio di criteri di backup continuo con il Continuous7days livello :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous7Days `
  -Name "pitracct" `
  -ApiKind "Table"

Account API Gremlin

Per effettuare il provisioning di un account con backup continuo, aggiungere un argomento -BackupPolicyType Continuous insieme al normale comando di provisioning.

Il cmdlet seguente è un esempio di un account con criteri di backup continui configurati con il Continuous30days livello :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous30Days `
  -Name "pitracct" `
  -ApiKind "Gremlin" 

Effettuare il provisioning usando l'interfaccia della riga di comando di Azure

Per il valore del livello dei comandi di PowerShell e dell'interfaccia della riga di comando è facoltativo, se non viene specificato, il backup dell'account verrà conservato per 30 giorni. I livelli sono rappresentati da Continuous7Days o Continuous30Days.

Prima di effettuare il provisioning dell'account, installare l'interfaccia della riga di comando di Azure seguendo questa procedura:

  1. Installare la versione più recente dell'interfaccia della riga di comando di Azure

    • Installare una versione dell'interfaccia della riga di comando di Azure successiva alla versione 2.26.0. Per altre informazioni sulla versione più recente dell'interfaccia della riga di comando di Azure, vedere Interfaccia della riga di comando di Azure.
    • Se è già stata installata l'interfaccia della riga di comando, eseguire az upgrade il comando per eseguire l'aggiornamento alla versione più recente. Questo comando funzionerà solo con la versione dell'interfaccia della riga di comando successiva alla 2.11. Se si ha una versione precedente, usare il collegamento precedente per installare la versione più recente.
    • Per il provisioning del Continuous7Days livello, è necessario installare la versione di anteprima dell'estensione tramite az extension update --name cosmosdb-preview
  2. Eseguire l'accesso e selezionare la sottoscrizione

    • Accedere all'account Azure con az login il comando .
    • Selezionare la sottoscrizione richiesta usando az account set -s <subscriptionguid> il comando .

Account API SQL

Per effettuare il provisioning di un account API SQL con backup continuo, è necessario passare un argomento --backup-policy-type Continuous aggiuntivo insieme al normale comando di provisioning. Il comando seguente è un esempio di un singolo account di scrittura di area denominato Pitracct con criteri di backup continui e Continuous7days livello:


az cosmosdb create \
  --name Pitracct \
  --resource-group MyRG \
  --backup-policy-type Continuous \
  --continuous-tier "Continuous7Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

API per MongoDB

Il comando seguente mostra un esempio di un account di scrittura in una singola area denominato Pitracct con criteri di backup continui e Continuous30days livello:

az cosmosdb create \
  --name Pitracct \
  --kind MongoDB \
  --resource-group MyRG \
  --server-version "3.6" \
  --backup-policy-type Continuous \
  --continuous-tier "Continuous30Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Account DELL'API Tabella

Il comando seguente mostra un esempio di un account di scrittura in una singola area denominato Pitracct con criteri di backup continui e Continuous30days livello:

az cosmosdb create \
  --name Pitracct \
  --kind GlobalDocumentDB  \
  --resource-group MyRG \
  --capabilities EnableTable \ 
  --backup-policy-type Continuous \
  --continuous-tier "Continuous30Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Account API Gremlin

Il comando seguente mostra un esempio di un account di scrittura a singola area denominato Pitracct con criteri di backup continui e Continuous7days livello creati nell'area Stati Uniti occidentali nel gruppo di risorse MyRG :

az cosmosdb create \
  --name Pitracct \
  --kind GlobalDocumentDB  \
  --resource-group MyRG \
  --capabilities EnableGremlin \ 
  --backup-policy-type Continuous \
  --continuous-tier "Continuous7Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Effettuare il provisioning con il modello di Resource Manager

È possibile usare i modelli di Azure Resource Manager per distribuire un account Azure Cosmos DB con modalità continua. Quando si definisce il modello per effettuare il provisioning di un account, includere il backupPolicy parametro e tier come illustrato nell'esempio seguente, il livello può essere Continuous7Days o Continuous30Days :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "name": "ademo-pitr1",
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2016-03-31",
      "location": "West US",
      "properties": {
        "locations": [
          {
            "locationName": "West US"
          }
        ],
        "backupPolicy":{
        "type":"Continuous", 
        "continuousModeProperties":{
        "tier":"Continuous7Days"
        }
        } 
        "databaseAccountOfferType": "Standard"
        }
        ]
        }

Distribuire quindi il modello usando Azure PowerShell o l'interfaccia della riga di comando. L'esempio seguente illustra come distribuire il modello con un comando dell'interfaccia della riga di comando:

az deployment group create -g <ResourceGroup> --template-file <ProvisionTemplateFilePath>

Passaggi successivi