Azure CLI는 명령줄 또는 스크립트를 통해 Azure 리소스를 만들고 관리하는 데 사용됩니다. 이 문서에서는 Azure CLI를 사용하여 Azure VM에서 백업된 SQL 데이터베이스를 복원하는 방법을 설명합니다. Azure Portal에서 이 작업을 수행해도 됩니다.
Azure Cloud Shell을 사용하여 CLI 명령을 실행합니다.
이 글은 Azure VM에서 SQL 데이터베이스가 실행 중이고 Azure Backup으로 백업되어 있다고 가정합니다. CLI를 사용하여 Azure에서 SQL 데이터베이스 백업을 사용하여 SQL 데이터베이스를 백업한 경우에는 다음 리소스가 사용됩니다.
-
SQLResourceGroup이라는 리소스 그룹 -
SQLVault라는 자격 증명 모음 -
VMAppContainer;Compute;SQLResourceGroup;testSQLVM이라는 보호된 컨테이너 -
sqldatabase;mssqlserver;testdb라는 이름의 백업된 데이터베이스/항목. -
westus지역의 리소스
현재 지원되는 백업 및 복원 시나리오를 보려면 지원 매트릭스를 참조하세요. 일반적인 질문은 자주 묻는 질문을 참조하세요.
백업된 데이터베이스의 복원 지점 보기
데이터베이스의 모든 복구 지점 목록을 보려면 다음과 같이 az backup recoverypoint list 명령을 사용합니다.
az backup recoverypoint list --resource-group SQLResourceGroup \
--vault-name SQLVault \
--container-name "VMAppContainer;Compute;SQLResourceGroup;testSQLVM" \
--item-name "sqldatabase;mssqlserver;testdb" \
--output table
복구 지점 목록은 다음과 같이 표시됩니다.
Name Time BackupManagementType Item Name RecoveryPointType
------------------- --------------------------------- --------------------- ---------------------- ------------------
7660777527047692711 2019-12-10T04:00:32.346000+00:00 AzureWorkload sqldatabase;mssqlserver;testdb Full
7896624824685666836 2019-12-15T10:33:32.346000+00:00 AzureWorkload sqldatabase;mssqlserver;testdb Differential
DefaultRangeRecoveryPoint AzureWorkload sqldatabase;mssqlserver;testdb Log
위 목록에는 각각 전체, 차등 및 로그 백업의 세 가지 복구 지점이 포함됩니다.
Note
az backup recoverypoint show-log-chain 명령을 사용하여 끊어지지 않은 모든 로그 백업 체인의 시작점과 끝점을 볼 수도 있습니다.
데이터베이스 복원에 필요한 필수 구성 요소
데이터베이스 복원을 시작하기 전에 다음과 같은 전제 조건을 충족하는지 확인하세요.
- 볼트에서 지역 간 복원 기능이 활성화되면 동일한 지역의 SQL 인스턴스 또는 다른 지역으로 데이터베이스를 복원할 수 있습니다.
- 대상 인스턴스는 지역 간 복원 및 구독 간 복원이 아닐 경우 원본과 동일한 자격 증명 모음에 등록되어야 합니다. .
데이터베이스 복원
Azure Backup은 다음과 같이 Azure VM에서 실행되는 SQL 데이터베이스를 복원할 수 있습니다.
- 로그 백업을 사용하여 특정 날짜 또는 시간(초)으로 복원합니다. Azure Backup은 선택한 시간을 기준으로 복원해야 하는 적절한 전체 차등 백업 및 로그 백업 체인을 자동으로 결정합니다.
- 특정 복구 지점으로 복원하려면 특정 전체 또는 차등 백업을 복원합니다.
데이터베이스를 복원하려면 az restore restore-azurewl 명령을 사용합니다. 그러려면 입력 중 하나로 복구 구성 개체가 필요합니다. az backup recoveryconfig show 명령을 사용하여 이 개체를 생성할 수 있습니다. 복구 구성 개체는 복원을 수행하기 위한 모든 세부 정보를 포함합니다. 그 중 하나는 복원 모드인 OriginalWorkloadRestore 또는 AlternateWorkloadRestore입니다.
Note
OriginalWorkloadRestore: 원래 원본과 동일한 SQL 인스턴스에 데이터를 복원합니다. 이 옵션은 원래 데이터베이스를 덮어씁니다. AlternateWorkloadRestore: 대체 위치에 데이터베이스를 복원하고 원래 원본 데이터베이스를 유지합니다.
대체 위치에 복원
데이터베이스를 대체 위치에 복원하려면 복원 모드로 AlternateWorkloadRestore를 사용합니다. 그런 다음, 복원 지점을 선택해야 합니다. 복원 지점은 이전 지정 시간일 수도 있고 이전 복원 지점일 수도 있습니다.
이전 복원 지점으로 복원해 보겠습니다. 데이터베이스의 복원 지점 목록을 확인하고 복원하려는 지점을 선택합니다. 여기에서는 이름이 7660777527047692711인 복원 지점을 사용합니다.
위의 복원 지점 이름과 복원 모드를 사용하고 az backup recoveryconfig show 명령을 사용하여 복구 구성 개체를 만듭니다. 이 명령의 남은 매개 변수를 확인합니다.
- --target-item-name: 복원된 데이터베이스에 사용할 이름입니다. 여기에서는 restored_database라는 이름이 사용되었습니다.
- --target-server-name: Recovery Services 자격 증명 모음에 성공적으로 등록되었고 복원할 데이터베이스와 동일한 지역에 있는 SQL Server의 이름입니다. 여기에서는 보호 대상인 testSQLVM이라는 동일한 SQL Server에 데이터베이스를 복원합니다.
- --target-server-type: SQL 데이터베이스 복원의 경우 SQLInstance를 사용해야 합니다.
az backup recoveryconfig show --resource-group SQLResourceGroup \
--vault-name SQLVault \
--container-name "VMAppContainer;Compute;SQLResourceGroup;testSQLVM" \
--item-name "SQLDataBase;mssqlserver;testdb" \
--restore-mode AlternateWorkloadRestore \
--rp-name 7660777527047692711 \
--target-item-name restored_database \
--target-server-name testSQLVM \
--target-server-type SQLInstance \
--workload-type SQLDataBase \
--output json
위의 쿼리에 대한 응답은 다음과 같이 표시되는 복구 구성 개체입니다.
{
"container_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.RecoveryServices/vaults/SQLVault/backupFabrics/Azure/protectionContainers/vmappcontainer;compute;SQLResourceGroup;testSQLVM",
"container_uri": "VMAppContainer;compute;SQLResourceGroup;testSQLVM",
"database_name": "MSSQLSERVER/restored_database",
"filepath": null,
"item_type": "SQL",
"item_uri": "SQLDataBase;mssqlserver;testdb",
"log_point_in_time": null,
"recovery_mode": null,
"recovery_point_id": "7660777527047692711",
"restore_mode": "AlternateLocation",
"source_resource_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.Compute/virtualMachines/testSQLVM",
"workload_type": "SQLDataBase",
"alternate_directory_paths": []
}
이제 데이터베이스 복원을 위해 az restore restore-azurewl 명령을 실행합니다. 이 명령을 사용하기 위해 recoveryconfig.json이라는 파일에 저장된 위의 JSON 출력을 입력합니다.
az backup restore restore-azurewl --resource-group SQLResourceGroup \
--vault-name SQLVault \
--recovery-config recoveryconfig.json \
--output table
출력은 다음과 같이 나타납니다.
Name Operation Status Item Name Backup Management Type Start Time UTC Duration
------------------------------------ ----------- ---------- --------------------------------- ------------------------ -------------------------------- --------------
be7ea4a4-0752-4763-8570-a306b0a0106f Restore InProgress testdb [testSQLVM] AzureWorkload 2022-06-21T03:51:06.898981+00:00 0:00:05.652967
응답에 작업 이름이 제공됩니다. 이 작업 이름을 사용하여 az backup job show 명령을 사용해서 작업 상태를 추적할 수 있습니다.
복원 및 덮어쓰기
원래 위치로 복원하려면 OriginalWorkloadRestore를 복원 모드로 사용합니다. 그런 다음, 이전 지정 시간 또는 이전 복원 지점일 수 있는 복원 지점을 선택해야 합니다.
예를 들어 복원을 위해 이전 복원 지정 시간 "28-11-2019-09:53:00"을 선택해보세요. 이 복원 지점을 dd-mm-yyyy, dd-mm-yyyy-hh:mm:ss 형식으로 입력할 수 있습니다. 복원할 올바른 지정 시간을 선택하려면 끊어지지 않은 로그 체인 백업의 간격을 나열하는 az backup recoverypoint show-log-chain 명령을 사용합니다.
az backup recoveryconfig show --resource-group SQLResourceGroup \
--vault-name SQLVault \
--container-name "VMAppContainer;Compute;SQLResourceGroup;testSQLVM" \
--item-name "sqldatabase;mssqlserver;testdb" \
--restore-mode OriginalWorkloadRestore \
--log-point-in-time 20-06-2022-09:02:41 \
--output json
위의 쿼리에 대한 응답은 다음과 같이 표시되는 복구 구성 개체입니다.
{
"alternate_directory_paths": null,
"container_id": null,
"container_uri": "VMAppContainer;Compute;SQLResourceGroup;testSQLVM",
"database_name": null,
"filepath": null,
"item_type": "SQL",
"item_uri": "SQLDataBase;mssqlserver;testdb",
"log_point_in_time": "20-06-2022-09:02:41",
"recovery_mode": null,
"recovery_point_id": "DefaultRangeRecoveryPoint",
"restore_mode": "OriginalLocation",
"source_resource_id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/SQLResourceGroup/providers/Microsoft.Compute/virtualMachines/testSQLVM",
"workload_type": "SQLDataBase"
}
이제 데이터베이스 복원을 위해 az restore restore-azurewl 명령을 실행합니다. 이 명령을 사용하기 위해 recoveryconfig.json이라는 파일에 저장된 위의 JSON 출력을 입력합니다.
az backup restore restore-azurewl --resource-group sqlResourceGroup \
--vault-name sqlVault \
--recovery-config recoveryconfig.json \
--output table
출력은 다음과 같이 나타납니다.
Name Operation Status Item Name Backup Management Type Start Time UTC Duration
------------------------------------ ----------- ---------- ------------------------------- ------------------------ -------------------------------- --------------
1730ec49-166a-4bfd-99d5-93027c2d8480 Restore InProgress testdb [testSQLVM] AzureWorkload 2022-06-21T04:04:11.161411+00:00 0:00:03.118076
응답에 작업 이름이 제공됩니다. 이 작업 이름을 사용하여 az backup job show 명령으로 작업 상태를 추적할 수 있습니다.
보조 지역에 복원
데이터베이스를 보조 지역으로 복원하려면 복원 구성에서 보조 지역에 있는 대상 자격 증명 모음 및 서버를 지정합니다.
az backup recoveryconfig show --resource-group SQLResourceGroup \
--vault-name SQLVault \
--container-name "VMAppContainer;compute;SQLResourceGroup;testSQLVM" \
--item-name "sqldatabase;mssqlserver;testdb" \
--restore-mode AlternateWorkloadRestore \
--from-full-rp-name 293170069256531 \
--rp-name 293170069256531 \
--target-server-name targetSQLServer \
--target-container-name "VMAppContainer;compute;SQLResourceGroup;targetSQLServer" \
--target-item-name testdb_restore_1 \
--target-server-type SQLInstance \
--workload-type SQLDataBase \
--target-resource-group SQLResourceGroup \
--target-vault-name targetVault \
--backup-management-type AzureWorkload
응답은 다음과 같이 표시되는 복구 구성 개체입니다.
{
"container_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.RecoveryServices/vaults/targetVault/backupFabrics/Azure/protectionContainers/vmappcontainer;compute;SQLResourceGroup;targetSQLServer",
"container_uri": "VMAppContainer;compute;SQLResourceGroup;testSQLVM",
"database_name": "MSSQLSERVER/testdb_restore_1",
"filepath": null,
"item_type": "SQL",
"item_uri": "SQLDataBase;mssqlserver;testdb",
"log_point_in_time": null,
"recovery_mode": null,
"recovery_point_id": "293170069256531",
"restore_mode": "AlternateLocation",
"source_resource_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.Compute/virtualMachines/testSQLVM",
"workload_type": "SQLDataBase",
"alternate_directory_paths": []
}
az restore restore-azurewl 명령에서 이 복구 구성을 사용합니다.
--use-secondary-region 플래그를 선택하여 데이터베이스를 보조 지역으로 복원합니다.
az backup restore restore-azurewl --resource-group SQLResourceGroup \
--vault-name SQLVault \
--recovery-config recoveryconfig.json \
--use-secondary-region \
--output table
출력은 다음과 같이 나타납니다.
Name Operation Status Item Name Backup Management Type Start Time UTC Duration
------------------------------------ ------------------ ---------- ------------------------- ------------------------ -------------------------------- --------------
0d863259-b0fb-4935-8736-802c6667200b CrossRegionRestore InProgress testdb [testSQLVM] AzureWorkload 2022-06-21T08:29:24.919138+00:00 0:00:12.372421
Note
보조 지역에서 사용할 수 있는 백업 데이터의 RPO는 12시간입니다. 따라서 CRR을 켜면 보조 지역의 RPO는 12시간 + 로그 빈도 기간(최소 15분으로 설정할 수 있음)입니다.
파일로 복원
데이터베이스 대신 파일로 백업 데이터를 복원하려면RestoreAsFiles를 복원 모드로 사용합니다. 그런 다음, 복원 지점을 선택합니다. 복원 지점은 이전 지정 시간일 수도 있고 이전 복원 지점일 수도 있습니다. 파일이 지정된 경로에 덤프되면 이러한 파일을 데이터베이스로 복원하려는 SQL 컴퓨터로 가져올 수 있습니다. 이러한 파일을 임의의 컴퓨터로 이동할 수 있으므로 이제 구독 및 지역 간에 데이터를 복원할 수 있습니다.
복원할 이전 지정 시간 28-11-2019-09:53:00을 선택하고 동일한 SQL Server에서 백업 파일을 C:\restoreasfiles로 덤프할 위치를 선택합니다. 이 복원 지점을 dd-mm-yyyy 또는 dd-mm-yyyy-hh:mm:ss 형식 중 하나로 제공할 수 있습니다. 복원할 올바른 지정 시간을 선택하려면 끊어지지 않은 로그 체인 백업의 간격을 나열하는 az backup recoverypoint show-log-chain 명령을 사용합니다.
위의 복원 지점 이름과 복원 모드를 사용하고 az backup recoveryconfig show 명령을 사용하여 복구 구성 개체를 만듭니다. 이 명령에서 각 나머지 매개 변수를 확인합니다.
- --target-container-name: Recovery Services 자격 증명 모음에 성공적으로 등록되었고 복원할 데이터베이스와 동일한 지역에 제공된 SQL Server의 이름입니다. 보호 대상인 mssqlserver라는 동일한 SQL Server에 데이터베이스를 파일로 복원합니다.
- --rp-name: 지정 시간 복원의 경우 복원 지점 이름이 DefaultRangeRecoveryPoint입니다.
az backup recoveryconfig show --resource-group SQLResourceGroup \
--vault-name SQLVault \
--container-name "VMAppContainer;Compute;SQLResourceGroup;testSQLVM" \
--item-name "sqldatabase;mssqlserver;testdb" \
--restore-mode RestoreAsFiles \
--rp-name 932606668166874635 \
--target-container-name "VMAppContainer;Compute;SQLResourceGroup;testSQLVM" \
--filepath "C:\restoreasfiles" \
--output json
위의 쿼리에 대한 응답은 다음과 같이 표시되는 복구 구성 개체입니다.
{
"alternate_directory_paths": null,
"container_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.RecoveryServices/vaults/SQLVault/backupFabrics/Azure/protectionContainers/VMAppContainer;Compute;SQLResourceGroup;testSQLVM",
"container_uri": "VMAppContainer;compute;SQLResourceGroup;testSQLVM",
"database_name": null,
"filepath": "C:\restoreasfiles",
"item_type": "SQL",
"item_uri": "SQLDataBase;mssqlserver;testdb",
"log_point_in_time": null,
"recovery_mode": "FileRecovery",
"recovery_point_id": "932606668166874635",
"restore_mode": "AlternateLocation",
"source_resource_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.Compute/virtualMachines/testSQLVM",
"workload_type": "SQLDataBase"
}
이제 데이터베이스를 파일로 복원하기 위해 az restore restore-azurewl 명령을 실행합니다. 이 명령을 사용하기 위해 recoveryconfig.json이라는 파일에 저장된 위의 JSON 출력을 입력합니다.
az backup restore restore-azurewl --resource-group SQLResourceGroup \
--vault-name SQLVault \
--recovery-config recoveryconfig.json \
--output json
출력은 다음과 같이 나타납니다.
{
"eTag": null,
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SQLResourceGroup/providers/Microsoft.RecoveryServices/vaults/SQLVault/backupJobs/e9cd9e73-e3a3-425a-86a9-8dd1c500ff56",
"location": null,
"name": "e9cd9e73-e3a3-425a-86a9-8dd1c500ff56",
"properties": {
"actionsInfo": [
"1"
],
"activityId": "9e7c8ee4-f1ef-11ec-8a2c-3c52826c1a9a",
"backupManagementType": "AzureWorkload",
"duration": "0:00:04.304322",
"endTime": null,
"entityFriendlyName": "testdb [testSQLVM]",
"errorDetails": null,
"extendedInfo": {
"dynamicErrorMessage": null,
"propertyBag": {
"Job Type": "Restore as files"
},
"tasksList": [
{
"status": "InProgress",
"taskId": "Transfer data from vault"
}
]
},
"isUserTriggered": true,
"jobType": "AzureWorkloadJob",
"operation": "Restore",
"startTime": "2022-06-22T05:53:32.951666+00:00",
"status": "InProgress",
"workloadType": "SQLDataBase"
},
"resourceGroup": "SQLResourceGroup",
"tags": null,
"type": "Microsoft.RecoveryServices/vaults/backupJobs"
}
응답에 작업 이름이 제공됩니다. 이 작업 이름을 사용하여 az backup job show 명령으로 작업 상태를 추적할 수 있습니다.
Note
전체 체인이 아닌 파일의 하위 집합만 복원하려면 여기에 설명된 대로 단계를 수행합니다.
구독 간 복원
CSR(구독 간 복원)을 사용하면 복원 권한을 사용할 수 있는 경우 테넌트에서 모든 구독 및 자격 증명 모음으로 유연하게 복원할 수 있습니다. 기본적으로 CSR은 모든 Recovery Services 자격 증명 모음(기존 및 새로 만든 자격 증명 모음)에서 사용하도록 설정됩니다.
Note
- Recovery Services 자격 증명 모음에서 구독 간 복원을 트리거할 수 있습니다.
- CSR은 스트리밍 기반 백업에 대해서만 지원되며 스냅샷 기반 백업에는 지원되지 않습니다.
- CSR과 함께 사용하는 CRR(지역 간 복원)은 지원되지 않습니다.
az backup vault create
자격 증명 모음을 만들고 업데이트하는 동안 자격 증명 모음의 CSR 상태를 설정할 수 있는 cross-subscription-restore-state 매개 변수를 추가합니다.
az backup recoveryconfig show
SQL 또는 HANA 데이터 원본에 대한 구독 간 복원을 트리거하는 동안 대상 구독을 입력으로 제공할 수 있는 --target-subscription-id 매개 변수를 추가합니다.
Example:
az backup vault create -g {rg_name} -n {vault_name} -l {location} --cross-subscription-restore-state Enable
az backup recoveryconfig show --restore-mode alternateworkloadrestore --backup-management-type azureworkload -r {rp} --target-container-name {target_container} --target-item-name {target_item} --target-resource-group {target_rg} --target-server-name {target_server} --target-server-type SQLInstance --target-subscription-id {target_subscription} --target-vault-name {target_vault} --workload-type SQLDataBase --ids {source_item_id}
SQL 인스턴스 스냅샷 복원
다음 예시들은 Bash가 아닌 PowerShell 셸 문법을 사용합니다. 이 글에서 제시된 스냅샷 옵션을 노출하는 Azure CLI 버전을 사용하세요. 스냅샷 복원 전제 조건과 지원 매트릭스를 검토하세요.
사용 전에 플레이스홀더를 교체하세요. 일반적인 설정을 완료하고 필요한 복원 시나리오만 선택하세요. 다음 예시들은 대안일 뿐이며, 전체를 그대로 실행할 스크립트가 아닙니다. 복원 명령은 데이터를 덮어쓰거나 디스크 연결 상태를 변경할 수 있습니다.
스냅샷 복원 변수를 설정하세요
$vaultSubscription에 대해 볼트의 구독을 이용하세요. 필요한 권한으로 타겟 리소스 그룹과 사용자 할당 관리 ID를 준비하세요.
$vaultSubscription = "<vault-subscription-id>"
$vaultRg = "<vault-rg>"
$vaultName = "<vault-name>"
$sourceVm = "<source-vm-name>"
$targetVm = "<target-vm-name>"
$targetInstanceName = "<target-instance-name>"
$restoreRg = "<restore-resource-group>"
$uamiId = "/subscriptions/<subscription-id>/resourceGroups/<identity-rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"
$vaultArgs = @("--subscription", $vaultSubscription, "--resource-group", $vaultRg, "--vault-name", $vaultName)
az backup vault show --subscription $vaultSubscription --resource-group $vaultRg --name $vaultName
az backup container list @vaultArgs --backup-management-type AzureWorkload `
--query "[].{Name:name,VM:properties.friendlyName}" --output table
$containerName = "<native-source-container-name>"
$targetContainerName = "<native-target-container-name>"
$sourceArgs = $vaultArgs + @("--container-name", $containerName, "--backup-management-type", "AzureWorkload")
az backup item list @sourceArgs --workload-type SQLInstance --output json
$instanceItemName = "<native-protected-instance-item-name>"
$instanceArgs = $sourceArgs + @("--item-name", $instanceItemName, "--workload-type", "SQLInstance")
서비스 출력에서 정확한 네이티브 컨테이너 및 보호 항목 이름을 복사하세요. 위의 출발지와 목적지 설정은 동일한 저장소를 사용합니다. 대체 위치 복원의 경우, 대상 인스턴스가 발견 가능한지 확인하세요:
az backup protectable-item show @vaultArgs --workload-type MSSQL `
--protectable-item-type SQLInstance --name $targetInstanceName --server-name $targetVm
이 예시들에서 긴 옵션은 다음과 같은 짧은 별칭도 지원합니다:
| 긴 옵션 | Alias |
|---|---|
--restore-point-query-type |
--rp-query-type |
--get-latest-recovery-point-only |
--latest-rp-only |
--base-snapshot-recovery-point-id |
--base-snapshot-rp-id |
--base-recovery-point-datasource-id |
--base-datasource-id |
쿼리 스냅샷 복구 지점
시간 창에 대한, 스냅샷만의 또는 최신 스냅샷만의 요청된 모든 복구 지점 유형을 나열하세요.
$startDate = (Get-Date).ToUniversalTime().AddDays(-7).ToString("dd-MM-yyyy-HH:mm:ss")
$endDate = (Get-Date).ToUniversalTime().ToString("dd-MM-yyyy-HH:mm:ss")
az backup recoverypoint list @instanceArgs --start-date $startDate --end-date $endDate `
--restore-point-query-type FullDifferentialAndSnapshot --output json
az backup recoverypoint list @instanceArgs --restore-point-query-type Snapshot --output json
az backup recoverypoint list @instanceArgs --restore-point-query-type Snapshot `
--get-latest-recovery-point-only true --output json
복구 지점을 명확히 선택하세요; 목록 순서를 가정하지 마세요. 포함된 데이터베이스와 파일 시스템 정보를 검사하기 위해 전체 세부 정보를 확인하세요:
$snapshotRpName = "<selected-snapshot-recovery-point-name>"
$snapshotJson = az backup recoverypoint show @instanceArgs --name $snapshotRpName --output json
if ($LASTEXITCODE -ne 0) { throw "Could not read the selected snapshot recovery point." }
$snapshotRp = $snapshotJson | ConvertFrom-Json
$snapshotRp.properties.extendedInfo.includedDatabases | Select-Object datasourceName, datasourceId
$snapshotRp.properties.extendedInfo.snapshotRecoveryPointInfo.snapshotResourceGroup
$snapshotRp.properties.extendedInfo.snapshotRecoveryPointInfo.sourceFilesystemInfo |
Select-Object label, fileSystemType, accessPaths, isOnStorageSpace, storageSpaceInfo, diskInfoList
쿼리 스냅샷 기반 로그 범위
인스턴스의 protectedItemDataSourceId를 검색합니다. 이 ID는 개별 데이터베이스의 데이터 소스 ID가 아니라 로그 쿼리의 기본 데이터 소스입니다.
$instanceJson = az backup item show @sourceArgs --name $instanceItemName `
--workload-type SQLInstance --output json
if ($LASTEXITCODE -ne 0) { throw "Could not read the protected instance." }
$instanceItem = $instanceJson | ConvertFrom-Json
$instanceDatasourceId = $instanceItem.properties.protectedItemDataSourceId
az backup item list @sourceArgs --workload-type MSSQL --output json
$dbItemName = "<selected-native-database-item-name>"
$databaseArgs = $sourceArgs + @("--item-name", $dbItemName, "--workload-type", "MSSQL")
az backup recoverypoint show-log-chain @databaseArgs `
--recovery-mode SnapshotAttachAndRecover `
--base-snapshot-recovery-point-id $snapshotRpName `
--base-recovery-point-datasource-id $instanceDatasourceId --output json
스냅샷에 포함된 데이터베이스 중 하나에 해당하는 데이터베이스 항목을 선택하세요. 개별 회복 지점을 로그 범위로 취급하지 말고, 연속적인 회복 시간 범위에 show-log-chain를 사용하세요.
인스턴스 원본 위치 복원
원본 위치 복원(OLR) 구성을 생성하세요.
$configFile = ".\instance-olr.json"
az backup recoveryconfig show @instanceArgs --rp-name $snapshotRpName `
--restore-mode OriginalWorkloadRestore --recovery-mode SnapshotAttachAndRecover `
--snapshot-rg $restoreRg --identity-arm-id $uamiId --output json |
Set-Content -Encoding utf8 $configFile
제출 전에 볼륨 매핑을 확인하세요. 원본 위치 복원은 원래 데이터베이스를 덮어쓸 수 있습니다.
인스턴스 다른 위치 복원
목적지 컨테이너, 서버, SQL 인스턴스를 사용하세요.
--target-item-name를 필요한 대상 데이터베이스 이름 또는 서비스에서 지원하는 인스턴스 명명 패턴으로 설정하세요:
$configFile = ".\instance-alr.json"
az backup recoveryconfig show @instanceArgs --rp-name $snapshotRpName `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttachAndRecover `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--target-item-name "<target-database-name-or-service-supported-instance-pattern>" `
--snapshot-rg $restoreRg --identity-arm-id $uamiId --output json |
Set-Content -Encoding utf8 $configFile
인스턴스 특정 시점 복원
이전 쿼리에서 선택한 인스턴스 스냅샷과 해당 인스턴스 스냅샷의 기본 데이터소스 ID를 사용하세요. 포함된 모든 데이터베이스를 고유한 보호 항목에 매핑한 후, 그 스냅샷 위의 로그 범위를 조회합니다.
$includedDatabases = @($snapshotRp.properties.extendedInfo.includedDatabases)
if ($includedDatabases.Count -eq 0) { throw "The snapshot has no included databases." }
$itemsJson = az backup item list @sourceArgs --workload-type MSSQL --output json
if ($LASTEXITCODE -ne 0) { throw "Could not list protected databases." }
$databaseItems = @($itemsJson | ConvertFrom-Json)
$logRangesPerDb = @{}
foreach ($database in $includedDatabases) {
$matchingItems = @($databaseItems | Where-Object {
$_.properties.protectedItemDataSourceId -eq $database.datasourceId
})
if ($matchingItems.Count -eq 0) {
$matchingItems = @($databaseItems | Where-Object {
$_.name -eq "SQLDataBase;$($database.datasourceName)" -or
$_.properties.friendlyName -eq $database.datasourceName
})
}
if ($matchingItems.Count -ne 1) {
throw "Could not uniquely resolve included database $($database.datasourceName)."
}
$rangesJson = az backup recoverypoint show-log-chain @sourceArgs `
--item-name $matchingItems[0].name --workload-type MSSQL `
--recovery-mode SnapshotAttachAndRecover `
--base-snapshot-recovery-point-id $snapshotRpName `
--base-recovery-point-datasource-id $instanceDatasourceId `
--query "[].properties.timeRanges[]" --output json
if ($LASTEXITCODE -ne 0) { throw "Could not query snapshot-based log ranges." }
$logRangesPerDb[$database.datasourceName] = @(
foreach ($range in ($rangesJson | ConvertFrom-Json)) {
if (-not $range.startTime -or -not $range.endTime) {
throw "The service returned a log range without startTime or endTime."
}
[PSCustomObject]@{
ItemName = $matchingItems[0].name
StartTime = ([DateTimeOffset]$range.startTime).UtcDateTime
EndTime = ([DateTimeOffset]$range.endTime).UtcDateTime
}
}
)
if ($logRangesPerDb[$database.datasourceName].Count -eq 0) {
throw "No snapshot-based log ranges for $($database.datasourceName)."
}
}
데이터베이스의 범위를 확인하고 UTC 시간을 선택하세요. 다음 예시는 해당 데이터베이스의 최신 종료 시간을 선택한 후, 포함된 모든 데이터베이스에 대해 해당 시간도 사용 가능한지 확인합니다. 검증이 실패하면, 공통 사용 가능한 시간 범위 내에서 시간을 선택하고 검사를 다시 실행하세요:
$selectedDatabase = "<instance-name>;<database-name>"
if (-not $logRangesPerDb.ContainsKey($selectedDatabase)) {
throw "Select a database from logRangesPerDb.Keys."
}
$selectedRanges = @($logRangesPerDb[$selectedDatabase] | Sort-Object EndTime)
$selectedRanges | Format-Table ItemName, StartTime, EndTime
$rangeIndex = -1
$pointInTime = $selectedRanges[$rangeIndex].EndTime
foreach ($databaseName in $logRangesPerDb.Keys) {
$matchingRanges = @($logRangesPerDb[$databaseName] | Where-Object {
$_.StartTime -le $pointInTime -and $_.EndTime -ge $pointInTime
})
if ($matchingRanges.Count -eq 0) {
throw "The chosen restore time is unavailable for $databaseName."
}
}
$pit = $pointInTime.ToString("dd-MM-yyyy-HH:mm:ss")
기본 스냅샷과 검증된 로그 재생 시간을 사용하여 PITR 구성을 생성합니다:
$configFile = ".\instance-pit.json"
az backup recoveryconfig show @instanceArgs --rp-name $snapshotRpName --log-point-in-time $pit `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttachAndRecover `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--target-item-name "<target-database-name-or-service-supported-instance-pattern>" `
--snapshot-rg $restoreRg --identity-arm-id $uamiId --no-recovery-mode `
--output json | Set-Content -Encoding utf8 $configFile
--no-recovery-mode은 이후 복구 단계를 위해 데이터베이스를 복구되지 않은 상태로 유지하도록 요청합니다. 그 행동이 회복 계획에 적합한지 검토하세요.
디스크로 인스턴스 복원
스냅샷 첨부 후 데이터베이스 복구 대신 디스크로 복원(RAD)에 SnapshotAttach를 사용:
$configFile = ".\instance-rad.json"
az backup recoveryconfig show @instanceArgs --rp-name $snapshotRpName `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttach `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--snapshot-rg $restoreRg --identity-arm-id $uamiId --output json |
Set-Content -Encoding utf8 $configFile
인스턴스에서 보호된 데이터베이스를 복원합니다
소스 컨테이너에서 정확한 네이티브 데이터베이스 항목 이름을 선택하세요. 복구 지점 복원을 위해서는 데이터베이스 스냅샷을 명시적으로 선택하세요:
az backup item list @sourceArgs --workload-type MSSQL --output json
$dbItemName = "<native-protected-database-item-name>"
$databaseArgs = $sourceArgs + @("--item-name", $dbItemName, "--workload-type", "MSSQL")
az backup recoverypoint list @databaseArgs --restore-point-query-type Snapshot --output json
$dbSnapshotRpName = "<chosen-database-snapshot-recovery-point-name>"
az backup recoverypoint show @databaseArgs --name $dbSnapshotRpName --output json
데이터베이스 대체 위치 복원
$configFile = ".\database-alr.json"
az backup recoveryconfig show @databaseArgs --rp-name $dbSnapshotRpName `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttachAndRecover `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--target-item-name "<restored-db-name>" --snapshot-rg $restoreRg `
--identity-arm-id $uamiId --no-recovery-mode --output json |
Set-Content -Encoding utf8 $configFile
데이터베이스 특정 시점 복원
사용 가능한 로그 범위를 조회하고 반환된 범위 내에서 UTC 시간을 선택하세요.
dd-MM-yyyy-HH:mm:ss 형식을 사용합니다.
az backup recoverypoint show-log-chain @databaseArgs --output json
$pit = "<dd-MM-yyyy-HH:mm:ss-in-UTC-within-a-returned-range>"
$configFile = ".\database-pit.json"
az backup recoveryconfig show @databaseArgs --log-point-in-time $pit `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttachAndRecover `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--target-item-name "<restored-db-name>" --snapshot-rg $restoreRg `
--identity-arm-id $uamiId --no-recovery-mode --output json |
Set-Content -Encoding utf8 $configFile
앞서 언급한 데이터베이스 복원 예시들도 --no-recovery-mode를 사용합니다. 제출 전에 설정을 검토하세요.
디스크로 데이터베이스 복원
$configFile = ".\database-rad.json"
az backup recoveryconfig show @databaseArgs --rp-name $dbSnapshotRpName `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttach `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--snapshot-rg $restoreRg --identity-arm-id $uamiId --output json |
Set-Content -Encoding utf8 $configFile
디스크로 데이터베이스 복원, 파일로 로그 복원
데이터베이스 PITR 예시와 같이 데이터베이스 로그 범위에서 $pit를 유효한 UTC 시간으로 설정하세요. 디스크 부착 구성을 생성한 후 로그 파일의 목적지를 설정하세요:
$configFile = ".\database-rad-logs.json"
az backup recoveryconfig show @databaseArgs --log-point-in-time $pit `
--restore-mode AlternateWorkloadRestore --recovery-mode SnapshotAttach `
--target-container-name $targetContainerName --target-server-name $targetVm `
--target-server-type SQLInstance --target-instance-name $targetInstanceName `
--snapshot-rg $restoreRg --identity-arm-id $uamiId --output json |
Set-Content -Encoding utf8 $configFile
구성 생성이 성공한 것을 확인한 후, 생성된 매핑을 편집합니다:
$cfg = Get-Content -Raw $configFile | ConvertFrom-Json
$cfg.target_directory_mapping = @{ all = 'C:\temp' }
($cfg.target_physical_path | Where-Object source_path -eq 'E:\').target_path = 'M:\'
$cfg | ConvertTo-Json -Depth 100 | Set-Content -Encoding utf8 $configFile
스냅샷 복원을 검토하고 제출하세요
선택한 각 시나리오에 대해 az backup recoveryconfig show가 성공하는지 확인한 후 출력을 사용하세요. 생성된 파일과 볼륨 매핑을 점검하세요. 다른 타겟 경로가 필요한 소스 볼륨만 리매핑하세요. 예시 드라이브 문자를 실제 경로로 교체하세요:
$cfg = Get-Content -Raw $configFile | ConvertFrom-Json
$cfg.target_physical_path | Format-Table source_path, target_path
($cfg.target_physical_path | Where-Object source_path -eq 'E:\').target_path = 'X:\'
$cfg | ConvertTo-Json -Depth 100 | Set-Content -Encoding utf8 $configFile
앞서 언급한 재매핑은 선택 사항입니다. 선택한 시나리오에 맞는 의도된 매핑과 데이터베이스 디스크 및 로그 파일 구성을 포함한 모든 관련 구성을 보존하세요.
파일 시스템 충돌을 해결하기 위해 디스크 분리가 필요한 경우, 생성된 구성에 명시적으로 승인된 디스크 ID만 추가하세요:
$cfg = Get-Content -Raw $configFile | ConvertFrom-Json
$cfg.disks_to_detach_on_clash = @(
"/subscriptions/<subscription-id>/resourceGroups/<disk-rg>/providers/Microsoft.Compute/disks/<disk-name>"
)
$cfg | ConvertTo-Json -Depth 100 | Set-Content -Encoding utf8 $configFile
Warning
기존 디스크를 분리하면 대상 워크로드에 영향을 줄 수 있습니다. 복원을 제출하기 전에 모든 디스크 ID와 전체 복구 설정을 확인하세요. 선택적 디스크 분리 예제는 필요하고 승인된 경우가 아니면 적용하지 마세요.
선택한 연산에 대한 구성 파일만 제출하세요:
az backup restore restore-azurewl @vaultArgs --recovery-config $configFile
반환된 작업 이름을 az backup job show로 추적하세요. 중지 보호 및 등록 해제 명령에 대해서는 SQL 인스턴스 스냅샷 백업 관리(Manage SQL instance snapshot backups)를 참조하세요.
다음 단계
관련 콘텐츠
- REST API를 통해 Azure Backup을 사용하여 Azure VM에서 SQL Server 데이터베이스를 백업합니다.
- REST API를 사용하여 Azure VM에서 SQL Server 데이터베이스를 복원합니다.
- Azure Portal, Azure CLI, REST API를 사용하여 Azure VM에서 SQL Server 데이터베이스를 관리합니다.