다음을 통해 공유


연속 백업 모드를 사용하는 Azure Cosmos DB 계정 복원

적용 대상: NoSQL MongoDB Gremlin 테이블

Azure Cosmos DB의 특정 시점 복원 기능을 사용하면 컨테이너 내에서 실수로 인한 변경을 복구하거나, 삭제된 계정, 데이터베이스 또는 컨테이너를 복원하거나, 백업이 있던 모든 지역으로 복원할 수 있습니다. 지속적인 백업 모드를 사용하면 지난 30일 이내의 모든 시점으로 복원할 수 있습니다.

이 문서에서는 복원 시간을 식별하고 라이브 또는 삭제된 Azure Cosmos DB 계정을 복원하는 방법을 설명합니다. Azure Portal, PowerShell, CLI 또는 Azure Resource Manager 템플릿을 사용하여 계정을 복원하는 방법을 보여 줍니다.

Azure Portal을 사용하여 계정 복원

실수로 수정한 라이브 계정 복원

Azure Portal을 사용하여 라이브 계정이나 전체 라이브 계정으로 선택한 데이터베이스 및 컨테이너를 복원할 수 있습니다. 데이터를 복원하려면 다음 단계를 따르세요.

  1. Azure Portal에 로그인합니다.

  2. Azure Cosmos DB 계정으로 이동하여 특정 시점 복원 블레이드를 엽니다.

    참고 항목

    Azure Portal의 복원 블레이드는 Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read 권한이 있는 경우에만 채워집니다. 이 권한을 설정하는 방법에 대한 자세한 내용은 백업 및 복원 권한 문서를 참조하세요.

  3. 복원하려면 다음 세부 정보를 입력합니다.

    • 복원 지점(UTC) – 지난 30일 이내의 타임스탬프입니다. 해당 타임스탬프에 계정이 있어야 합니다. UTC로 복원 지점을 지정할 수 있습니다. 복원 지점은 초 단위까지 지정할 수 있습니다. 복원 지점을 식별하는 방법에 대한 도움말을 보려면 여기를 클릭 링크를 선택합니다.

    • 위치 – 계정이 복원되는 대상 지역입니다. 계정이 지정된 타임스탬프에 이 지역(예: 미국 서부 또는 미국 동부)에 있어야 합니다. 계정은 원본 계정이 있었던 지역으로만 복원할 수 있습니다.

    • 리소스 복원전체 계정 또는 선택한 데이터베이스/컨테이너를 복원하도록 선택할 수 있습니다. 데이터베이스와 컨테이너는 지정된 타임스탬프에 있어야 합니다. 선택한 복원 지점 및 위치에 따라 복원 리소스가 채워지므로 사용자가 복원해야 하는 특정 데이터베이스나 컨테이너를 선택할 수 있습니다.

    • 리소스 그룹 - 대상 계정이 만들어지고 복원되는 리소스 그룹입니다. 이 리소스 그룹은 이미 있어야 합니다.

    • 복원 대상 계정 - 대상 계정 이름입니다. 대상 계정 이름은 새 계정을 만들 때와 동일한 지침을 따라야 합니다. 이 계정은 원본 계정이 있는 곳과 동일한 지역에 복원 프로세스를 통해 생성됩니다.

    Azure Portal에서 실수로 수정한 라이브 계정을 복원합니다.

  4. 위의 매개 변수를 선택한 후 제출 단추를 선택하여 복원을 시작합니다. 복원 비용은 선택한 지역의 데이터 크기와 백업 스토리지 비용을 기반으로 하는 일회성 요금입니다. 자세한 내용은 가격 책정 섹션을 참조하세요.

복원이 진행 중인 동안 원본 계정을 삭제하면 복원이 실패할 수 있습니다.

라이브 계정의 복원 가능한 타임스탬프

삭제되지 않은 Azure Cosmos DB 라이브 계정을 복원하려면 항상 컨테이너의 복원 가능한 최신 타임스탬프를 식별하는 것이 좋습니다. 그런 다음, 이 타임스탬프를 사용하여 계정을 최신 버전으로 복원할 수 있습니다.

이벤트 피드를 사용하여 복원 시간 파악

Azure Portal의 복원 지점 시간을 입력할 때 복원 지점을 파악하는 데 도움이 필요하면 여기를 클릭 링크를 선택합니다. 그러면 이벤트 피드 블레이드로 이동합니다. 이벤트 피드에는 원본 계정의 데이터베이스 및 컨테이너에 대한 완전히 신뢰할 수 있는 create, replace, delete 이벤트 목록이 제공됩니다.

예를 들어 특정 컨테이너를 삭제하거나 업데이트하기 이전의 지점으로 복원하려면 이 이벤트 피드를 확인합니다. 이벤트가 발생한 시간의 내림차순으로 표시되고 최근 이벤트가 위쪽에 표시됩니다. 결과를 찾아보고 이벤트 전후 시간을 선택하여 시간을 더 좁힐 수 있습니다.

이벤트 피드를 사용하여 복원 지점 시간을 파악합니다.

참고 항목

항목 리소스에 대한 변경 내용은 이벤트 피드에 표시되지 않습니다. 복원에는 항상 지난 30일 이내의 타임스탬프를 수동으로 지정할 수 있습니다(해당 시간에 계정이 있는 경우에 한함).

