Memprovisikan akun Azure Cosmos DB dengan cadangan berkelanjutan dan pemulihan titik waktu

  • Artikel

BERLAKU UNTUK: Nosql MongoDB

Fitur pemulihan titik-waktu Azure Cosmos DB membantu Anda memulihkan dari perubahan yang tidak disengaja dalam kontainer, memulihkan sumber daya yang dihapus, atau memulihkan ke wilayah mana pun tempat cadangan berada. Mode pencadangan berkelanjutan memungkinkan Anda untuk memulihkan ke titik waktu mana pun dalam waktu 30 atau 7 hari terakhir. Seberapa jauh Anda dapat kembali ke suatu waktu tergantung pada tingkat mode berkelanjutan untuk akun tersebut.

Artikel ini menjelaskan cara memprovisikan akun dengan pencadangan berkelanjutan dan pemulihan titik waktu menggunakan portal Microsoft Azure, PowerShell, CLI, dan templat Resource Manager.

Catatan

Anda dapat menyediakan akun mode cadangan berkelanjutan hanya jika kondisi berikut benar:

  • Jika akun berjenis API untuk NoSQL atau MongoDB.
  • Jika akun berjenis API untuk Table atau Gremlin.
  • Jika akun memiliki satu wilayah penulisan.

Memprovisikan menggunakan portal Microsoft Azure

Saat membuat akun Azure Cosmos DB baru, di tab Kebijakan pencadangan, pilih mode berkelanjutan untuk mengaktifkan fungsi pemulihan titik waktu untuk akun baru. Dengan pemulihan titik waktu, data selalu dipulihkan ke akun baru, saat ini Anda tidak dapat memulihkan ke akun lama.

Menyediakan akun Azure Cosmos DB dengan konfigurasi cadangan berkelanjutan.

Memprovisikan menggunakan Azure PowerShell

Untuk perintah PowerShell dan CLI, nilai tingkat bersifat opsional, jika belum disediakan. Jika tidak disediakan, cadangan akun akan dipertahankan selama 30 hari. Tingkatan diwakili oleh nilai Continuous7Days atau Continuous30Days.

  1. Instal Azure PowerShell versi terbaru

    • Sebelum memprovisikan akun, instal versi mana pun dari Azure PowerShell yang lebih tinggi dari 6.2.0. Untuk informasi selengkapnya tentang versi terbaru Azure PowerShell, lihat versi terbaru Azure PowerShell.
    • Untuk memprovisikan tingkat Continuous7Days, Anda harus menginstal versi pratinjau modul dengan menjalankan Install-Module -Name Az.CosmosDB -AllowPrerelease.

  2. Selanjutnya sambungkan ke akun Azure Anda dan pilih langganan yang diperlukan dengan perintah berikut:

    1. Masuk ke Azure menggunakan perintah berikut:

      Connect-AzAccount

    2. Pilih langganan tertentu dengan perintah berikut ini:

      Select-AzSubscription -Subscription <SubscriptionName>

API untuk akun NoSQL

Untuk menyediakan akun dengan cadangan berkelanjutan, tambahkan argumen -BackupPolicyType Continuous bersama dengan perintah penyediaan reguler.

Cmdlet berikut mengasumsikan akun penulisan wilayah tunggal, Pitracct, di wilayah US Barat di grup sumber daya MyRG. Akun mengaktifkan kebijakan pencadangan berkelanjutan. Pencadangan berkelanjutan dikonfigurasi pada tingkat Continuous7days:

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

API untuk MongoDB

Cmdlet berikut adalah contoh akun pencadangan berkelanjutan yang dikonfigurasi dengan tingkat Continuous30days:

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

API untuk akun Tabel

Untuk menyediakan akun dengan cadangan berkelanjutan, tambahkan argumen -BackupPolicyType Continuous bersama dengan perintah penyediaan reguler.

Cmdlet berikut adalah contoh kebijakan pencadangan berkelanjutan dengan tingkat Continuous7days:

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

API untuk akun Gremlin

Untuk menyediakan akun dengan cadangan berkelanjutan, tambahkan argumen -BackupPolicyType Continuous bersama dengan perintah penyediaan reguler.

Cmdlet berikut adalah contoh akun dengan kebijakan pencadangan berkelanjutan yang dikonfigurasi dengan tingkat Continuous30days:

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

Mem-provisikan mengunakan Azure CLI

Untuk nilai tingkat perintah PowerShell dan CLI bersifat opsional, jika tidak disediakan – cadangan akun akan dipertahankan selama 30 hari. Tingkatan diwakili oleh Continuous7Days atau Continuous30Days.

Sebelum memprovisikan akun, pasang Azure CLI dengan langkah-langkah berikut:

  1. Instal versi terbaru Azure CLI, lihat Azure CLI

  2. Masuk dan pilih langganan Anda.

    • Masuk ke akun Azure Anda dengan az login perintah.
    • Pilih perintah langganan yang diperlukan az account set -s <subscriptionguid> menggunakan.

API untuk akun NoSQL

Untuk menyediakan API untuk akun NoSQL dengan pencadangan berkelanjutan, argumen --backup-policy-type Continuous tambahan harus diteruskan bersama dengan perintah provisi reguler. Perintah berikut adalah contoh akun penulisan wilayah tunggal bernama Pitracct dengan kebijakan pencadangan berkelanjutan dan tingkat Continuous7days:


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

API untuk MongoDB

Perintah berikut menampilkan contoh akun penulisan wilayah tunggal bernama Pitracct dengan kebijakan pencadangan berkelanjutan dan tingkat Continuous30days:

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 untuk akun Tabel

Perintah berikut menampilkan contoh akun penulisan wilayah tunggal bernama Pitracct dengan kebijakan pencadangan berkelanjutan dan tingkat Continuous30days:

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"

API untuk akun Gremlin

Perintah berikut menampilkan contoh akun penulisan wilayah tunggal bernama Pitracct dengan kebijakan cadangan berkelanjutan dan tingkat Continuous7days yang dibuat di wilayah US Barat pada grup sumber daya 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"

Memprovisikan menggunakan templat Resource Manager

Anda dapat menggunakan templat Microsoft Azure Resource Manager untuk menggunakan akun Microsoft Azure Cosmos DB dengan mode berkelanjutan. Saat menentukan templat untuk memprovisikan akun, sertakan backupPolicy dan parameter tingkat seperti yang ditunjukkan dalam contoh berikut, tingkat dapat berupa Continuous7Days atau 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"
        } }

Berikutnya, terapkan templat menggunakan Azure PowerShell atau CLI. Contoh berikut ini memperlihatkan cara menggunakan templat dengan perintah CLI:

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

Langkah berikutnya