用PowerShell在Azure VM中還原SQL Server資料庫和實例

本文說明如何使用 Azure PowerShell 還原串流資料庫備份與 SQL 實例快照備份。 你可以還原復原點,或使用交易日誌進行時間點還原(PITR)。

Prerequisites

  • 安裝最新的 Azure PowerShell 模組,包括 Az.RecoveryServices。 串流 SQL 還原需要 Az 6.0.0 或更新版本。 快照範例需要一個模組版本,該模組能暴露此處所示的快照參數。
  • 要有現有的 SQL 資料庫或實例備份。 請檢視 還原前置條件 與 快照支援矩陣。
  • 對於快照還原,準備一個目標資源群組及一個由使用者指派的受控識別,並具備所需權限。 檢閱 快照還原需求。
  • 在進行替代位置還原前,先將目的地虛擬機註冊到適當的保存庫。
  • 替換尖括號中的值。 執行所選情境的常見設定,然後選擇一個還原設定範例。 組態範例要等到您提交組態後才會開始還原。

登入,選擇保存庫訂用帳戶,然後取回保存庫:

Connect-AzAccount
Select-AzSubscription -SubscriptionId "<vault-subscription-id>"
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "<vault-rg>" -Name "<vault-name>"

還原串流資料庫備份

選擇資料庫與恢復時間

將資料庫查詢範圍設定為來源虛擬機的容器:

$sourceContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -BackupManagementType AzureWorkload -FriendlyName "<source-vm>" -VaultId $vault.ID
$databaseItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
    -WorkloadType MSSQL -Name "SQLDataBase;<instance-name>;<database-name>" `
    -VaultId $vault.ID
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
    -StartDate $startDate -EndDate $endDate -VaultId $vault.ID
$fullRecoveryPoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
    -RecoveryPointId "<recovery-point-id>" -VaultId $vault.ID

對於 PITR,請使用 Get-AzRecoveryServicesBackupRecoveryLogChain 查詢連續日誌範圍,然後在這些範圍內選擇一個 UTC 時間:

$logRanges = Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem -VaultId $vault.ID
$logRanges | Select-Object ItemName, StartTime, EndTime
$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()

對於串流 PITR,服務會決定針對所選時間點所需的完整備份與日誌鏈。

恢復至原始位置

選擇完整或差異回復點:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $fullRecoveryPoint -OriginalWorkloadRestore -VaultId $vault.ID

或者,使用所選的時間點:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -PointInTime $pointInTime -Item $databaseItem -OriginalWorkloadRestore -VaultId $vault.ID

Warning

將資料庫還原到原始位置會覆蓋原始資料庫。 提交前請先檢視恢復設定。

還原至替代位置

選擇目的地 VM 容器與 SQL 實例:

$targetContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -BackupManagementType AzureWorkload -FriendlyName "<target-vm>" -VaultId $vault.ID
$targetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
    -ItemType SQLInstance -Name "<target-instance>" -ServerName "<target-vm>" `
    -VaultId $vault.ID

對於完整或差異回收點:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $fullRecoveryPoint -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer -VaultId $vault.ID

針對 PITR:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer -VaultId $vault.ID

檢查產生的資料庫名稱和檔案路徑。 根據目的地需求變更它們:

$recoveryConfig | Format-List
$recoveryConfig.targetPhysicalPath | Format-Table
$recoveryConfig.RestoredDBName = "<restored-database-name>"

將串流備份還原為檔案

要在註冊目標虛擬機上還原完整或差異備份為檔案:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $fullRecoveryPoint -TargetContainer $targetContainer `
    -RestoreAsFiles -FilePath "<target-folder>" -VaultId $vault.ID

對於日誌 PITR,請從最新適用的完整備份中請求檔案:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -PointInTime $pointInTime -Item $databaseItem -TargetContainer $targetContainer `
    -RestoreAsFiles -FilePath "<target-folder>" -VaultId $vault.ID

若要使用特定的完整備份進行檔案還原,請在 PITR 設定指令中加入 -FromFull $fullRecoveryPoint 。

查詢快照恢復點

選擇受保護的實例

以下設定會選擇一個實例項目並列出其恢復點。 請使用此設定來進行本文後續的實例還原情境:

$sourceContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -BackupManagementType AzureWorkload -FriendlyName "<source-vm>" -VaultId $vault.ID
$instanceItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
    -WorkloadType MSSQLInstance -Name "sqlinstance;<instance-name>" -VaultId $vault.ID
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()

