지속적인 백업 및 특정 시점 복원을 통해 Azure Cosmos DB 계정 프로비저닝

아티클
08/15/2024

적용 대상: NoSQL MongoDB

Azure Cosmos DB의 특정 시점 복원 기능을 사용하면 컨테이너 내에서 실수로 인한 변경을 복구하거나, 삭제된 리소스를 복원하거나, 백업이 있던 모든 지역으로 복원할 수 있습니다. 지속적인 백업 모드를 사용하면 지난 30일 또는 7일 이내의 모든 시점으로 복원할 수 있습니다. 시간을 얼마나 거슬러 올라갈 수 있는지는 계정에 대한 연속 모드의 계층에 따라 달라집니다.

이 문서에서는 Azure Portal, PowerShell, CLI 및 Resource Manager 템플릿을 사용하는 지속적인 백업 및 특정 시점 복원을 통해 계정을 프로비저닝하는 방법을 설명합니다.

참고 항목

다음 조건이 충족되는 경우에만 지속적인 백업 모드 계정을 프로비저닝할 수 있습니다.

계정이 API for NoSQL 또는 MongoDB 형식인 경우.
계정이 API for Table 또는 Gremlin 형식인 경우.
계정에 단일 쓰기 지역이 있는 경우

Azure Portal을 사용하여 프로비전

새 Azure Cosmos DB 계정을 만들 때 백업 정책 탭에서 연속 모드를 선택하여 새 계정에 특정 시점 복원 기능을 사용하도록 설정합니다. 특정 시점 복원을 사용하면 데이터는 새 계정으로 복원되며, 현재는 기존 계정으로 복원할 수 없습니다.

Azure PowerShell을 사용하여 프로비전

PowerShell 및 CLI 명령의 경우 계층 값은 선택 사항입니다(아직 제공되지 않은 경우). 제공되지 않은 경우 계정 백업이 30일 동안 보존됩니다. 계층은 Continuous7Days 또는 Continuous30Days 값으로 표현됩니다.

Azure PowerShell 최신 버전 설치
- 계정을 프로비전하기 전에 Azure PowerShell 6.2.0 이후 버전을 설치합니다. 최신 버전의 Azure PowerShell 대한 자세한 내용은 최신 버전의 Azure PowerShell을 참조하세요.
- Continuous7Days 계층을 프로비전하려면 Install-Module -Name Az.CosmosDB -AllowPrerelease를 실행하여 모듈의 미리 보기 버전을 설치해야 합니다.
다음으로 Azure 계정에 연결하고 다음 명령을 사용하여 필요한 구독을 선택합니다.
1. 다음 명령을사용하여 Azure에 로그인합니다.
```
Connect-AzAccount
```
2. 다음 명령을 사용하여 특정 구독을 선택합니다.
```
Select-AzSubscription -Subscription <SubscriptionName>
```

API for NoSQL 계정

지속적인 백업으로 계정을 프로비전하려면 일반 프로비전 명령과 함께 -BackupPolicyType Continuous 인수를 추가합니다.

다음 cmdlet은 MyRG 리소스 그룹의 미국 서부 지역에 있는 단일 지역 쓰기 계정인 Pitracct를 가정합니다. 계정에 지속적인 백업 정책이 사용하도록 설정되어 있습니다. 지속적인 백업은 Continuous7days 계층에서 구성됩니다.

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

MongoDB용 API

다음 cmdlet은 Continuous30days 계층으로 구성된 지속적인 백업 계정의 예입니다.

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

API for Table 계정

지속적인 백업으로 계정을 프로비전하려면 일반 프로비전 명령과 함께 -BackupPolicyType Continuous 인수를 추가합니다.

다음 cmdlet은 Continuous7days 계층과 관련된 지속적인 백업 정책의 예입니다.

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

API for Gremlin 계정

지속적인 백업으로 계정을 프로비전하려면 일반 프로비전 명령과 함께 -BackupPolicyType Continuous 인수를 추가합니다.

다음 cmdlet은 Continuous30days 계층에 지속적인 백업 정책이 구성된 계정의 예입니다.

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

Azure CLI를 사용하여 프로비전

PowerShell 및 CLI 명령의 경우 계층 값은 선택 사항이며 제공되지 않으면 계정 백업이 30일 동안 유지됩니다. 계층은 Continuous7Days 또는 Continuous30Days로 표현됩니다.

계정을 프로비저닝하려면 먼저 다음 단계에 따라 Azure CLI를 설치합니다.

최신 버전의 Azure CLI를 설치합니다. Azure CLI를 참조하세요.
로그인하고 구독 선택
- az login 명령을 사용하여 Azure 계정에 로그인합니다.
- az account set -s <subscriptionguid> 명령을 사용하여 필요한 구독을 선택합니다.

API for NoSQL 계정

API for NoSQL 계정에 지속적인 백업을 프로비저닝하려면 일반 프로비저닝 명령과 함께 추가 인수 --backup-policy-type Continuous를 전달해야 합니다. 다음 명령은 지속적인 백업 정책 및 Continuous7days 계층을 사용하는 Pitracct라는 단일 지역 쓰기 계정의 예입니다.


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

MongoDB용 API

다음 명령은 지속적인 백업 정책 및 Continuous30days 계층을 사용하는 Pitracct라는 단일 지역 쓰기 계정의 예를 보여 줍니다.

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 for Table 계정

다음 명령은 지속적인 백업 정책 및 Continuous30days 계층을 사용하는 Pitracct라는 단일 지역 쓰기 계정의 예를 보여 줍니다.

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 for Gremlin 계정

다음 명령은 MyRG 리소스 그룹 아래에 미국 서부 지역에서 만든 지속적인 백업 정책 및 Continuous7days 계층을 사용하는 Pitracct라는 단일 지역 쓰기 계정의 예를 보여 줍니다.

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"

Resource Manager 템플릿을 사용하여 프로비전

Azure Resource Manager 템플릿을 사용하여 연속 모드로 Azure Cosmos DB 계정을 배포할 수 있습니다. 계정을 프로비전할 템플릿을 정의할 때 다음 예와 같이 backupPolicy 및 계층 매개 변수를 포함합니다. 계층은 Continuous7Days 또는 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"
        } }

다음으로, Azure PowerShell 또는 CLI를 사용하여 템플릿을 배포합니다. 다음 예제에서는 CLI 명령을 사용하여 템플릿을 배포하는 방법을 보여줍니다.

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

다음을 통해 공유

지속적인 백업 및 특정 시점 복원을 통해 Azure Cosmos DB 계정 프로비저닝

Azure Portal을 사용하여 프로비전

Azure PowerShell을 사용하여 프로비전

API for NoSQL 계정

MongoDB용 API

API for Table 계정

API for Gremlin 계정

Azure CLI를 사용하여 프로비전

API for NoSQL 계정

MongoDB용 API

API for Table 계정

API for Gremlin 계정

Resource Manager 템플릿을 사용하여 프로비전

다음 단계

피드백

추가 리소스