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.

Aprovisionar uma conta do Azure Cosmos DB com configuração de cópia de segurança contínua.

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