使用 Azure CLI 在 Azure VM 中還原 SQL 資料庫

Azure CLI 可用來從命令列或透過指令碼建立和管理 Azure 資源。 本文說明如何使用 Azure CLI 在 Azure VM 上還原備份的 SQL 資料庫。 您也可以使用 Azure 入口網站來執行這些動作。

使用 Azure Cloud Shell 來執行 CLI 命令。

本文假設你有一個在 Azure VM 上運行的 SQL 資料庫,並且用 Azure 備份 備份。 如果您已經使用 使用 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

上述清單包含三個復原點:各自用於完整備份、差異備份和日誌備份。

備註

您也可以使用 az backup recoverypoint show-log-chain 命令,來檢視每個未破解記錄備份鏈結的起點和終點。

用以還原資料庫的必要條件

在還原資料庫之前,請先確定您符合下列必要條件:

  • 您只能將資料庫還原到相同區域中的 SQL 執行個體,或在保存庫上啟用跨區域還原時還原到不同區域。
  • 除非在跨區域還原與跨訂用帳戶還原期間,否則目標執行個體必須與來源一樣註冊到相同的保存庫。 .

還原資料庫

Azure 備份可以還原在 Azure VM 上執行的 SQL 資料庫,如下所示:

  • 使用記錄備份還原至特定日期或時間 (可精確到秒)。 Azure 備份會根據選取的時間,自動決定還原所需的適當完整備份、差異備份和記錄備份鏈結。
  • 還原到特定完整或差異備份,以還原到特定復原點。

若要還原資料庫,請使用 az restore restore-azurewl 命令,這需要復原組態物件做為其中一個輸入。 您可以使用 az backup recoveryconfig show 命令來產生這個物件。 復原設定物件包含用來執行還原的所有詳細資料。 其中一個是還原模式 – OriginalWorkloadRestore 或 AlternateWorkloadRestore。

備註

OriginalWorkloadRestore:將數據還原至與原始來源相同的 SQL 實例。 此選項會覆寫原始資料庫。 AlternateWorkloadRestore:將資料庫還原至替代位置,並保留原始源資料庫。

還原至替代位置

若要將資料庫還原至替代位置,請使用 AlternateWorkloadRestore 作為還原模式。 接著,您必須選擇還原點,這可以是先前的時間點,或是任何先前的還原點。

讓我們繼續還原至先前的還原點。 檢視資料庫的還原點清單 ,然後選擇您要還原的點。 這裡讓我們使用名稱為 7660777527047692711 的還原點。

使用上述還原點名稱和還原模式,使用 az backup recoveryconfig show 命令建立復原設定物件。 檢查此命令中的其餘參數:

  • --target-item-name:還原後要給資料庫使用的名稱。 在本案例中,我們使用的名稱為 restored_database。
  • --target-server-name:成功註冊到復原服務保存庫的 SQL 伺服器名稱,並保留與要還原的資料庫相同的區域。 現在,您要將資料庫還原到已保護的相同 SQL Server,名為 testSQLVM。
  • --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 命令。 為了使用此命令,請輸入上述 JSON 輸出,其已儲存至名為 recoveryconfig.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 命令。 為了使用此命令,請輸入上述 JSON 輸出,其已儲存至名為 recoveryconfig.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

備註

次要區域中可供使用的備份資料 RPO 為 12 個小時。 因此,當您開啟 CRR 時,次要區域的 RPO 是 12 小時 + 記錄頻率持續時間 (可設定為至少 15 分鐘)。

還原成檔案形式

若要將備份數據還原為檔案而非資料庫,請使用 RestoreAsFiles 作為還原模式。 接著選擇還原點,這可以是先前的時間點,或是任何先前的還原點。 一旦檔案備份到指定的路徑,您就可以將這些檔案放到任何 SQL 機器上,並在其中將檔案還原為資料庫。 因為您可以將這些檔案移至任何機器,所以您現在可以在訂用帳戶和區域之間還原資料。

選擇要還原的先前時間點28-11-2019-09:53:00,以及要在同一部 SQL Server 上將備份檔案轉儲為C:\restoreasfiles的位置。 您可以使用下列其中一種格式提供此還原點: dd-mm-y 或 dd-mm-yyyy-hh:mm:ss。 若要選擇有效的還原時間點,請使用 az backup recoverypoint show-log-chain 命令,其中會列出未破解記錄鏈結備份的間隔。

使用上述還原點名稱和還原模式,使用 az backup recoveryconfig show 命令建立復原設定物件。 檢查此命令中的其餘各項參數:

  • --target-container-name:成功註冊到復原服務保存庫的 SQL 伺服器名稱,並存在於與要還原之資料庫相同的區域中。 我們先把資料庫還原成檔案,到您先前保護的同一部 SQL Server,名為 mssqlserver。
  • --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 命令。 為了使用此命令,請輸入上述 JSON 輸出,其已儲存至名為 recoveryconfig.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 命令來追蹤作業狀態。

備註

如果您不想還原整個鏈結,但只還原檔案的子集,請遵循 此處所述的步驟。

跨訂用帳戶還原

使用跨訂用帳戶還原 (CSR) 時,只要具有還原權限,就可以靈活地將資料還原至租用戶下的任何訂用帳戶和任何保存庫。 根據預設,所有復原服務保存庫 (現有和新建立的保存庫) 都會啟用 CSR。

備註

  • 您可以從復原服務保存庫觸發跨訂用帳戶還原。
  • 只有串流型備份才支援 CSR,快照型備份不支援 CSR。
  • 不支援使用 CSR 進行跨區域還原 (CRR)。
az backup vault create

新增參數 cross-subscription-restore-state,此參數可讓您在保存庫建立和更新期間設定保存庫的 CSR 狀態。

az backup recoveryconfig show

新增參數 --target-subscription-id,此參數可讓您在觸發 SQL 或 HANA 資料來源的跨訂用帳戶還原時,提供目標訂用帳戶作為輸入。

範例:

   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 實例快照

以下範例使用 PowerShell shell 語法,而非 Bash。 請使用一個 Azure CLI 版本,該版本會顯示本文中展示的快照選項。 檢視 快照還原的前置條件 與 支援矩陣。

使用前取代預留位置。 完成常見設定,只選擇所需的還原情境。 以下範例是替代方案,不是要完整執行的腳本。 還原指令可以覆寫資料或更改磁碟附加狀態。

設定快照還原變數

使用保存庫的訂閱帳戶以用於$vaultSubscription。 準備目標資源群組及使用者指派的受控識別,並搭配所需權限:

$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 要求資料庫在後續復原階段中保持未復原狀態。 檢視這種行為是否適合你的復原計畫。

將實例還原為磁碟

使用 SnapshotAttach 還原為磁碟(RAD),而非先附加快照再進行資料庫復原:

$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

將資料檔還原為磁碟,及將記錄還原為檔案

設定 $pit 為資料庫日誌範圍中的有效 UTC 時間,如資料庫 PITR 範例所示。 產生磁碟附加設定,然後設定日誌檔案的目的地:

$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 實例快照備份。

後續步驟