삭제된 계정 복원

삭제된 계정을 삭제일로부터 30일 이내에 Azure Portal을 사용하여 완전히 복원할 수 있습니다. 삭제된 계정을 복원하려면 다음 단계를 따르세요.

  1. Azure Portal에 로그인합니다.

  2. 글로벌 검색 창에서 Azure Cosmos DB 리소스를 검색합니다. 그러면 기존 계정이 모두 나열됩니다.

  3. 그런 다음, 복원 단추를 선택합니다. 복원 블레이드에는 보존 기간(삭제 시간으로부터 30일) 내에 복원할 수 있는 삭제된 계정의 목록이 표시됩니다.

  4. 복원하려는 계정을 선택합니다.

    Azure Portal에서 삭제된 계정을 복원합니다.

    참고 항목

    Azure Portal의 복원 블레이드는 Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read 권한이 있는 경우에만 채워집니다. 이 권한을 설정하는 방법에 대한 자세한 내용은 백업 및 복원 권한 문서를 참조하세요.

  5. 복원할 계정을 선택하고 다음 세부 정보를 입력하여 삭제된 계정을 복원합니다.

    • 복원 지점(UTC) – 지난 30일 이내의 타임스탬프입니다. 해당 타임스탬프에 계정이 있어야 합니다. UTC로 복원 지점을 지정합니다. 복원 지점은 초 단위까지 지정할 수 있습니다.

    • 위치 – 계정을 복원해야 하는 대상 지역입니다. 원본 계정이 지정된 타임스탬프에 이 지역에 있어야 합니다. 예를 들면 미국 서부 또는 미국 동부입니다.

    • 리소스 그룹 - 대상 계정이 만들어지고 복원되는 리소스 그룹입니다. 이 리소스 그룹은 이미 있어야 합니다.

    • 복원 대상 계정 – 대상 계정 이름은 새 계정을 만들 때와 동일한 지침을 따라야 합니다. 이 계정은 원본 계정이 있는 곳과 동일한 지역에 복원 프로세스를 통해 생성됩니다.

복원 작업의 상태 추적

복원 작업을 시작한 후 포털의 오른쪽 상단 모서리에 있는 알림 벨 아이콘을 선택합니다. 그러면 복원 중인 계정의 상태를 표시하는 링크가 제공됩니다. 복원이 진행 중인 동안에는 계정 상태가 생성 중이고, 복원 작업이 완료된 후에는 계정 상태가 온라인으로 변경됩니다.

작업이 완료되면 복원된 계정의 상태가 생성 중에서 온라인으로 변경됩니다.

복원된 계정에서 복원 세부 정보 가져오기

복원 작업이 완료된 후 복원한 원본 계정 세부 정보 또는 복원 시간을 알고 싶을 수 있습니다.

다음 단계에서 Azure Portal에서 복원 세부 정보를 가져옵니다.

  1. Azure Portal에 로그인하고 복원된 계정으로 이동합니다.

  2. 템플릿 내보내기 창으로 이동합니다. 복원된 계정에 해당하는 JSON 템플릿이 열립니다.

Azure PowerShell을 사용하여 계정 복원

계정을 복원하기 전에 최신 버전의 Azure PowerShell 또는 9.6.0보다 높은 버전을 설치합니다. 다음으로 Azure 계정에 연결하고 다음 명령을 사용하여 필요한 구독을 선택합니다.

  1. 다음 명령을사용하여 Azure에 로그인합니다.

    Connect-AzAccount
    
  2. 다음 명령을 사용하여 특정 구독을 선택합니다.

    Select-AzSubscription -Subscription <SubscriptionName>
    

API for NoSQL 계정에 대한 복원 작업 트리거

다음 cmdlet은 대상 계정, 원본 계정, 위치, 리소스 그룹, PublicNetworkAccess, DisableTtl 및 타임스탬프를 사용하여 복원 명령으로 복원 작업을 트리거하는 예입니다.


