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