Aktualizowanie okresowej nadmiarowości magazynu kopii zapasowych dla usługi Azure Cosmos DB

Artykuł
01/10/2024

DOTYCZY: NoSQL MongoDB Kasandra Gremlin Stół

Domyślnie usługa Azure Cosmos DB przechowuje dane kopii zapasowej w trybie okresowym w magazynie obiektów blob geograficznie nadmiarowych replikowanych do sparowanego regionu. Można zastąpić domyślną nadmiarowość magazynu kopii zapasowych. W tym artykule wyjaśniono, jak zaktualizować nadmiarowość magazynu kopii zapasowych przy użyciu interfejsu wiersza polecenia platformy Azure i programu PowerShell. Pokazano również, jak skonfigurować zasady platformy Azure na kontach w celu wymuszenia wymaganej nadmiarowości magazynu.

Wymagania wstępne

Istniejące konto usługi Azure Cosmos DB.
- Jeśli masz subskrypcję platformy Azure, utwórz nowe konto.
- Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
- Alternatywnie możesz wypróbować usługę Azure Cosmos DB bezpłatnie przed zatwierdzeniem.

Aktualizowanie nadmiarowości magazynu

Wykonaj poniższe kroki, aby zaktualizować nadmiarowość magazynu kopii zapasowych.

Zaloguj się do witryny Azure Portal i przejdź do swojego konta usługi Azure Cosmos DB.
Otwórz okienko Kopia zapasowa i przywracanie, zaktualizuj nadmiarowość magazynu kopii zapasowych i wybierz pozycję Prześlij. Ukończenie operacji trwa kilka minut.

Upewnij się, że masz najnowszą wersję interfejsu wiersza polecenia platformy Azure lub wyższą lub równą wersji 2.30.0. Jeśli masz cosmosdb-preview zainstalowane rozszerzenie, pamiętaj, aby go usunąć.
az cosmosdb locations show Użyj polecenia , aby uzyskać opcje nadmiarowości kopii zapasowych dostępne w regionach, w których istnieje Twoje konto.
```
az cosmosdb locations show \
      --location <region-name>
```
Dane wyjściowe powinny zawierać dane JSON podobne do tego przykładu:
```
{
  "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"
}
```
Uwaga

Poprzednie polecenie przedstawia listę nadmiarowości kopii zapasowych dostępnych w określonym regionie. Obsługiwane wartości są wyświetlane we backupStorageRedundancies właściwości . Na przykład niektóre regiony mogą obsługiwać maksymalnie trzy opcje nadmiarowości: Geo, Zone i Local. Inne regiony mogą obsługiwać podzestaw tych opcji. Przed zaktualizowaniem wybierz opcję nadmiarowości magazynu kopii zapasowych obsługiwaną we wszystkich regionach używanych przez konto usługi Azure Cosmos DB.
az cosmosdb update Użyj polecenia z wybraną opcją nadmiarowości kopii zapasowej, aby zaktualizować nadmiarowość kopii zapasowej na istniejącym koncie.
```
az cosmosdb update \
    --resource-group <resource-group-name> \
    --name <account_name> \
    --backup-redundancy Zone
```

Alternatywnie użyj az cosmosdb create polecenia , aby utworzyć nowe konto z wybraną opcją nadmiarowości kopii zapasowej.

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

Zainstaluj najnowszą wersję programu Azure PowerShell lub wersję nowszą lub równą 1.4.0.

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

Get-AzCosmosDBLocation Użyj polecenia cmdlet , aby uzyskać opcje nadmiarowości kopii zapasowych dostępne w regionach, w których istnieje Twoje konto.
```
$parameters = @{
    Location = "<azure-region>"
}
(Get-AzCosmosDBLocation @parameters).Properties
```
Dane wyjściowe powinny zawierać zawartość podobną do tego przykładu:
```
SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
------------------------ --------------------- -------------------------
                    True                 False {Geo, Zone, Local}
```
Uwaga

Poprzednie polecenie przedstawia listę nadmiarowości kopii zapasowych dostępnych w określonym regionie. Obsługiwane wartości są wyświetlane we BackupStorageRedundancies właściwości . Na przykład niektóre regiony mogą obsługiwać maksymalnie trzy opcje nadmiarowości: Geo, Zone i Local. Inne regiony mogą obsługiwać podzestaw tych opcji. Przed zaktualizowaniem wybierz opcję nadmiarowości magazynu kopii zapasowych obsługiwaną we wszystkich regionach używanych przez konto usługi Azure Cosmos DB.
Update-AzCosmosDBAccount Użyj polecenia cmdlet z wybraną opcją nadmiarowości kopii zapasowej, aby zaktualizować nadmiarowość kopii zapasowej na istniejącym koncie:
```
$parameters = @{
    ResourceGroupName "<resource-group-name>"
    Name = "<account-name>"
    BackupStorageRedundancy = "Zone"
}
Update-AzCosmosDBAccount @parameters
```

Alternatywnie użyj New-AzCosmosDBAccount polecenia cmdlet , aby utworzyć nowe konto z wybraną opcją nadmiarowości kopii zapasowej:

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

Dodawanie usługi Azure Policy na potrzeby nadmiarowości magazynu kopii zapasowych

Usługa Azure Policy pomaga wymuszać standardy organizacyjne i oceniać zgodność na dużą skalę. Aby uzyskać więcej informacji, zobacz co to jest usługa Azure Policy?.

W poniższym przykładzie pokazano, jak dodać zasady platformy Azure dla kont usługi Azure Cosmos DB w celu zweryfikowania (przy użyciu ), auditże mają skonfigurowaną nadmiarowość kopii zapasowych na .Local

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

Następne kroki

Modyfikowanie interwału kopii zapasowej i okresu przechowywania

Udostępnij za pośrednictwem