Restore-AzCosmosDBAccount `
  -TargetResourceGroupName "MyRG" `
  -TargetDatabaseAccountName "RestoredAccountName" `
  -SourceDatabaseAccountName "SourceDatabaseAccountName" `
  -RestoreTimestampInUtc "UTCTime" `
  -Location "AzureRegionName" ` 
  -PublicNetworkAccess Disabled `
  -DisableTtl $true

예제 1: 전체 계정 복원:


Restore-AzCosmosDBAccount `
  -TargetResourceGroupName "MyRG" `
  -TargetDatabaseAccountName "Pitracct" `
  -SourceDatabaseAccountName "source-sql" `
  -RestoreTimestampInUtc "2021-01-05T22:06:00" `
  -Location "West US" `
  -PublicNetworkAccess Disabled
  -DisableTtl $false


PublicNetworkAccess가 설정되지 않은 경우 복원된 계정은 공용 네트워크에서 액세스할 수 있습니다. 복원된 계정에 대한 공용 네트워크 액세스를 사용하지 않도록 설정하는 PublicNetworkAccess 옵션에 Disabled를 전달해야 합니다. disable-ttl을 $true로 설정하면 복원된 계정에서 TTL이 사용하지 않도록 설정됩니다. 매개 변수를 제공하지 않으면 이전에 설정된 TTL이 사용하도록 설정된 계정이 복원됩니다.

참고 항목

공용 네트워크 액세스를 사용하지 않도록 설정하여 복원하려는 경우 필요한 Az.CosmosDB의 최소 안정적 버전은 1.12.0입니다.

예제 2: 특정 컬렉션 및 데이터베이스 복원. 이 예제는 MyDB1에서 컬렉션 MyCol1, MyCol2를 복원하고, MyDB2에서 그 아래에 있는 모든 컨테이너를 포함한 전체 데이터베이스를 복원합니다.

$datatabaseToRestore1 = New-AzCosmosDBDatabaseToRestore -DatabaseName "MyDB1" -CollectionName "MyCol1", "MyCol2"
$datatabaseToRestore2 = New-AzCosmosDBDatabaseToRestore -DatabaseName "MyDB2"

Restore-AzCosmosDBAccount `
  -TargetResourceGroupName "MyRG" `
  -TargetDatabaseAccountName "Pitracct" `
  -SourceDatabaseAccountName "SourceSql" `
  -RestoreTimestampInUtc "2021-01-05T22:06:00" `
  -DatabasesToRestore $datatabaseToRestore1, $datatabaseToRestore2 `
  -Location "West US"

예 3: API for Gremlin 계정 복원 이 예에서는 MyDB1 및 그 아래에 있는 모든 컨테이너를 포함하는 전체 데이터베이스 MyDB2에서 그래프 graph1, graph2를 복원합니다.

$datatabaseToRestore1 = New-AzCosmosDBGremlinDatabaseToRestore  -DatabaseName "MyDB1" -GraphName "graph1", "graph2"  
$datatabaseToRestore2 = New-AzCosmosDBGremlinDatabaseToRestore  -DatabaseName "MyDB2"

Restore-AzCosmosDBAccount `
  -TargetResourceGroupName "MyRG" `
  -TargetDatabaseAccountName "Pitracct" `
  -SourceDatabaseAccountName "SourceGremlin" `
  -RestoreTimestampInUtc "2022-04-05T22:06:00" `
  -DatabasesToRestore $datatabaseToRestore1, $datatabaseToRestore2 `
  -Location "West US"

예 4: API for Table 계정 복원 이 예에서는 MyDB1에서 table1, table1 테이블을 복원합니다.

$tablesToRestore  = New-AzCosmosDBTableToRestore -TableName "table1", "table2"  

Restore-AzCosmosDBAccount `
  -TargetResourceGroupName "MyRG" `
  -TargetDatabaseAccountName "Pitracct" `
  -SourceDatabaseAccountName "SourceTable" `
  -RestoreTimestampInUtc "2022-04-06T22:06:00" `
  -TablesToRestore $tablesToRestore ` 
  -Location "West US"

CLI를 사용하여 관리 ID로 구성된 연속 계정을 복원하려면

CMK(고객 관리형 키) 연속 계정을 복원하려면 여기에 제공된 단계를 참조하세요.

복원된 계정에서 복원 세부 정보 가져오기

Az.CosmosDB 모듈 버전 1.12.0을 가져오고 다음 명령을 실행하여 복원 세부 정보를 가져옵니다. 다음과 같이 restoreTimestamp는 restoreParameters 개체 아래에 있습니다.

Get-AzCosmosDBAccount -ResourceGroupName MyResourceGroup -Name MyCosmosDBDatabaseAccount 

API for NoSQL의 복원 가능한 리소스 열거

열거형 cmdlet은 다양한 타임스탬프에서 복원이 가능한 리소스를 검색하는 데 도움이 됩니다. 또한 복원 가능한 계정, 데이터베이스 및 컨테이너 리소스에 대한 주요 이벤트의 피드를 제공합니다.

현재 구독에서 복원할 수 있는 모든 계정 나열

Get-AzCosmosDBRestorableDatabaseAccountPowerShell 명령을 실행하여 현재 구독에서 복원할 수 있는 모든 계정을 나열합니다.

응답에는 복원할 수 있는 모든 데이터베이스 계정(라이브 및 삭제된 계정 모두)과 복원할 수 있는 지역이 포함됩니다.

{
    "accountName": "SampleAccount",
    "apiType": "Sql",
    "creationTime": "2020-08-08T01:04:52.070190+00:00",
    "deletionTime": null,
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "identity": null,
    "location": "West US",
    "name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "restorableLocations": [
      {
        "creationTime": "2020-08-08T01:04:52.945185+00:00",
        "deletionTime": null,
        "location": "West US",
        "regionalDatabaseAccountInstanceId": "30701557-ecf8-43ce-8810-2c8be01dccf9"
      },
      {
        "creationTime": "2020-08-08T01:15:43.507795+00:00",
        "deletionTime": null,
        "location": "East US",
        "regionalDatabaseAccountInstanceId": "8283b088-b67d-4975-bfbe-0705e3e7a599"
      }
    ],
    "tags": null,
    "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts"
  }

계정의 CreationTime 또는 DeletionTime와 마찬가지로 지역에도 CreationTime 또는 DeletionTime가 있습니다. 이러한 시간을 사용하여 올바른 지역 및 해당 지역으로 복원할 유효한 시간 범위를 선택할 수 있습니다.

라이브 데이터베이스 계정에서 모든 버전의 SQL 데이터베이스를 나열

모든 버전의 데이터베이스를 나열하면 데이터베이스의 실제 존재 시간을 알 수 없는 시나리오에서 올바른 데이터베이스를 선택할 수 있습니다.

다음 PowerShell 명령을 실행하여 모든 버전의 데이터베이스를 나열합니다. 이 명령은 라이브 계정에서만 작동합니다. DatabaseAccountInstanceIdLocation 매개 변수는 Get-AzCosmosDBRestorableDatabaseAccount cmdlet의 응답에서 namelocation 속성으로부터 가져옵니다. DatabaseAccountInstanceId 특성은 복원되는 원본 데이터베이스 계정의 instanceId 속성을 참조합니다.


Get-AzCosmosdbSqlRestorableDatabase `
  -Location "East US" `
  -DatabaseAccountInstanceId <DatabaseAccountInstanceId>

라이브 데이터베이스 계정의 데이터베이스에서 모든 SQL 컨테이너 버전을 나열

다음 명령을 사용하여 모든 버전의 SQL 컨테이너를 나열합니다. 이 명령은 라이브 계정에서만 작동합니다. DatabaseRId 매개 변수는 복원하려는 데이터베이스의 ResourceId입니다. Get-AzCosmosdbSqlRestorableDatabase cmdlet의 응답에 포함된 ownerResourceid 특성의 값입니다. 이 응답에는 이 데이터베이스 내의 모든 컨테이너에 대해 수행된 작업의 목록도 포함되어 있습니다.


Get-AzCosmosdbSqlRestorableContainer `
  -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" `
  -DatabaseRId "AoQ13r==" `
  -Location "West US"

특정 타임스탬프에서 복원할 수 있는 데이터베이스 또는 컨테이너 찾기

다음 명령을 사용하여 특정 타임스탬프에서 복원할 수 있는 데이터베이스 또는 컨테이너의 목록을 가져옵니다. 이 명령은 라이브 계정에서만 작동합니다.


Get-AzCosmosdbSqlRestorableResource `
  -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" `
  -Location "West US" `
  -RestoreLocation "East US" `
  -RestoreTimestamp "2020-07-20T16:09:53+0000"

