管理 Azure SQL 数据库长期备份保留

一个有效的 Azure 订阅。

为 Azure CLI 准备环境。

如需在本地运行 CLI 参考命令，请安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

• 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。

• 出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。

• 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

为 PowerShell 准备环境。

对于 Get-AzSqlDatabaseLongTermRetentionBackup 和 Restore-AzSqlDatabase，你需要是以下角色之一的成员：

• “订阅所有者”角色或

• 订阅参与者角色，或

• “SQL Server 参与者”角色或

• 具有以下权限的自定义角色：

  Microsoft.Sql/locations/longTermRetentionBackups/read Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionBackups/read Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups/read

对于 Remove-AzSqlDatabaseLongTermRetentionBackup，你需要是以下角色之一的成员：

• “订阅所有者”角色或

• 订阅参与者角色，或

• 具有以下权限的自定义角色：

  Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups/delete

可以对 SQL 数据库进行配置，使其保留自动备份的时间长于你的服务层级的保留期。

1. 在 Azure 门户中，导航到服务器，然后选择“备份”。 选择“保留策略”选项卡以修改备份保留设置。

   

2. 在“保留策略”选项卡上，选择要为其设置或修改长期备份保留策略的数据库。 未选定的数据库不受影响。

   

3. 在“配置策略”窗格中，为每周、每月或每年备份指定所需的保留期。 选择的保留期为“0”表明不应设置长期备份保留期。

   

4. 选择“应用”以将所选保留设置应用于所有选定数据库。

运行 az sql db ltr-policy set 命令，以创建 LTR 策略。 以下示例为每周备份设置 12 周的长期保留策略。

az sql db ltr-policy set \
   --resource-group mygroup \
   --server myserver \
   --name mydb \
   --weekly-retention "P12W"

该示例为每周备份设置12周的保留策略，为每年备份设置5年的保留策略，并在4月15日所在的那一周进行年度LTR备份。

az sql db ltr-policy set \
   --resource-group mygroup \
   --server myserver \
   --name mydb \
   --weekly-retention "P12W" \
   --yearly-retention "P5Y" \
   --week-of-year 16

# get the SQL server
$subId = "<subscriptionId>"
$serverName = "<serverName>"
$resourceGroup = "<resourceGroupName>"
$dbName = "<databaseName>"

Connect-AzAccount -Environment AzureChinaCloud
Select-AzSubscription -SubscriptionId $subId

$server = Get-AzSqlServer -ServerName $serverName -ResourceGroupName $resourceGroup

# create LTR policy with WeeklyRetention = 12 weeks. MonthlyRetention and YearlyRetention = 0 by default.
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup -WeeklyRetention P12W

# create LTR policy with WeeklyRetention = 12 weeks, YearlyRetention = 5 years and WeekOfYear = 16 (week of April 15). MonthlyRetention = 0 by default.
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup -WeeklyRetention P12W -YearlyRetention P5Y -WeekOfYear 16

1. 在 Azure 门户中，导航到服务器，然后选择“备份”。 若要查看特定数据库的可用 LTR 备份，请在“可用 LTR 备份”列下选择“管理”。 将显示一个窗格，其中包含所选数据库的可用 LTR 备份列表。

   

2. 在显示的可用 LTR 备份窗格中，查看可用备份。 选择要还原的备份。

   

3. 若要从可用 LTR 备份进行还原，请选择要从中进行还原的备份，然后选择“还原”。

   

4. 选择新数据库的名称，然后选择“查看 + 创建”以查看还原的详细信息。 选择“创建”以从所选备份还原数据库。

   

5. 在工具栏上，选择通知图标可查看还原作业的状态。

   

6. 完成还原作业后，打开“SQL 数据库”页面以查看新还原的数据库。

运行 az sql db ltr-policy show 命令，以查看服务器上单一数据库的 LTR 策略。

az sql db ltr-policy show \
    --resource-group mygroup \
    --server myserver \
    --name mydb

使用 az sql db ltr-backup list 命令列出数据库的 LTR 备份。 可以使用此命令查找在其他命令中使用的 name 参数。

az sql db ltr-backup list \
   --location chinaeast2 \
   --server myserver \
   --database mydb

运行 az sql db ltr-backup restore 命令，从 LTR 备份还原数据库。 可以运行 az sql db ltr-backup show 来获取 backup-id。

1. 使用命令“az sql db ltr-backup show”为 backup-id 创建变量供将来使用。

   get_backup_id=$(az sql db ltr-backup show 
       --location chinaeast2 \
       --server myserver \
       --database mydb \
       --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000" \
       --query 'id' \
       --output tsv)
   

2. 您可以从 LTR 备份中恢复数据库。

   az sql db ltr-backup restore \
      --dest-database targetdb \
      --dest-server myserver \
      --dest-resource-group mygroup \
      --backup-id $get_backup_id
   

此示例演示如何列出服务器中的 LTR 策略。

# get all LTR policies within a server
$ltrPolicies = Get-AzSqlDatabase -ResourceGroupName $resourceGroup -ServerName $serverName | `
    Get-AzSqlDatabaseLongTermRetentionPolicy

# get the LTR policy of a specific database
$ltrPolicies = Get-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup

此示例演示如何从数据库中清除 LTR 策略。

Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ServerName $serverName -DatabaseName $dbName `
    -ResourceGroupName $resourceGroup -RemovePolicy

此示例展示了如何列出服务器内的 LTR 备份。

# get the list of all LTR backups in a specific Azure region
# backups are grouped by the logical database id, within each group they are ordered by the timestamp, the earliest backup first
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location

# get the list of LTR backups from the Azure region under the named server
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -ServerName $serverName

# get the LTR backups for a specific database from the Azure region under the named server
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -ServerName $serverName -DatabaseName $dbName

# list LTR backups only from live databases (you have option to choose All/Live/Deleted)
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -DatabaseState Live

# only list the latest LTR backup for each database
$ltrBackups = Get-AzSqlDatabaseLongTermRetentionBackup -Location $server.Location -ServerName $serverName -OnlyLatestPerDatabase

此示例展示了如何从 LTR 备份进行还原。 请注意，此接口没有更改，但是资源 ID 参数现在要求提供 LTR 备份资源 ID。

# restore a specific LTR backup as an P1 database on the server $serverName of the resource group $resourceGroup
Restore-AzSqlDatabase -FromLongTermRetentionBackup -ResourceId $ltrBackup.ResourceId -ServerName $serverName -ResourceGroupName $resourceGroup `
    -TargetDatabaseName $dbName -ServiceObjectiveName P1

1. 在 Azure 门户中，导航到 Azure SQL 数据库的逻辑服务器。
2. 选择“备份”。 若要查看特定数据库的可用 LTR 备份，请在“可用 LTR 备份”列下选择“管理”。 将显示一个窗格，其中包含所选数据库的可用 LTR 备份列表。
3. 在显示的可用 LTR 备份窗格中，查看可用备份。 选择要删除的备份。 选择“删除”。

1. 使用 az sql db ltr-backup list 查找备份 name。
2. 运行 az sql db ltr-backup delete 命令来删除 LTR 备份。

   az sql db ltr-backup delete \
      --location chinanorth3 \
      --server myserver \
      --database mydb \
      --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"
   

此示例展示了如何从备份列表中删除 LTR 备份。

1. 通过查看 LTR 备份来标识备份。
2. 使用 Remove-AzSqlDatabaseLongTermRetentionBackup 删除备份。

   # remove the earliest backup
   $ltrBackup = $ltrBackups[0]
   Remove-AzSqlDatabaseLongTermRetentionBackup -ResourceId $ltrBackup.ResourceId