你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

使用 Azure CLI 还原 Azure VM 中的 SQL 数据库

Azure CLI 用于从命令行或通过脚本创建和管理 Azure 资源。 本文介绍如何使用 Azure CLI 在 Azure VM 上还原备份的 SQL 数据库。 还可以使用 Azure 门户执行这些作业。

使用 Azure Cloud Shell 运行 CLI 命令。

本文假定你已在 Azure VM 上运行一个 SQL 数据库,并且该数据库已使用 Azure 备份进行备份。 如果您已使用 在 Azure 中使用 CLI 备份 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 备份可以还原 Azure VM 上运行的 SQL 数据库,如下所述:

  • 使用日志备份还原到特定的日期或时间(精确到秒)。 Azure 备份可自动确定相应的完整备份、差异备份和日志链备份,这些是根据所选时间进行还原所必需的。
  • 还原特定的完整备份或差异备份,这样就可以还原到特定的恢复点。

若要还原数据库,请使用 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:成功注册到恢复服务保管库并且与要还原的数据库位于同一区域中的 SQL Server 的名称。 在这里,你将数据库还原到已保护的同一 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

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:成功注册到恢复服务保管库并且与要还原的数据库位于同一区域中的 SQL Server 的名称。 现在,我们将数据库以文件形式还原到已保护的同一 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 命令跟踪作业状态。

Note

如果不想还原整个链,但只还原一部分文件,请按照 此处所述的步骤作。

跨订阅还原

通过跨订阅还原 (CSR),可以灵活地还原到租户下的任何订阅和保管库(如果还原权限可用)。 默认情况下,将在所有恢复服务保管库(现有和新创建的保管库)上启用 CSR。

Note

  • 可以从恢复服务保管库触发跨订阅还原。
  • CSR 仅支持基于流式处理的备份,不支持基于快照的备份。
  • 不支持将跨区域还原 (CRR) 与 CSR 一起使用。
az backup vault create

添加参数 cross-subscription-restore-state,使你能够在保管库创建和更新期间设置保管库的 CSR 状态。

az backup recoveryconfig show

添加参数 --target-subscription-id,它使你能够在触发 SQL 或 HANA 数据源的跨订阅还原时提供目标订阅作为输入。

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

以下示例使用 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 实例快照备份。

后续步骤