API for MongoDB에서 복원 가능한 리소스 열거

아래에 설명된 열거 명령은 다양한 타임스탬프에서 복원에 사용할 수 있는 리소스를 검색하는 데 유용합니다. 또한 복원 가능한 계정, 데이터베이스 및 컨테이너 리소스에 대한 주요 이벤트의 피드를 제공합니다. 이러한 명령은 라이브 계정에서만 작동하며 API for NoSQL 명령과 유사하지만 명령 이름에 sql 대신 MongoDB가 있습니다.

라이브 데이터베이스 계정에서 모든 버전의 MongoDB 데이터베이스를 나열


Get-AzCosmosdbMongoDBRestorableDatabase `
  -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" `
  -Location "West US"

라이브 데이터베이스 계정의 데이터베이스에서 모든 버전의 MongoDB 컬렉션을 나열


Get-AzCosmosdbMongoDBRestorableCollection `
  -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" `
  -DatabaseRId "AoQ13r==" `
  -Location "West US"

특정 타임스탬프 및 지역에서 복원에 사용할 수 있는 MongoDB 데이터베이스 계정의 모든 리소스를 나열


Get-AzCosmosdbMongoDBRestorableResource `
  -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" `
  -Location "West US" `
  -RestoreLocation "West US" `
  -RestoreTimestamp "2020-07-20T16:09:53+0000"

API for Gremlin의 복원 가능한 리소스 열거

열거형 cmdlet은 다양한 타임스탬프에서 복원이 가능한 리소스를 검색하는 데 도움이 됩니다. 또한 복원 가능한 계정, 데이터베이스 및 그래프 리소스에 대한 주요 이벤트 피드도 제공합니다.

라이브 데이터베이스 계정에 있는 모든 버전의 Gremlin 데이터베이스 나열

모든 버전의 데이터베이스를 나열하면 데이터베이스의 실제 존재 시간을 알 수 없는 시나리오에서 올바른 데이터베이스를 선택할 수 있습니다. 다음 PowerShell 명령을 실행하여 모든 버전의 데이터베이스를 나열합니다. 이 명령은 라이브 계정에서만 작동합니다. DatabaseAccountInstanceIdLocation 매개 변수는 Get-AzCosmosDBRestorableDatabaseAccount cmdlet의 응답에서 namelocation 속성으로부터 가져옵니다. DatabaseAccountInstanceId 특성은 복원되는 원본 데이터베이스 계정의 instanceId 속성을 참조합니다.

Get-AzCosmosdbGremlinRestorableDatabase ` 
   -Location "East US" ` 
   -DatabaseAccountInstanceId <DatabaseAccountInstanceId> 

라이브 데이터베이스 계정에 있는 데이터베이스의 모든 Gremlin 그래프 버전 나열

다음 명령을 사용하여 API for Gremlin 그래프의 모든 버전을 나열합니다. 이 명령은 라이브 계정에서만 작동합니다. DatabaseRId 매개 변수는 복원하려는 데이터베이스의 ResourceId입니다. Get-AzCosmosdbGremlinRestorableDatabase cmdlet의 응답에 포함된 ownerResourceid 특성의 값입니다. 응답에는 이 데이터베이스 내의 모든 그래프에서 수행된 작업 목록도 포함됩니다.

