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

Artigo
10/16/2024

APLICA-SE A: NoSQL MongoDB Cassandra Gremlin Tabela

Os dados de backup do modo de período do Azure Cosmos DB são replicados de maneiras diferentes. Se a região primária oferecer suporte a regiões emparelhadas, então, por padrão, o Azure Cosmos DB armazenará dados de backup de modo periódico no armazenamento de blob com redundância geográfica que é replicado para o par. 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. 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.

Entre no portal do Azure e navegue até sua conta do Azure Cosmos DB.
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.

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.
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.
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
```

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>

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

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.

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

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

Partilhar via

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

Pré-requisitos

Atualizar redundância de armazenamento

Adicionar uma Política do Azure para redundância de armazenamento de backup

Próximos passos

Comentários

Recursos adicionais