Atualizar redundância de armazenamento de backup periódico para o Azure Cosmos DB

APLICA-SE A: NoSQL MongoDB Cassandra Gremlin Tabela

Por padrão, o Azure Cosmos DB armazena dados de backup de modo periódico em armazenamento de blob com redundância geográfica que é replicado para uma região emparelhada. Você pode substituir a redundância de armazenamento de backup padrão. Este 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 não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
  • Como alternativa, você pode experimentar o Azure Cosmos DB gratuitamente antes de confirmar.

Atualizar 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é sua conta do Azure Cosmos DB.

2. Abra o painel Backup & Restore , atualize a redundância de armazenamento de backup e selecione Enviar. A operação demora alguns minutos a ser concluída.

   

CLI do Azure

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

2. Use o az cosmosdb locations show comando 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"
   }
   

   Nota

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

3. Use o az cosmosdb update comando 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 az cosmosdb create comando 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>
   

Azure PowerShell

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

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

2. Use o Get-AzCosmosDBLocation cmdlet 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 conteúdo semelhante a este exemplo:

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

   Nota

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

3. Use o Update-AzCosmosDBAccount cmdlet 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 New-AzCosmosDBAccount cmdlet 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 uma Política do Azure para redundância de armazenamento de backup

A Política do Azure ajuda-o a aplicar padrões organizacionais e a avaliar a conformidade em escala. Para obter mais informações, consulte O que é a Política do Azure?.

O exemplo a seguir mostra como adicionar uma política do Azure para contas do Azure Cosmos DB para validar (usando audit) que 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óximos passos

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