Get-AzCosmosdbGremlinRestorableGraph ` 
   -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" ` 
   -DatabaseRId "AoQ13r==" ` 
   -Location "West US" 

지정된 타임스탬프에서 복원할 수 있는 데이터베이스 또는 그래프 찾기

다음 명령을 사용하여 지정된 타임스탬프에서 복원할 수 있는 데이터베이스 또는 그래프 목록을 가져옵니다. 이 명령은 라이브 계정에서만 작동합니다.

Get-AzCosmosdbGremlinRestorableResource ` 
   -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" ` 
   -Location "West US" ` 
   -RestoreLocation "East US" ` 
   -RestoreTimestamp "2020-07-20T16:09:53+0000" 

API for Table의 복원 가능한 리소스 열거

열거형 cmdlet은 다양한 타임스탬프에서 복원이 가능한 리소스를 검색하는 데 도움이 됩니다. 또한 복원 가능한 계정 및 테이블 리소스에 대한 주요 이벤트 피드도 제공합니다.

라이브 데이터베이스 계정에 있는 데이터베이스 테이블의 모든 버전 나열

다음 명령을 사용하여 테이블의 모든 버전을 나열합니다. 이 명령은 라이브 계정에서만 작동합니다.

Get-AzCosmosdbTableRestorableTable ` 
   -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68"   ` 
   -Location "West US" 

지정된 타임스탬프에서 복원할 수 있는 테이블 찾기

다음 명령을 사용하여 지정된 타임스탬프에서 복원할 수 있는 테이블 목록을 가져옵니다. 이 명령은 라이브 계정에서만 작동합니다.

Get-AzCosmosdbTableRestorableResource ` 
   -DatabaseAccountInstanceId "d056a4f8-044a-436f-80c8-cd3edbc94c68" ` 
   -Location "West US" ` 
   -RestoreLocation "East US" ` 
   -RestoreTimestamp "2020-07-20T16:09:53+0000" 

Azure CLI를 사용하여 계정 복원

계정을 복원하기 전에 다음 단계에 따라 Azure CLI를 설치합니다.

  1. 최신 버전의 Azure CLI 설치

    • 최신 버전의 Azure CLI 또는 2.52.0 이상 버전을 설치합니다.
    • CLI를 이미 설치한 경우 az upgrade 명령을 실행하여 최신 버전으로 업데이트합니다. 이 명령은 2.52.0 이상 CLI 버전에서만 작동합니다. 이전 버전인 경우 위의 링크를 사용하여 최신 버전을 설치하세요.
  2. 로그인하고 구독 선택

    • az login 명령을 사용하여 Azure 계정에 로그인합니다.
    • az account set -s <subscriptionguid> 명령을 사용하여 필요한 구독을 선택합니다.

Azure CLI를 사용하여 복원 작업 트리거

복원을 트리거하는 가장 간단한 방법은 대상 계정의 이름, 원본 계정, 위치, 리소스 그룹, 타임스탬프(UTC) 및 필요에 따라 데이터베이스와 컨테이너 이름을 사용하여 복원 명령을 실행하는 것입니다. 다음은 복원 작업을 트리거하는 몇 가지 예입니다.

기존 계정에서 복원하여 새 Azure Cosmos DB 계정을 만듭니다.


az cosmosdb restore \
 --target-database-account-name <MyRestoredCosmosDBDatabaseAccount> \
 --account-name <MySourceAccount> \
 --restore-timestamp 2020-07-13T16:03:41+0000 \
 --resource-group <TargetResourceGroup> \
 --location "West US" \
 --public-network-access Disabled \
 --disable-ttl True 

--public-network-access가 설정되지 않은 경우 공용 네트워크에서 복원된 계정에 액세스할 수 있습니다. 복원된 계정에 대한 공용 네트워크 액세스를 방지하는 --public-network-access 옵션에 Disabled를 전달해야 합니다. disable-ttl을 $true로 설정하면 복원된 계정에서 TTL이 사용하지 않도록 설정되고, 이 매개 변수를 제공하지 않으면 이전에 설정된 TTL이 사용하도록 설정된 계정이 복원됩니다.

참고 항목

공용 네트워크 액세스를 사용하지 않도록 설정하여 복원하려는 경우 azure-cli의 안정적인 최소 버전은 2.52.0입니다.

기존 데이터베이스 계정에서 선택한 데이터베이스 및 컨테이너만 복원하여 새 Azure Cosmos DB 계정을 만듭니다.


az cosmosdb restore \
 --resource-group MyResourceGroup \
 --target-database-account-name MyRestoredCosmosDBDatabaseAccount \
 --account-name MySourceAccount \
 --restore-timestamp 2020-07-13T16:03:41+0000 \
 --location "West US" \
 --databases-to-restore name=MyDB1 collections=Collection1 Collection2 \
 --databases-to-restore name=MyDB2 collections=Collection3 Collection4

기존 API for Gremlin 계정에서 선택한 데이터베이스 및 그래프만 복원하여 새 Azure Cosmos DB API for Gremlin 계정을 만듭니다.


