VAN TOEPASSING OP:
NoSQL
MongoDB
Cassandra
Gremlin
Tafel
Back-upgegevens van de azure Cosmos DB-periodemodus worden op verschillende manieren gerepliceerd. Als de primaire regio gekoppelde regio's ondersteunt, slaat Azure Cosmos DB standaard periodieke back-upgegevens op in geografisch redundante blobopslag die naar het paar wordt gerepliceerd. U kunt de standaardredundantie voor back-upopslag overschrijven. Als u een niet-gekoppelde regio gebruikt, moet u ook expliciet de redundantie van de back-upopslag kiezen. In dit artikel wordt uitgelegd hoe u de redundantie van back-upopslag bijwerkt met behulp van Azure CLI en PowerShell. U ziet ook hoe u een Azure-beleid voor uw accounts configureert om de vereiste opslagredundantie af te dwingen.
Vereisten
- Een bestaand Azure Cosmos DB-account.
Opslagredundantie bijwerken
Gebruik de volgende stappen om redundantie van back-upopslag bij te werken.
Meld u aan bij Azure Portal en navigeer naar uw Azure Cosmos DB-account.
Open het deelvenster Back-up en herstel , werk de redundantie van de back-upopslag bij en selecteer Verzenden. Het duurt enkele minuten voordat de bewerking is voltooid.
Zorg ervoor dat u de nieuwste versie van Azure CLI of een versie hoger dan of gelijk aan 2.30.0 hebt. Als u de cosmosdb-preview
extensie hebt geïnstalleerd, moet u deze verwijderen.
Gebruik de az cosmosdb locations show
opdracht om de opties voor back-upredundantie op te halen die beschikbaar zijn in de regio's waar uw account zich bevindt.
az cosmosdb locations show \
--location <region-name>
De uitvoer moet JSON bevatten die vergelijkbaar is met dit voorbeeld:
{
"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"
}
Notitie
De vorige opdracht toont een lijst met back-upredundantie die beschikbaar is in de specifieke regio. Ondersteunde waarden worden weergegeven in de backupStorageRedundancies
eigenschap. Sommige regio's ondersteunen bijvoorbeeld maximaal drie redundantieopties: Geo, Zone en Lokaal. Andere regio's ondersteunen mogelijk een subset van deze opties. Voordat u het bijwerkt, kiest u de optie voor redundantie van back-upopslag die wordt ondersteund in alle regio's die uw Azure Cosmos DB-account gebruikt.
Gebruik de az cosmosdb update
opdracht met de gekozen optie voor back-upredundantie om de back-upredundantie voor een bestaand account bij te werken.
az cosmosdb update \
--resource-group <resource-group-name> \
--name <account_name> \
--backup-redundancy Zone
U kunt ook de az cosmosdb create
opdracht gebruiken om een nieuw account te maken met de gekozen optie voor back-upredundantie.
az cosmosdb create \
--resource-group <resource-group-name> \
--name <account-name> \
--backup-redundancy Geo \
--locations regionName=<azure-region>
Installeer de nieuwste versie van Azure PowerShell of een versie hoger dan of gelijk aan 1.4.0.
$parameters = @{
Name = "Az.CosmosDB"
RequiredVersion = "1.4.0"
}
Install-Module @parameters
Gebruik de Get-AzCosmosDBLocation
cmdlet om de opties voor back-upredundantie op te halen die beschikbaar zijn in de regio's waar uw account zich bevindt.
$parameters = @{
Location = "<azure-region>"
}
(Get-AzCosmosDBLocation @parameters).Properties
De uitvoer moet inhoud bevatten die vergelijkbaar is met dit voorbeeld:
SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
------------------------ --------------------- -------------------------
True False {Geo, Zone, Local}
Notitie
De vorige opdracht toont een lijst met back-upredundantie die beschikbaar is in de specifieke regio. Ondersteunde waarden worden weergegeven in de BackupStorageRedundancies
eigenschap. Sommige regio's ondersteunen bijvoorbeeld maximaal drie redundantieopties: Geo, Zone en Lokaal. Andere regio's ondersteunen mogelijk een subset van deze opties. Voordat u het bijwerkt, kiest u de optie voor redundantie van back-upopslag die wordt ondersteund in alle regio's die uw Azure Cosmos DB-account gebruikt.
Gebruik de Update-AzCosmosDBAccount
cmdlet met de gekozen optie voor back-upredundantie om de back-upredundantie voor een bestaand account bij te werken:
$parameters = @{
ResourceGroupName "<resource-group-name>"
Name = "<account-name>"
BackupStorageRedundancy = "Zone"
}
Update-AzCosmosDBAccount @parameters
U kunt ook de New-AzCosmosDBAccount
cmdlet gebruiken om een nieuw account te maken met de gekozen optie voor back-upredundantie:
$parameters = @{
ResourceGroupName = "<resource-group-name>"
Name = "<account-name>"
Location = "<azure-region>"
BackupPolicyType = "Periodic"
BackupStorageRedundancy = "Geo"
}
New-AzCosmosDBAccount @parameters
Een Azure Policy toevoegen voor redundantie van back-upopslag
Met Azure Policy kunt u organisatiestandaarden afdwingen en naleving op schaal beoordelen. Zie voor meer informatie wat Azure Policy is?
In het volgende voorbeeld ziet u hoe u een Azure-beleid voor Azure Cosmos DB-accounts toevoegt om te valideren (met behulp van audit
) dat de back-upredundantie is geconfigureerd voor Local
.
"parameters": {},
"policyRule": {
"if": {
"allOf": [
{
"field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
"match": "Local"
}
]
},
"then": {
"effect": "audit"
}
}
Volgende stappen