Provisionar uma conta do Azure Cosmos DB com backup contínuo e a recuperação pontual

APLICA-SE A: NoSQL MongoDB

O recurso de restauração pontual do Azure Cosmos DB ajuda você a se recuperar de uma alteração acidental em um contêiner, restaurar um recurso excluído ou restaurar para qualquer região na qual backups existiam. O modo de backup contínuo permite que você restaure para qualquer momento nos últimos 30 ou sete dias. O quanto você pode recuar no tempo depende da camada do modo contínuo da conta.

Este artigo explica como provisionar uma conta com backup contínuo e recuperação pontual usando o portal do Azure, PowerShell, CLI e modelos do Resource Manager.

Observação

Você poderá provisionar a conta no modo de backup contínuo somente se as seguintes condições forem verdadeiras:

  • Se a conta é do tipo API para NoSQL ou MongoDB.
  • Se a conta é do tipo API para Tabela ou Gremlin.
  • Se a conta tiver uma única região de gravação.

Provisionar usando o portal do Azure

Ao criar uma nova conta do Azure Cosmos DB, na guia Política de backup, escolha o modo contínuo para habilitar a funcionalidade de restauração pontual para a nova conta. Com a recuperação pontual, os dados são restaurados em uma nova conta. No momento, você não pode restaurar para uma conta existente.

Provisionar uma conta do Azure Cosmos DB com configuração de backup contínuo.

Provisionar usando o Azure PowerShell

Para comandos do PowerShell e da CLI, o valor da camada será opcional, caso ainda não tenha sido fornecido. Se não for fornecido, o backup da conta será retido por 30 dias. As camadas são representadas pelos valores Continuous7Days ou Continuous30Days.

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

    • Antes de provisionar 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, confira a versão mais recente do Azure PowerShell.
    • Para provisionar a camada Continuous7Days, você precisará instalar a versão de pré-visualização do módulo executando Install-Module -Name Az.CosmosDB -AllowPrerelease.
  2. Em seguida, conecte-se à conta do Azure e selecione a assinatura necessária com os seguintes comandos:

    1. Entre no Azure usando o seguinte comando:

      Connect-AzAccount
      
    2. Selecione uma assinatura específica com o seguinte comando:

      Select-AzSubscription -Subscription <SubscriptionName>
      

API para conta NoSQL

Para provisionar uma conta com o backup contínuo, adicione o argumento -BackupPolicyType Continuous juntamente com o comando de provisionamento regular.

O cmdlet a seguir pressupõe uma só conta de gravação de região, Pitracct, na região Oeste dos EUA no grupo de recursos MyRG. A conta tem a política de backup contínuo habilitada. O backup contínuo é configurado na camada Continuous7days:

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

API para MongoDB

O cmdlet a seguir é um exemplo de conta de backup contínuo configurada com a camada Continuous30days:

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

API para a conta do Table

Para provisionar uma conta com o backup contínuo, adicione um argumento -BackupPolicyType Continuous juntamente com o comando de provisionamento regular.

O cmdlet a seguir é um exemplo de política de backup contínuo com a camada Continuous7days:

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

API para conta Gremlin

Para provisionar uma conta com o backup contínuo, adicione um argumento -BackupPolicyType Continuous juntamente com o comando de provisionamento regular.

O cmdlet a seguir é um exemplo de uma conta com política de backup contínuo configurada com a camada Continuous30days:

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

Provisionar usando a CLI do Azure

No PowerShell e na CLI, o valor da camada de comandos é opcional, se não for fornecido. O backup da conta será retido por 30 dias. As camadas são representadas por Continuous7Days ou Continuous30Days.

Antes de provisionar a conta, instale a CLI do Azure com as seguintes etapas:

  1. Instale a última versão da CLI do Azure, confira CLI do Azure

  2. Entrar e selecione sua assinatura

    • Entre na sua conta do Azure com o comando az login.
    • Selecione a assinatura necessária usando o comando az account set -s <subscriptionguid>.

API para conta NoSQL

Para provisionar uma conta da API para NoSQL com backup contínuo, o argumento extra --backup-policy-type Continuous deve ser passado com o comando de provisionamento normal. O seguinte comando é um exemplo de uma conta de gravação de região única chamada Pitracct com a política de backup contínuo e nível Continuous7days:


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 seguinte comando mostra um exemplo de uma conta de gravação de região única chamada Pitracct com a política de backup contínuo e nível Continuous30days:

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 para a conta do Table

O seguinte comando mostra um exemplo de uma conta de gravação de região única chamada Pitracct com a política de backup contínuo e nível Continuous30days:

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 para conta Gremlin

O seguinte comando mostra um exemplo de uma conta de gravação de uma região chamada Pitracct com a política de backup contínuo e a camada Continuous7days criada na região Oeste dos EUA 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"

Provisionar usando o modelo do Resource Manager

Você pode usar modelos de Azure Resource Manager para implantar uma conta de Azure Cosmos DB com o modo contínuo. Ao definir o modelo para provisionar uma conta, inclua o parâmetro backupPolicy e de camada, conforme mostrado no exemplo a seguir. 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": "2023-04-15",
      "location": "West US",
      "properties": {
        "locations": [
          {
            "locationName": "West US"
          }
        ],
        "backupPolicy":{
        "type":"Continuous", 
        "continuousModeProperties":{
        "tier":"Continuous7Days"
        }
        } 
        "databaseAccountOfferType": "Standard"
        } }

Em seguida, implante o modelo usando o Azure PowerShell ou a CLI. O exemplo a seguir mostra como implantar o modelo com um comando da CLI:

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

Próximas etapas