az cosmosdb restore \
 --resource-group MyResourceGroup \
 --target-database-account-name MyRestoredCosmosDBDatabaseAccount \
 --account-name MySourceAccount \
 --restore-timestamp 2022-04-13T16:03:41+0000 \
 --location "West US" \
 --gremlin-databases-to-restore name=MyDB1 graphs=graph1 graph2 \
 --gremlin-databases-to-restore name=MyDB2 graphs =graph3 graph4 

기존 API for Table 계정에서 선택한 테이블만 복원하여 새로운 Azure Cosmos DB API for Table 계정을 만듭니다.


az cosmosdb restore \
 --resource-group MyResourceGroup \
 --target-database-account-name MyRestoredCosmosDBDatabaseAccount \
 --account-name MySourceAccount \
 --restore-timestamp 2022-04-14T06:03:41+0000 \
 --location "West US" \
 --tables-to-restore table1 table2 

복원된 계정에서 복원 세부 정보 가져오기

다음 명령을 실행하여 복원 세부 정보를 가져옵니다. az cosmosdb show 명령 출력은 createMode 속성의 값을 보여줍니다. 값을 복원으로 설정하면 계정이 다른 계정에서 복원되었음을 나타냅니다. restoreParameters 속성에는 restoreSource(원본 계정 ID)와 같은 추가 정보가 있습니다. restoreSource 매개 변수의 마지막 GUID는 원본 계정의 instanceId입니다. 그리고 restoreTimestamprestoreParameters 개체 아래에 있습니다.

az cosmosdb show --name MyCosmosDBDatabaseAccount --resource-group MyResourceGroup

API for NoSQL의 복원 가능한 리소스 열거

아래에 설명된 열거 명령은 다양한 타임스탬프에서 복원에 사용할 수 있는 리소스를 검색하는 데 유용합니다. 또한 복원 가능한 계정, 데이터베이스 및 컨테이너 리소스에 대한 주요 이벤트의 피드를 제공합니다.

현재 구독에서 복원할 수 있는 모든 계정 나열

다음 Azure CLI 명령을 실행하여 현재 구독에서 복원할 수 있는 모든 계정을 나열합니다.

az cosmosdb restorable-database-account list --account-name "Pitracct"

응답에는 복원할 수 있는 모든 데이터베이스 계정(라이브 및 삭제된 계정 모두)과 복원할 수 있는 지역이 포함됩니다.

{
    "accountName": "Pitracct",
    "apiType": "Sql",
    "creationTime": "2021-01-08T23:34:11.095870+00:00",
    "deletionTime": null,
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234",
    "identity": null,
    "location": "West US",
    "name": "abcd1234-d1c0-4645-a699-abcd1234",
    "restorableLocations": [
      {
        "creationTime": "2021-01-08T23:34:11.095870+00:00",
        "deletionTime": null,
        "locationName": "West US",
        "regionalDatabaseAccountInstanceId": "f02df26b-c0ec-4829-8bef-3482d36e6230"
      }
    ],
    "tags": null,
    "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts"
  }

계정의 CreationTime 또는 DeletionTime와 마찬가지로 지역에도 CreationTime 또는 DeletionTime가 있습니다. 이러한 시간을 사용하여 올바른 지역 및 해당 지역으로 복원할 유효한 시간 범위를 선택할 수 있습니다.

라이브 데이터베이스 계정에서 모든 버전의 데이터베이스를 나열

모든 버전의 데이터베이스를 나열하면 데이터베이스의 실제 존재 시간을 알 수 없는 시나리오에서 올바른 데이터베이스를 선택할 수 있습니다.

다음 Azure CLI 명령을 실행하여 모든 버전의 데이터베이스를 나열합니다. 이 명령은 라이브 계정에서만 작동합니다. instance-idlocation 매개 변수는 az cosmosdb restorable-database-account list 명령 응답의 namelocation 속성에서 가져옵니다. instanceId 특성은 복원 중인 원본 데이터베이스 계정의 특성이기도 합니다.

az cosmosdb sql restorable-database list \
  --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \
  --location "West US"

이제 이 명령 출력에는 데이터베이스가 만들어지고 삭제된 시간이 표시됩니다.

[
  {
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234/restorableSqlDatabases/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
     "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
    "resource": {
      "database": {
        "id": "db1"
      },
      "eventTimestamp": "2021-01-08T23:27:25Z",
      "operationType": "Create",
      "ownerId": "db1",
      "ownerResourceId": "YuZAAA=="
    },
   
  },
  {
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/abcd1234-d1c0-4645-a699-abcd1234/restorableSqlDatabases/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
    "name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
    "resource": {
      "database": {
        "id": "spdb1"
      },
      "eventTimestamp": "2021-01-08T23:25:25Z",
      "operationType": "Create",
      "ownerId": "spdb1",
      "ownerResourceId": "OIQ1AA=="
    },
 
  }
]

라이브 데이터베이스 계정의 데이터베이스에서 모든 SQL 컨테이너 버전을 나열

다음 명령을 사용하여 모든 버전의 SQL 컨테이너를 나열합니다. 이 명령은 라이브 계정에서만 작동합니다. database-rid 매개 변수는 복원하려는 데이터베이스의 ResourceId입니다. az cosmosdb sql restorable-database list 명령의 응답에 포함된 ownerResourceid 특성의 값입니다.

az cosmosdb sql restorable-container list \
    --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \
    --database-rid "OIQ1AA==" \
    --location "West US"

