Aprovisionar uma conta do Azure Cosmos DB com a cópia de segurança contínua e o restauro para um ponto anterior no tempo

APLICA-SE A: API da API SQL do Azure Cosmos DB para MongoDB

A funcionalidade de restauro para um ponto anterior no tempo do Azure Cosmos DB ajuda-o a recuperar de uma alteração acidental num contentor, a restaurar um recurso eliminado ou a restaurar em qualquer região onde existiam cópias de segurança. O modo de cópia de segurança contínua permite-lhe restaurar para qualquer ponto do tempo nos últimos 30 ou 7 dias. A distância atrás que pode ir no tempo depende da camada do modo contínuo da conta.

Este artigo explica como aprovisionar uma conta com cópia de segurança contínua e restauro para um ponto anterior no tempo com modelos de portal do Azure, PowerShell, CLI e Resource Manager.

Importante

O suporte para cópias de segurança contínuas de 7 dias em cenários de aprovisionamento e migração ainda está em pré-visualização. Utilize o PowerShell e a CLI do Azure para migrar ou aprovisionar uma conta com cópia de segurança contínua configurada no escalão de 7 dias.

Nota

Só pode aprovisionar a conta do modo de cópia de segurança contínua se as seguintes condições forem verdadeiras:

• Se a conta for do tipo API SQL ou API para MongoDB.
• Se a conta for do tipo API de Tabela ou API do Gremlin.
• Se a conta tiver uma única região de escrita.

Aprovisionar com portal do Azure

Ao criar uma nova conta do Azure Cosmos DB, no separador Política de cópia de segurança, selecione o modo contínuo para ativar a funcionalidade de restauro para um ponto anterior no tempo para a nova conta. Com o restauro para um ponto anterior no tempo, os dados são restaurados para uma nova conta, atualmente não pode restaurar para uma conta existente.

A API de Tabela e a API do Gremlin estão em pré-visualização e podem ser aprovisionadas com o PowerShell e a CLI do Azure.

Aprovisionar com Azure PowerShell

Para comandos do PowerShell e da CLI, o valor da camada é opcional, se ainda não for fornecido. Se não for fornecida, a cópia de segurança da conta será mantida durante 30 dias. As camadas são representadas pelos valores Continuous7Days ou Continuous30Days.

1. Instalar a versão mais recente do Azure PowerShell

   • Antes de aprovisionar a conta, instale qualquer versão do Azure PowerShell superior à 6.2.0. Para obter mais informações sobre a versão mais recente do Azure PowerShell, consulte a versão mais recente do Azure PowerShell.
   • Para aprovisionar o Continuous7Days escalão, terá de instalar a versão de pré-visualização do módulo ao executar Install-Module -Name Az.CosmosDB -AllowPrerelease.

2. Em seguida, ligue-se à sua conta do Azure e selecione a subscrição necessária com os seguintes comandos:

   1. Inicie sessão no Azure com o seguinte comando:

      Connect-AzAccount
      

   2. Selecione uma subscrição específica com o seguinte comando:

      Select-AzSubscription -Subscription <SubscriptionName>
      

Conta da API SQL

Para aprovisionar uma conta com cópia de segurança contínua, adicione o argumento -BackupPolicyType Continuous juntamente com o comando de aprovisionamento regular.

O cmdlet seguinte assume uma conta de escrita de região única, Pitracct, na região E.U.A. Oeste no grupo de recursos MyRG . A conta tem a política de cópia de segurança contínua ativada. A cópia de segurança contínua está configurada na Continuous7days camada:

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

API para MongoDB

O cmdlet seguinte é um exemplo de conta de cópia de segurança contínua configurada com a Continuous30days camada :

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

Conta da API de Tabela

Para aprovisionar uma conta com cópia de segurança contínua, adicione um argumento -BackupPolicyType Continuous juntamente com o comando de aprovisionamento regular.

O cmdlet seguinte é um exemplo de política de cópia de segurança contínua com a Continuous7days camada :

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

Conta da API do Gremlin

Para aprovisionar uma conta com cópia de segurança contínua, adicione um argumento -BackupPolicyType Continuous juntamente com o comando de aprovisionamento regular.

O cmdlet seguinte é um exemplo de uma conta com a política de cópia de segurança contínua configurada com a Continuous30days camada :

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

Aprovisionar com a CLI do Azure

Para o PowerShell e o valor da camada de comandos da CLI é opcional, se não for fornecido, a cópia de segurança da conta será mantida durante 30 dias. As camadas são representadas por Continuous7Days ou Continuous30Days.

Antes de aprovisionar a conta, instale a CLI do Azure com os seguintes passos:

1. Instalar a versão mais recente da CLI do Azure

   • Instale uma versão da CLI do Azure superior à 2.26.0. Para obter mais informações sobre a versão mais recente da CLI do Azure, veja CLI do Azure.
   • Se já tiver instalado a CLI, execute az upgrade o comando para atualizar para a versão mais recente. Este comando só funcionará com a versão da CLI superior à 2.11. Se tiver uma versão anterior, utilize a ligação acima para instalar a versão mais recente.
   • Para aprovisionar o Continuous7Days escalão, terá de instalar a versão de pré-visualização da extensão ao az extension update --name cosmosdb-preview

2. Inicie sessão e selecione a sua subscrição

   • Inicie sessão na sua conta do Azure com o az login comando .
   • Selecione a subscrição necessária com az account set -s <subscriptionguid> o comando .

Conta da API SQL

Para aprovisionar uma conta da API SQL com cópia de segurança contínua, deve ser transmitido um argumento --backup-policy-type Continuous adicional juntamente com o comando de aprovisionamento regular. O seguinte comando é um exemplo de uma conta de escrita de região única chamada Pitracct com política de cópia de segurança contínua e Continuous7days camada:

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

API para MongoDB

O comando seguinte mostra um exemplo de uma conta de escrita de região única denominada Pitracct com política de cópia de segurança contínua e Continuous30days camada:

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"

Conta da API de Tabela

O comando seguinte mostra um exemplo de uma conta de escrita de região única denominada Pitracct com política de cópia de segurança contínua e Continuous30days camada:

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"

Conta da API do Gremlin

O comando seguinte mostra um exemplo de uma conta de escrita de região única denominada Pitracct com a política de cópia de segurança contínua e Continuous7days a camada criada na região E.U.A. Oeste no grupo de recursos 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"

Aprovisionar com Resource Manager modelo

Pode utilizar modelos do Azure Resource Manager para implementar uma conta do Azure Cosmos DB com o modo contínuo. Ao definir o modelo para aprovisionar uma conta, inclua o backupPolicy parâmetro e da camada, conforme mostrado no exemplo seguinte, a camada pode ser Continuous7Days ou 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"
        }
        ]
        }

Em seguida, implemente o modelo com Azure PowerShell ou CLI. O exemplo seguinte mostra como implementar o modelo com um comando da CLI:

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

Passos seguintes

• Restaurar uma conta do Azure Cosmos DB em direto ou eliminada
• Como migrar para uma conta da cópia de segurança periódica para a cópia de segurança contínua.
• Modelo de recurso do modo de cópia de segurança contínua.
• Gerir as permissões necessárias para restaurar dados com o modo de cópia de segurança contínua.