Aprowizowanie konta usługi Azure Cosmos DB przy użyciu ciągłej kopii zapasowej i przywracania do punktu w czasie

DOTYCZY: Nosql Mongodb

Funkcja przywracania do punktu w czasie usługi Azure Cosmos DB ułatwia odzyskiwanie po przypadkowej zmianie w kontenerze, przywracanie usuniętego zasobu lub przywracanie do dowolnego regionu, w którym istniały kopie zapasowe. Tryb ciągłej kopii zapasowej umożliwia przywracanie do dowolnego punktu czasu w ciągu ostatnich 30 lub 7 dni. Jak daleko można przejść w czasie, zależy od warstwy trybu ciągłego dla konta.

W tym artykule wyjaśniono, jak aprowizować konto przy użyciu ciągłej kopii zapasowej i przywracania do punktu w czasie przy użyciu szablonów Azure Portal, programu PowerShell, interfejsu wiersza polecenia i Resource Manager.

Uwaga

Konto trybu ciągłej kopii zapasowej można aprowizować tylko wtedy, gdy spełnione są następujące warunki:

  • Jeśli konto jest typu API dla NoSQL lub MongoDB.
  • Jeśli konto jest typu INTERFEJS API dla tabeli lub Gremlin.
  • Jeśli konto ma jeden region zapisu.

Aprowizuj przy użyciu Azure Portal

Podczas tworzenia nowego konta usługi Azure Cosmos DB na karcie Zasady tworzenia kopii zapasowych wybierz tryb ciągły , aby włączyć funkcję przywracania do punktu w czasie dla nowego konta. W przypadku przywracania do punktu w czasie dane są przywracane do nowego konta, obecnie nie można przywrócić do istniejącego konta.

Aprowizuj konto usługi Azure Cosmos DB przy użyciu ciągłej konfiguracji kopii zapasowej.

Aprowizuj przy użyciu Azure PowerShell

W przypadku poleceń programu PowerShell i interfejsu wiersza polecenia wartość warstwy jest opcjonalna, jeśli nie została jeszcze podana. Jeśli nie zostanie podana kopia zapasowa konta, zostanie zachowana przez 30 dni. Warstwy są reprezentowane przez wartości Continuous7Days lub Continuous30Days.

  1. Zainstalowanie najnowszej wersji programu Azure PowerShell

    • Przed aprowizowaniem konta zainstaluj dowolną wersję Azure PowerShell wyższą niż 6.2.0. Aby uzyskać więcej informacji na temat najnowszej wersji Azure PowerShell, zobacz najnowszą wersję Azure PowerShell.
    • Aby aprowizować warstwę Continuous7Days , należy zainstalować wersję zapoznawcza modułu, uruchamiając polecenie Install-Module -Name Az.CosmosDB -AllowPrerelease.
  2. Następnie połącz się z kontem platformy Azure i wybierz wymaganą subskrypcję przy użyciu następujących poleceń:

    1. Zaloguj się do platformy Azure przy użyciu następującego polecenia:

      Connect-AzAccount
      
    2. Wybierz określoną subskrypcję przy użyciu następującego polecenia:

      Select-AzSubscription -Subscription <SubscriptionName>
      

Interfejs API dla konta NoSQL

Aby aprowizować konto przy użyciu ciągłej kopii zapasowej, dodaj argument -BackupPolicyType Continuous wraz z regularnym poleceniem aprowizacji.

Następujące polecenie cmdlet zakłada, że konto zapisu w jednym regionie, Pitracct, w regionie Zachodnie stany USA w grupie zasobów MyRG . Konto ma włączone zasady ciągłej kopii zapasowej. Ciągła kopia zapasowa jest konfigurowana w warstwie Continuous7days :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous7Days `
  -Name "pitracct" `
  -ApiKind "Sql"

Interfejs API dla bazy danych MongoDB