이 명령 출력에는 이 데이터베이스 내의 모든 컨테이너에 대해 수행된 작업의 목록이 포함되어 있습니다.

[
  {
      "eventTimestamp": "2021-01-08T23:25:29Z",
      "operationType": "Replace",
      "ownerId": "procol3",
      "ownerResourceId": "OIQ1APZ7U18="
  },
  {
      "eventTimestamp": "2021-01-08T23:25:26Z",
      "operationType": "Create",
      "ownerId": "procol3",
      "ownerResourceId": "OIQ1APZ7U18="
  },
]

특정 타임스탬프에서 복원할 수 있는 데이터베이스 또는 컨테이너 찾기

다음 명령을 사용하여 특정 타임스탬프에서 복원할 수 있는 데이터베이스 또는 컨테이너의 목록을 가져옵니다. 이 명령은 라이브 계정에서만 작동합니다.


az cosmosdb sql restorable-resource list \
  --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \
  --location "West US" \
  --restore-location "West US" \  
  --restore-timestamp "2021-01-10T01:00:00+0000"

[
  {
    "collectionNames": [
      "procol1",
      "procol2"
    ],
    "databaseName": "db1"
  },
  {
    "collectionNames": [
      "procol3",
       "spcol1"
    ],
    "databaseName": "spdb1"
  }
]

API for MongoDB 계정의 복원 가능한 리소스 열거

아래에 설명된 열거 명령은 다양한 타임스탬프에서 복원에 사용할 수 있는 리소스를 검색하는 데 유용합니다. 또한 복원 가능한 계정, 데이터베이스 및 컨테이너 리소스에 대한 주요 이벤트의 피드를 제공합니다. 이러한 명령은 라이브 계정에서만 작동합니다.

라이브 데이터베이스 계정에서 모든 버전의 MongoDB 데이터베이스를 나열

az cosmosdb mongodb restorable-database list \
    --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \
    --location "West US"

라이브 데이터베이스 계정의 데이터베이스에서 모든 버전의 MongoDB 컬렉션을 나열

az cosmosdb mongodb restorable-collection list \
    --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \
    --database-rid "AoQ13r==" \
    --location "West US"

특정 타임스탬프 및 지역에서 복원에 사용할 수 있는 MongoDB 데이터베이스 계정의 모든 리소스를 나열

az cosmosdb mongodb restorable-resource list \
    --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \
    --location "West US" \
    --restore-location "West US" \
    --restore-timestamp "2020-07-20T16:09:53+0000"

라이브 데이터베이스 계정에서 모든 버전의 데이터베이스를 나열

아래에 설명된 열거 명령은 다양한 타임스탬프에서 복원에 사용할 수 있는 리소스를 검색하는 데 유용합니다. 또한 복원 가능한 계정, 데이터베이스 및 그래프 리소스에 대한 주요 이벤트 피드도 제공합니다. 이러한 명령은 라이브 계정에서만 작동합니다.

az cosmosdb gremlin restorable-database list \ 
   --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \ 
   --location "West US"

이제 이 명령 출력에는 데이터베이스가 만들어지고 삭제된 시간이 표시됩니다.

[ { 
    "id": "/subscriptions/abcd1234-b6ac-4328-a753-abcd1234/providers/Microsoft.DocumentDB/locations/eastus2euap/restorableDatabaseAccounts/abcd1234-4316-483b-8308-abcd1234/restorableGremlinDatabases/abcd1234-0e32-4036-ac9d-abcd1234", 
    "name": "abcd1234-0e32-4036-ac9d-abcd1234", 
    "resource": { 
      "eventTimestamp": "2022-02-09T17:10:18Z", 
      "operationType": "Create", 
      "ownerId": "db1", 
      "ownerResourceId": "1XUdAA==", 
      "rid": "ymn7kwAAAA==" 
    }, 
    "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableGremlinDatabases" 
    
  } 
] 

라이브 데이터베이스 계정에 있는 데이터베이스의 모든 Gremlin 그래프 버전 나열

az cosmosdb gremlin restorable-graph list \ 
   --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \ 
   --database-rid "OIQ1AA==" \ 
   --location "West US" 

이 명령 출력에는 이 데이터베이스 내의 모든 컨테이너에 대해 수행된 작업의 목록이 포함되어 있습니다.

[ { 

    "id": "/subscriptions/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b/providers/Microsoft.DocumentDB/locations/eastus2euap/restorableDatabaseAccounts/eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c/restorableGraphs/ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d", 
    "name": "ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d", 
    "resource": { 
      "eventTimestamp": "2022-02-09T17:10:31Z", 
      "operationType": "Create", 
      "ownerId": "graph1", 
      "ownerResourceId": "1XUdAPv9duQ=", 
      "rid": "IcWqcQAAAA==" 
    }, 
    "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableGraphs" 
  } 
] 

지정된 타임스탬프에서 복원할 수 있는 데이터베이스 또는 그래프 찾기

 
az cosmosdb gremlin restorable-resource list \ 
   --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \ 
   --location "West US" \ 
   --restore-location "West US" \ 
   --restore-timestamp "2021-01-10T01:00:00+0000" 

이 명령 출력은 복원 가능한 그래프를 보여 줍니다.