$recoveryPoints = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
    -StartDate $startDate -EndDate $endDate `
    -RestorePointQueryType FullDifferentialAndSnapshot -VaultId $vault.ID
$snapshotPoints = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
    -RestorePointQueryType Snapshot -VaultId $vault.ID
$latestSnapshot = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
    -GetLatestRecoveryPointOnly -RestorePointQueryType Snapshot -VaultId $vault.ID
$snapshotPoints | Format-Table RecoveryPointId, RecoveryPointTime, RecoveryPointType

從退回清單中選擇一個識別碼。 透過 ID 擷取該恢復點以取得完整細節,而非假設第一個清單條目即為所需的快照:

$snapshotPoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
    -RecoveryPointId "<snapshot-recovery-point-id>" -VaultId $vault.ID
$snapshotPoint.IncludedDatabases | Select-Object DatasourceName, DatasourceId
$snapshotPoint.SnapshotRecoveryPointInfo.SnapshotResourceGroup
$snapshotPoint.SnapshotRecoveryPointInfo.SourceFilesystemInfo | Select-Object `
    Label, FileSystemType, @{Name = 'AccessPaths'; Expression = { $_.AccessPaths -join ',' }}, IsOnStorageSpace

位於執行個體快照之上的查詢記錄範圍

記錄鏈查詢針對包含在快照中的每個資料庫項目。 基礎資料來源 ID 是 實例的ProtectedItemDataSourceId,不是資料庫的 DatasourceId:

$logRangesPerDatabase = @{}
foreach ($database in $snapshotPoint.IncludedDatabases) {
    $databaseItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
        -WorkloadType MSSQL -Name "SQLDataBase;$($database.DatasourceName)" -VaultId $vault.ID
    $logRangesPerDatabase[$database.DatasourceName] = @(
        Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem `
            -RecoveryMode SnapshotAttachAndRecover `
            -BaseSnapshotRecoveryPointId $snapshotPoint.RecoveryPointId `
            -BaseRecoveryPointDatasourceId $instanceItem.ProtectedItemDataSourceId `
            -VaultId $vault.ID
    )
}
$logRangesPerDatabase["<instance-name>;<database-name>"] | Format-Table ItemName, StartTime, EndTime

用 Get-AzRecoveryServicesBackupRecoveryLogChain 表示時間範圍。 Get-AzRecoveryServicesBackupRecoveryPoint 回傳的是個別的恢復點,而非連續的日誌範圍。

還原實例快照

使用來自查詢快照恢復點的執行個體和詳細$snapshotPoint。 原始與替代位置快照配置都需要目標資源群組及使用者指派的受控識別:

$identityId = "/subscriptions/<subscription-id>/resourceGroups/<identity-rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"
$targetResourceGroup = "<target-rg>"

原始位置還原

建立一個原始工作負載還原設定:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $snapshotPoint -OriginalWorkloadRestore `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -VaultId $vault.ID

替代位置還原

選擇目的地容器和實例。 使用此目的地設定進行替代位置還原、實例 PITR 及還原為磁碟:

$targetContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -BackupManagementType AzureWorkload -FriendlyName "<target-vm>" -VaultId $vault.ID
$targetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
    -ItemType SQLInstance -Name "<target-instance>" -ServerName "<target-vm>" -VaultId $vault.ID

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $snapshotPoint -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -VaultId $vault.ID

時間點還原

首先執行 每個資料庫的日誌範圍查詢。 選擇 每個正在還原的資料庫 都可使用的 UTC 還原時間。 以下檢查會拒絕超出任何資料庫任一有效範圍的時間:

$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()
if ($logRangesPerDatabase.Count -eq 0) {
    throw "No database log ranges were retrieved for the selected snapshot."
}
foreach ($databaseName in $logRangesPerDatabase.Keys) {
    $matchingRanges = @($logRangesPerDatabase[$databaseName] | Where-Object {
        $_.StartTime.ToUniversalTime() -le $pointInTime -and
        $_.EndTime.ToUniversalTime() -ge $pointInTime
    })
    if ($matchingRanges.Count -eq 0) {
        throw "The selected restore time is unavailable for $databaseName."
    }
}

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $snapshotPoint -PointInTime $pointInTime `
    -AlternateWorkloadRestore -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID

快照恢復點識別基底快照; -PointInTime 指定日誌重播目標。 此範例要求-NoRecoveryMode,讓資料庫維持在未恢復狀態,以便進行後續的恢復步驟。 為您的的恢復計畫檢閱選項。

還原為磁碟

使用 SnapshotAttach 來附加快照磁碟,而非執行快照附接與資料庫還原:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $snapshotPoint -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -RecoveryMode SnapshotAttach -VaultId $vault.ID

設定目標路徑與磁碟衝突

提交任何實例快照設定前請先檢查 targetPhysicalPath 。 來源磁碟區以空白目標路徑列出。 僅為需要重新映射的卷區設定目標路徑,例如解決檔案系統衝突時:

