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

Articolo
05/24/2023

SI APPLICA A: Nosql 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.

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 per NoSQL o MongoDB.
Se l'account è di tipo API per Table o 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 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.

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.
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>
```

API per l'account NoSQL

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"

API per l'account 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"

API per l'account 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:

Installare la versione più recente dell'interfaccia della riga di comando di Azure, vedere Interfaccia della riga di comando di Azure
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 .

API per l'account NoSQL

Per effettuare il provisioning di un account API per NoSQL 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"

API per l'account 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"

API per l'account Gremlin

Il comando seguente mostra un esempio di un singolo account di scrittura dell'area denominato Pitracct con criteri di backup continui e Continuous7days il 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": "2023-04-15",
      "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

Ripristinare un account Azure Cosmos DB attivo o eliminato
Come eseguire la migrazione a un account dal backup periodico al backup continuo.
Modello di risorsa in modalità backup continuo.
Gestire le autorizzazioni necessarie per ripristinare i dati con la modalità di backup continuo.

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

Effettuare il provisioning con portale di Azure

Effettuare il provisioning con Azure PowerShell

API per l'account NoSQL

API per MongoDB

API per l'account tabella

API per l'account Gremlin

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

API per l'account NoSQL

API per MongoDB

API per l'account tabella

API per l'account Gremlin

Effettuare il provisioning con il modello di Resource Manager

Passaggi successivi

Risorse aggiuntive

Risorse aggiuntive