Atualizar a redundância de armazenamento de backup periódico do Azure Cosmos DB

APLICA-SE AO: NoSQL MongoDB Cassandra Gremlin Table

Os dados de backup do modo de período do Azure Cosmos DB são replicados de maneiras diferentes. Se a região principal tiver suporte nas regiões emparelhadas, o Azure Cosmos DB armazena o dados de backup de modo periódico por padrão no armazenamento de blobs, que é replicado no emparelhamento. Você pode substituir a redundância de armazenamento de backup padrão. Como alternativa, se você usar uma região não emparelhada, precisará escolher explicitamente a redundância de armazenamento de backup. Esse artigo explica como atualizar a redundância de armazenamento de backup usando a CLI do Azure e o PowerShell. Ele também mostra como configurar uma política do Azure em suas contas para impor a redundância de armazenamento necessária.

Pré-requisitos

• Uma conta existente do Azure Cosmos DB.
  • Se você tiver uma assinatura do Azure, crie uma nova conta.
  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
  • Como alternativa, você pode experimentar o Azure Cosmos DB gratuitamente antes de confirmar.

Atualizar a redundância de armazenamento

Use as etapas a seguir para atualizar a redundância de armazenamento de backup.

Portal do Azure

1. Entre no portal do Azure e navegue até a sua conta Microsoft Azure Cosmos DB.

2. Abra o painel Backup e Restauração, atualize a redundância de armazenamento de backup e selecione Enviar. Leva alguns minutos para a operação ser concluída.

   

CLI do Azure

1. Verifique se você tem a versão mais recente da CLI do Azure ou uma versão superior ou igual a 2.30.0. Se você tiver a extensão cosmosdb-preview instalada, certifique-se de removê-la.

2. Use o comando az cosmosdb locations show para obter as opções de redundância de backup disponíveis nas regiões onde sua conta existe.

   az cosmosdb locations show \
         --location <region-name>
   

   A saída deve incluir JSON semelhante a este exemplo:

   {
     "id": "subscriptionId/<Subscription_ID>/providers/Microsoft.DocumentDB/locations/eastus/",
     "name": "East US",
     "properties": {
       "backupStorageRedundancies": [
         "Geo",
         "Zone",
         "Local"
       ],
       "isResidencyRestricted": false,
       "supportsAvailabilityZone": true
     },
     "type": "Microsoft.DocumentDB/locations"
   }
   

   Observação

   O comando anterior mostra uma lista de redundâncias de backup disponíveis na região específica. Os valores com suporte são exibidos na backupStorageRedundancies propriedade. Por exemplo, algumas regiões podem dar suporte a até três opções de redundância: Geográfica, Zona e Local. Outras regiões podem dar suporte a um subconjunto dessas opções. Antes de atualizar, escolha a opção de redundância de armazenamento de backup com suporte em todas as regiões que sua conta do Azure Cosmos DB utiliza.

3. Use o comando az cosmosdb update com a opção de redundância de backup escolhida para atualizar a redundância de backup em uma conta existente.

   az cosmosdb update \
       --resource-group <resource-group-name> \
       --name <account_name> \
       --backup-redundancy Zone
   

4. Como alternativa, use o comando az cosmosdb create para criar uma nova conta com a opção de redundância de backup escolhida.

   az cosmosdb create \
       --resource-group <resource-group-name> \
       --name <account-name> \
       --backup-redundancy Geo \
       --locations regionName=<azure-region>
   

PowerShell do Azure

1. Instale a versão mais recente do Azure PowerShell ou uma versão superior a 1.4.0.

   $parameters = @{
       Name = "Az.CosmosDB"
       RequiredVersion = "1.4.0"
   }
   Install-Module @parameters
   

2. Use o cmdlet Get-AzCosmosDBLocation para obter as opções de redundância de backup disponíveis nas regiões onde sua conta existe.

   $parameters = @{
       Location = "<azure-region>"
   }
   (Get-AzCosmosDBLocation @parameters).Properties
   

   A saída deve incluir um conteúdo semelhante a este exemplo:

   SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
   ------------------------ --------------------- -------------------------
                       True                 False {Geo, Zone, Local}
   

   Observação

   O comando anterior mostra uma lista de redundâncias de backup disponíveis na região específica. Os valores com suporte são exibidos na BackupStorageRedundancies propriedade. Por exemplo, algumas regiões podem dar suporte a até três opções de redundância: Geográfica, Zona e Local. Outras regiões podem dar suporte a um subconjunto dessas opções. Antes de atualizar, escolha a opção de redundância de armazenamento de backup com suporte em todas as regiões que sua conta do Azure Cosmos DB utiliza.

3. Use o cmdlet Update-AzCosmosDBAccount com a opção de redundância de backup escolhida para atualizar a redundância de backup em uma conta existente:

   $parameters = @{
       ResourceGroupName "<resource-group-name>"
       Name = "<account-name>"
       BackupStorageRedundancy = "Zone"
   }
   Update-AzCosmosDBAccount @parameters
   

4. Como alternativa, use o cmdlet New-AzCosmosDBAccount para criar uma nova conta com a opção de redundância de backup escolhida:

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       Location = "<azure-region>"
       BackupPolicyType = "Periodic"
       BackupStorageRedundancy = "Geo"
   }
   New-AzCosmosDBAccount @parameters
   

Adicionar o Azure Policy para redundância de armazenamento de backup

O Azure Policy ajuda a impor padrões organizacionais e a avaliar a conformidade em escala. Para mais informações, confira O que é o Azure Policy?.

O exemplo a seguir mostra como adicionar uma política do Azure a contas do Azure Cosmos DB para validar (usando o audit) se elas têm sua redundância de backup configurada para Local.

"parameters": {},
"policyRule": {
  "if": {
    "allOf": [
      {
        "field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
        "match": "Local"
      }
    ]
  },
  "then": {
    "effect": "audit"
  }
}

Próximas etapas

Modifique o intervalo de backup e o período de retenção