Zřízení účtu služby Azure Cosmos DB s průběžným zálohováním a obnovením k určitému bodu v čase

  • Platí pro: ✅ NoSQL, ✅ MongoDB

Funkce obnovení k určitému bodu v čase ve službě Azure Cosmos DB pomáhá zotavit se z náhodné změny v kontejneru, obnovit odstraněný prostředek nebo obnovit v libovolném regionu, kde byly zálohy dostupné. Režim průběžného zálohování umožňuje obnovit do libovolného bodu času během posledních 30 nebo 7 dnů. Jak daleko se můžete vrátit v čase, závisí na úrovni průběžného režimu pro účet.

Tento článek vysvětluje, jak vytvořit účet s kontinuálním zálohováním a obnovou stavu k určitému časovému bodu pomocí Azure portálu, PowerShellu, CLI a šablon Resource Manageru.

Note

Účet v režimu průběžného zálohování můžete vytvořit pouze v případě, že jsou splněné následující podmínky:

  • Pokud je účet typu API pro NoSQL nebo MongoDB.
  • Pokud je účet typu API pro tabulku nebo Gremlin.
  • Pokud má účet jednu oblast zápisu.

Zřízení pomocí webu Azure Portal

Při vytváření nového účtu služby Azure Cosmos DB v kartě Zásady zálohování zvolte průběžný režim, abyste povolili funkci obnovení k určitému bodu v čase pro nový účet. Při obnovení k určitému bodu v čase se data obnoví do nového účtu, momentálně není možné provést obnovení do existujícího účtu.

Zřízení účtu služby Azure Cosmos DB s konfigurací průběžného zálohování

Zřízení pomocí Azure PowerShellu

Pro příkazy PowerShellu a rozhraní příkazového řádku je hodnota vrstvy volitelná, pokud ještě není k dispozici. Pokud není poskytnutá záloha účtu, zůstane zachována po dobu 30 dnů. Úrovně jsou reprezentovány hodnotami Continuous7Days nebo Continuous30Days.

  1. Instalace nejnovější verze Azure PowerShellu

    • Před zřízením účtu nainstalujte libovolnou verzi Azure PowerShellu vyšší než 6.2.0. Další informace o nejnovější verzi Azure PowerShellu najdete v nejnovější verzi Azure PowerShellu.
    • Ke zřízení úrovně Continuous7Days budete muset nainstalovat předběžnou verzi modulu spuštěním Install-Module -Name Az.CosmosDB -AllowPrerelease příkazu.

  2. Pak se připojte ke svému účtu Azure a vyberte požadované předplatné pomocí následujících příkazů:

    1. Přihlaste se k Azure pomocí následujícího příkazu:

      Connect-AzAccount

    2. Pomocí následujícího příkazu vyberte konkrétní předplatné:

      Select-AzSubscription -Subscription <SubscriptionName>

Rozhraní API pro účet NoSQL

Pokud chcete zřídit účet s průběžným zálohováním, přidejte argument -BackupPolicyType Continuous spolu s běžným příkazem zřizování.

Následující cmdlet předpokládá účet pro zápis do jedné oblasti, Pitracct, v oblasti West US ve skupině prostředků MyRG. Účet má povolené zásady průběžného zálohování. Průběžné zálohování se konfiguruje na Continuous7days úrovni:

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

Rozhraní API pro MongoDB

Následující rutina je příkladem účtu průběžného zálohování nakonfigurovaného s Continuous30days úrovní:

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

API pro účet Tabulka

Pokud chcete zřídit účet s průběžným zálohováním, přidejte argument -BackupPolicyType Continuous spolu s běžným příkazem zřizování.

Následující příkaz cmdlet je příkladem průběžné zálohovací politiky s úrovní Continuous7days:

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

Rozhraní API pro účet Gremlin

Pokud chcete zřídit účet s průběžným zálohováním, přidejte argument -BackupPolicyType Continuous spolu s běžným příkazem zřizování.

Následující rutina je příkladem účtu s nakonfigurovanými zásadami průběžného zálohování s Continuous30days úrovní:

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

Zřízení pomocí Azure CLI

Pokud pro příkazy PowerShellu a rozhraní příkazového řádku není hodnota úrovně zadána, zůstane záloha účtu zachována po dobu 30 dnů. Úrovně jsou reprezentovány Continuous7Days nebo Continuous30Days.

Před zřízením účtu nainstalujte Azure CLI pomocí následujících kroků:

  1. Instalace nejnovější verze Azure CLI, viz Azure CLI

  2. Přihlaste se a vyberte své předplatné.

    • Přihlaste se ke svému účtu Azure pomocí az login příkazu.
    • Vyberte požadované předplatné pomocí az account set -s <subscriptionguid> příkazu.

Rozhraní API pro účet NoSQL

Pokud chcete zřídit účet API pro NoSQL s průběžným zálohováním, měl by se spolu s běžným příkazem zřizování předat další argument --backup-policy-type Continuous . Následující příkaz je příkladem účtu pro zápis do jediné oblasti s názvem Pitracct se zásadami průběžného zálohování a úrovní Continuous7days.


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

Rozhraní API pro MongoDB

Následující příkaz ukazuje příklad účtu pro zápis do jedné oblasti s názvem Pitracct se zásadami průběžného zálohování a Continuous30days úrovní:

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"

API pro účet Tabulka

Následující příkaz ukazuje příklad účtu pro zápis do jedné oblasti s názvem Pitracct se zásadami průběžného zálohování a Continuous30days úrovní:

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"

Rozhraní API pro účet Gremlin

Následující příkaz ukazuje příklad účtu pro zápis do jedné oblasti s názvem Pitracct se zásadami průběžného zálohování a Continuous7days vrstvou vytvořenou v oblasti Západ USA v rámci skupiny prostředků 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"

Zřízení pomocí šablony Resource Manageru

Pomocí šablon Azure Resource Manageru můžete nasadit účet služby Azure Cosmos DB s průběžným režimem. Při definování šablony pro zřízení účtu zahrňte backupPolicy a parametr vrstvy, jak je znázorněno v následujícím příkladu, vrstva může být Continuous7Days nebo 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"
        } }

Dále nasaďte šablonu pomocí Azure PowerShellu nebo rozhraní příkazového řádku. Následující příklad ukazuje, jak nasadit šablonu pomocí příkazu rozhraní příkazového řádku:

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

Další kroky

  • Poslední aktualizace v