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 實例快照備份。
後續步驟
相關內容
- 透過 REST API 使用 Azure 備份在 Azure VM 中備份 SQL Server 資料庫。
- 使用 REST API 在 Azure VM 中還原 SQL Server 資料庫。
- 使用 Azure 入口網站、 Azure CLI、 REST API 管理 Azure VM 中的 SQL Server 資料庫。