Następujące polecenie cmdlet to przykład konta ciągłej kopii zapasowej skonfigurowanego z warstwą Continuous30days :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous30Days `
  -Name "Pitracct" `
  -ApiKind "MongoDB" `
  -ServerVersion "3.6"

Interfejs API dla konta tabeli

Aby aprowizować konto przy użyciu ciągłej kopii zapasowej, dodaj argument -BackupPolicyType Continuous wraz z regularnym poleceniem aprowizacji.

Następujące polecenie cmdlet to przykład zasad ciągłej kopii zapasowej z warstwą Continuous7days :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous7Days `
  -Name "pitracct" `
  -ApiKind "Table"

Interfejs API dla konta gremlin

Aby aprowizować konto przy użyciu ciągłej kopii zapasowej, dodaj argument -BackupPolicyType Continuous wraz z regularnym poleceniem aprowizacji.

Następujące polecenie cmdlet to przykład konta z zasadami ciągłej kopii zapasowej skonfigurowanymi z warstwą Continuous30days :

New-AzCosmosDBAccount `
  -ResourceGroupName "MyRG" `
  -Location "West US" `
  -BackupPolicyType Continuous `
  -ContinuousTier Continuous30Days `
  -Name "pitracct" `
  -ApiKind "Gremlin" 

Aprowizuj przy użyciu interfejsu wiersza polecenia platformy Azure

W przypadku wartości warstwy poleceń programu PowerShell i interfejsu wiersza polecenia jest opcjonalna, jeśli nie zostanie podana — kopia zapasowa konta zostanie zachowana przez 30 dni. Warstwy są reprezentowane przez Continuous7Days element lub Continuous30Days.

Przed aprowizacją konta zainstaluj interfejs wiersza polecenia platformy Azure, wykonując następujące czynności:

  1. Instalowanie najnowszej wersji interfejsu wiersza polecenia platformy Azure, zobacz Interfejs wiersza polecenia platformy Azure

  2. Zaloguj się i wybierz swoją subskrypcję

    • Zaloguj się do konta platformy Azure za pomocą az login polecenia .
    • Wybierz wymaganą subskrypcję przy użyciu az account set -s <subscriptionguid> polecenia .

Interfejs API dla konta NoSQL

Aby aprowizować konto interfejsu API dla noSQL z ciągłą kopią zapasową, należy przekazać dodatkowy argument --backup-policy-type Continuous wraz z regularnym poleceniem aprowizacji. Następujące polecenie to przykład pojedynczego konta zapisu w regionie o nazwie Pitracct z zasadami i Continuous7days warstwą ciągłej kopii zapasowej:


az cosmosdb create \
  --name Pitracct \
  --resource-group MyRG \
  --backup-policy-type Continuous \
  --continuous-tier "Continuous7Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Interfejs API dla bazy danych MongoDB

Następujące polecenie przedstawia przykład konta zapisu w jednym regionie o nazwie Pitracct z zasadami i Continuous30days warstwą ciągłej kopii zapasowej:

az cosmosdb create \
  --name Pitracct \
  --kind MongoDB \
  --resource-group MyRG \
  --server-version "3.6" \
  --backup-policy-type Continuous \
  --continuous-tier "Continuous30Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Interfejs API dla konta tabeli

Następujące polecenie przedstawia przykład konta zapisu w jednym regionie o nazwie Pitracct z zasadami i Continuous30days warstwą ciągłej kopii zapasowej:

az cosmosdb create \
  --name Pitracct \
  --kind GlobalDocumentDB  \
  --resource-group MyRG \
  --capabilities EnableTable \ 
  --backup-policy-type Continuous \
  --continuous-tier "Continuous30Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Interfejs API dla konta gremlin

Następujące polecenie przedstawia przykład konta zapisu w jednym regionie o nazwie Pitracct z zasadami ciągłej kopii zapasowej i Continuous7days warstwą utworzoną w regionie Zachodnie stany USA w grupie zasobów MyRG :

az cosmosdb create \
  --name Pitracct \
  --kind GlobalDocumentDB  \
  --resource-group MyRG \
  --capabilities EnableGremlin \ 
  --backup-policy-type Continuous \
  --continuous-tier "Continuous7Days" \
  --default-consistency-level Session \
  --locations regionName="West US"

Aprowizuj przy użyciu szablonu Resource Manager

Szablony usługi Azure Resource Manager umożliwiają wdrażanie konta usługi Azure Cosmos DB w trybie ciągłym. Podczas definiowania szablonu w celu aprowizacji konta dołącz backupPolicy parametr i warstwy, jak pokazano w poniższym przykładzie, warstwa może mieć wartość Continuous7Days lub Continuous30Days :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "name": "ademo-pitr1",
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2023-04-15",
      "location": "West US",
      "properties": {
        "locations": [
          {
            "locationName": "West US"
          }
        ],
        "backupPolicy":{
        "type":"Continuous", 
        "continuousModeProperties":{
        "tier":"Continuous7Days"
        }
        } 
        "databaseAccountOfferType": "Standard"
        } }

Następnie wdróż szablon przy użyciu Azure PowerShell lub interfejsu wiersza polecenia. W poniższym przykładzie pokazano, jak wdrożyć szablon za pomocą polecenia interfejsu wiersza polecenia:

az deployment group create -g <ResourceGroup> --template-file <ProvisionTemplateFilePath>

Następne kroki