$recoveryConfig.targetPhysicalPath | Format-Table SourcePath, TargetPath
($recoveryConfig.targetPhysicalPath | Where-Object { $_.SourcePath -eq "E:\" }).TargetPath = "X:\"

將範例的來源路徑和目標路徑替換成適合你的復原點和目的地的路徑。 若需要卸離磁碟以解決衝突,請明確找出受影響的磁碟:

$recoveryConfig.DisksToDetachOnClash = @(
    "/subscriptions/<subscription-id>/resourceGroups/<disk-rg>/providers/Microsoft.Compute/disks/<disk-name>"
)

Warning

卸離現有磁碟可能會干擾使用它的工作負載。 在提交還原前,請確認磁碟 ID 和目的地檔案系統設定。

還原一個在執行個體下受保護的資料庫

通用設定

選擇資料庫備份項目、目的地容器與執行個體、目標資源群組,以及身分識別:

$sourceContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -BackupManagementType AzureWorkload -FriendlyName "<source-vm>" -VaultId $vault.ID
$databaseItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
    -WorkloadType MSSQL -Name "SQLDataBase;<instance-name>;<database-name>" -VaultId $vault.ID
$targetContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -BackupManagementType AzureWorkload -FriendlyName "<target-vm>" -VaultId $vault.ID
$targetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
    -ItemType SQLInstance -Name "<target-instance>" -ServerName "<target-vm>" -VaultId $vault.ID
$targetResourceGroup = "<target-rg>"
$identityId = "/subscriptions/<subscription-id>/resourceGroups/<identity-rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"

對於快照復原點還原,請列出資料庫的快照,並依 ID 擷取所選點:

Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
    -RestorePointQueryType Snapshot -VaultId $vault.ID
$databaseSnapshot = Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
    -RecoveryPointId "<database-snapshot-recovery-point-id>" -VaultId $vault.ID

替代位置還原

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $databaseSnapshot -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID

時間點還原

列出資料庫可用的日誌範圍,並在回傳範圍內選擇一個UTC時間:

$logRanges = Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem -VaultId $vault.ID
$logRanges | Select-Object ItemName, StartTime, EndTime
$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID

兩個資料庫復原範例都指定了 -NoRecoveryMode。 檢視你的復原計畫是否要求資料庫保持未復原狀態。

還原為磁碟

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $databaseSnapshot -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -RecoveryMode SnapshotAttach -VaultId $vault.ID

以磁碟還原,日誌則是檔案

從資料庫可用的日誌範圍中選擇一個時間,如資料庫 PITR 範例,然後設定日誌檔案的目的地:

$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
    -TargetItem $targetInstance -TargetContainer $targetContainer `
    -TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
    -RecoveryMode SnapshotAttach -TargetDirectoryMapping @{ all = "C:/temp" } `
    -VaultId $vault.ID

對於任何這些資料庫快照配置,請檢查來源路徑並設定所需的目標卷映射,然後再提交:

$recoveryConfig.targetPhysicalPath | Format-Table SourcePath, TargetPath
($recoveryConfig.targetPhysicalPath | Where-Object { $_.SourcePath -eq "E:\" }).TargetPath = "M:\"

提交還原並追蹤工作

檢閱所選組態,然後使用 Restore-AzRecoveryServicesBackupItem 提交它:

$recoveryConfig | Format-List
$restoreJob = Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $recoveryConfig -VaultId $vault.ID
$restoreJob

使用回傳的工作 ID 搭配 工作監控指令。

串流資料庫備份的跨區域還原

啟用跨區域還原時,請使用-UseSecondaryRegion來查詢已複寫的項目、恢復點和記錄鏈。 目標虛擬機必須在配對區域的保存庫中註冊:

$secondaryItems = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureWorkload `
    -WorkloadType MSSQL -VaultId $vault.ID -UseSecondaryRegion
$secondaryItems | Format-Table Name, FriendlyName
$secondaryItem = $secondaryItems | Where-Object { $_.Name -eq "<backup-item-name>" }
$secondaryPoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $secondaryItem `
    -RecoveryPointId "<recovery-point-id>" -UseSecondaryRegion -VaultId $vault.ID
Get-AzRecoveryServicesBackupRecoveryLogChain -Item $secondaryItem `
    -UseSecondaryRegion -VaultId $vault.ID

$pairedVault = Get-AzRecoveryServicesVault -ResourceGroupName "<paired-vault-rg>" -Name "<paired-vault-name>"
$secondaryContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
    -FriendlyName "<secondary-vm>" -Status Registered -VaultId $pairedVault.ID
$secondaryInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
    -ItemType SQLInstance -Container $secondaryContainer -VaultId $pairedVault.ID
$secondaryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
    -RecoveryPoint $secondaryPoint -AlternateWorkloadRestore `
    -TargetItem $secondaryInstance -TargetContainer $secondaryContainer -UseSecondaryRegion -VaultId $vault.ID
Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $secondaryConfig `
    -RestoreToSecondaryRegion -VaultId $vault.ID

從回傳的物件中選擇一個獨特的來源項目和目標實例。 對於日誌 PITR,將配置建構為 -PointInTime 和 -Item $secondaryItem,而非 -RecoveryPoint。 在繼續前,請先檢視 跨區域的恢復要求 。 此範例涵蓋串流資料庫備份,而非跨區域快照配置。

下一步