[
 { 
"databaseName": "db1", 
"graphNames": [ "graph1",   "graph3",   "graph2"  ] 
  } 
] 

API for Table 계정의 복원 가능한 리소스 열거

아래에 설명된 열거 명령은 다양한 타임스탬프에서 복원에 사용할 수 있는 리소스를 검색하는 데 유용합니다. 또한 복원 가능한 계정의 주요 이벤트 피드와 API for Table 리소스도 제공합니다. 이러한 명령은 라이브 계정에서만 작동합니다.

라이브 데이터베이스 계정에 있는 모든 테이블 버전 나열

az cosmosdb table restorable-table list \ 
   --instance-id "abcd1234-d1c0-4645-a699-abcd1234"  
   --location "West US" 
[   { 

"id": "/subscriptions/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/aaaa6a6a-bb7b-cc8c-dd9d-eeeeee0e0e0e/restorableTables/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
"name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
"resource": { 
  "eventTimestamp": "2022-02-09T17:09:54Z", 
  "operationType": "Create", 
  "ownerId": "table1", 
  "ownerResourceId": "tOdDAKYiBhQ=", 
  "rid": "9pvDGwAAAA==" 
  }, 
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableTables" 
   }, 

{"id": "/subscriptions/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b/providers/Microsoft.DocumentDB/locations/eastus2euap/restorableDatabaseAccounts/aaaa6a6a-bb7b-cc8c-dd9d-eeeeee0e0e0e/restorableTables/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a", 
"name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a", 
"resource": { 
  "eventTimestamp": "2022-02-09T20:47:53Z", 
  "operationType": "Create", 
  "ownerId": "table3", 
  "ownerResourceId": "tOdDALBwexw=", 
  "rid": "01DtkgAAAA==" 
}, 
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableTables" 

  }, 
] 

지정된 타임스탬프 및 지역에서 복원할 수 있는 API for Table 계정의 모든 리소스를 나열합니다.

az cosmosdb table restorable-resource list \ 
   --instance-id "abcd1234-d1c0-4645-a699-abcd1234" \ 
   --location "West US" \ 
   --restore-location "West US" \ 
   --restore-timestamp "2020-07-20T16:09:53+0000" 

다음은 명령의 결과입니다.

{   
  "tableNames": [ 
"table1", 
"table3", 
"table2" 

  ] 
} 

Azure Resource Manager 템플릿을 사용하여 복원

ARM(Azure Resource Manager) 템플릿을 사용하여 계정을 복원할 수도 있습니다. 템플릿을 정의할 때 다음 매개 변수를 포함합니다.

ARM 템플릿을 사용하여 API for NoSQL 또는 MongoDB 계정 복원

  1. createMode 매개 변수를 Restore로 설정합니다.
  2. restoreParameters를 정의합니다. restoreSource 값은 원본 계정에 대한 az cosmosdb restorable-database-account list 명령의 출력에서 추출됩니다. 계정 이름에 대한 인스턴스 ID 특성을 사용하여 복원을 수행합니다.
  3. restoreMode 매개 변수를 PointInTime으로 설정하고 restoreTimestampInUtc 값을 구성합니다.

다음 ARM 템플릿을 사용하여 Azure Cosmos DB API for NoSQL 또는 MongoDB에 대한 계정을 복원합니다. 다른 API의 예는 다음에 제공됩니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "name": "vinhpitrarmrestore-kal3",
      "type": "Microsoft.DocumentDB/databaseAccounts",
      "apiVersion": "2023-04-15",
      "location": "West US",
      "properties": {
        "locations": [
          {
            "locationName": "West US"
          }
        ],
        "databaseAccountOfferType": "Standard",
        "createMode": "Restore",
        "restoreParameters": {
            "restoreSource": "/subscriptions/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c",
            "restoreMode": "PointInTime",
            "restoreTimestampInUtc": "6/24/2020 4:01:48 AM",
            "restoreWithTtlDisabled": "true"
        }
      }
    }
  ]
}

ARM 템플릿을 사용하여 API for Gremlin 계정 복원

{
  "$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" 
        }, 
        "databaseAccountOfferType": "Standard",
        "createMode": "Restore",
        "restoreParameters": {
            "restoreSource": "/subscriptions/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d",
            "restoreMode": "PointInTime",
            "restoreTimestampInUtc": "2021-10-27T23:20:46Z",
            "gremlinDatabasesToRestore": [{ 
                "databaseName": "db1", 
                "graphNames": [ 
                    "graph1", "graph2" 
                ] 
            }]
        }
      }
    }
  ]
}

ARM 템플릿을 사용하여 API for Table 계정 복원

{
  "$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" 
        }, 
        "databaseAccountOfferType": "Standard",
        "createMode": "Restore",
        "restoreParameters": {
            "restoreSource": "/subscriptions/aaaa6a6a-bb7b-cc8c-dd9d-eeeeee0e0e0e/providers/Microsoft.DocumentDB/locations/West US/restorableDatabaseAccounts/4bcb9d82e-ec71-430b-b977-cd6641db85ad",
            "restoreMode": "PointInTime",
            "restoreTimestampInUtc": "2022-04-13T10:20:46Z",
             "tablesToRestore": [ 
                "table1", "table2" 
            ] 
        }
      }
    }
  ]
}

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

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

다음 단계