管理 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-AzSqlInstanceDatabaseLongTermRetentionBackup 和 Restore-AzSqlInstanceDatabase，你需要是以下角色之一的成员：

• “订阅所有者”角色或
• SQL 托管实例参与者角色或
• 具有以下权限的自定义角色：
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

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

• “订阅所有者”角色或
• 具有以下权限的自定义角色：
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

1. 在 Azure 门户中，选择你的托管实例，然后选择“备份”。 在“保留策略”选项卡上，选择要为其设置或修改长期备份保留策略的数据库。 更改将不会应用于未选择的任何数据库。

   

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

   

3. 完成后选择“应用”。

1. 运行 az sql midb show 命令，以获取 SQL 托管实例数据库的详细信息。

   az sql midb show /
   --resource-group mygroup /
   --managed-instance myinstance /
   --name mymanageddb /
   --subscription mysubscription
   

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

   az sql midb ltr-policy set /
   --resource-group mygroup /
   --managed-instance myinstance /
   --name mymanageddb /
   --weekly-retention "P12W"
   

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

   az sql midb ltr-policy set /
   --resource-group mygroup /
   --managed-instance myinstance /
   --name mymanageddb /
   --weekly-retention "P12W" /
   --yearly-retention "P5Y" /
   --week-of-year 16
   

# get the Managed Instance
$subId = "<subscriptionId>"
$instanceName = "<instanceName>"
$resourceGroup = "<resourceGroupName>"
$dbName = "<databaseName>"

Connect-AzAccount -Environment AzureChinaCloud

Select-AzSubscription -SubscriptionId $subId

$instance = Get-AzSqlInstance -Name $instanceName -ResourceGroupName $resourceGroup

# create LTR policy with WeeklyRetention = 12 weeks. MonthlyRetention and YearlyRetention = 0 by default.
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup 
    WeeklyRetention = 'P12W'
}
Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy

# create LTR policy with WeeklyRetention = 12 weeks, YearlyRetention = 5 years and WeekOfYear = 16 (week of April 15). MonthlyRetention = 0 by default.
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup 
    WeeklyRetention = 'P12W' 
    YearlyRetention = 'P5Y' 
    WeekOfYear = '16'
}
Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy

若要查看 Azure 门户中提供的长期备份，请执行以下步骤：

1. 在 Azure 门户中，选择你的托管实例，然后选择“备份”。 在“可用备份”选项卡上，选择要查看其可用备份的数据库。 选择“管理”。

   

2. 在“管理备份”窗格中，查看可用备份。

   

还可以通过依次选择“备份”和“还原”，从此页面还原。

或者，若要使用 Azure 门户从长期保留中还原备份，请执行以下步骤：

1. 登录 Azure 门户。

2. 转到计划将数据库还原到的目标 SQL 托管实例。

3. 在“概述”页面上，选择“+ 新建数据库”，打开“创建 Azure SQL 托管数据库”页面。

   

4. 在“创建 Azure SQL 托管数据库”页面的“基本信息”选项卡上，在“项目详细信息”下提供订阅和资源组详细信息。 然后，在“数据库详细信息”下提供计划还原的数据库的新名称。 确认下拉列表中列出了正确的托管实例。 然后选择“下一步: 数据源 >”

   

5. 在“数据源”选项卡上，选择“使用现有数据”下的“时间点还原”。 提供包含源数据库的订阅、资源组和托管实例。 从“托管数据库”下拉列表中，选择要还原的数据库，然后选择要从中还原数据库的时间点。 源实例和目标实例可以是两个相同的实例，也可以是两个不同的实例。 选择“下一步: 其他设置 >”

   

6. 在“其他设置”选项卡上，可以选中该框以从源数据库继承保留策略，也可以选择“配置保留期”以打开“配置策略”页面，并为还原的数据库设置所需的保留策略。 完成后，选择“查看 + 创建”。

   

7. 在“查看 + 创建”上，验证成功后，选择“创建”以还原数据库。

此操作会启动还原过程，期间会创建一个新数据库，并在其中填充原始数据库在指定时间点的数据。 有关恢复过程的详细信息，请参阅恢复时间。

查看 LTR 策略

运行 az sql midb ltr-policy show 命令，以查看实例中单一数据库的 LTR 策略。

az sql midb ltr-policy show \
    --resource-group mygroup \
    --managed-instance myinstance \
    --name mymanageddb

查看 LTR 备份

使用 az sql midb ltr-backup list 命令来查看实例中的 LTR 备份。

az sql midb ltr-backup list \
    --resource-group mygroup \
    --location chinanorth3 \
    --managed-instance myinstance

从 LTR 备份进行还原

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

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

    get_backup_id=$(az sql midb ltr-backup show
       --location chinanorth3 \
       --managed-instance myinstance \
       --database mydb \
       --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000" \
       --query 'id' \
       --output tsv)
   

2. 从 LTR 备份还原数据库

   az sql midb ltr-backup restore \
       --dest-database targetmidb \
       --dest-mi myinstance \
       --dest-resource-group mygroup \
       --backup-id $get_backup_id
   

查看 LTR 策略

此示例展示了如何列出单个数据库的实例内的 LTR 策略。

# gets the current version of LTR policy for a database
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup
}
Get-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy 

此示例展示了如何列出实例上所有数据库的 LTR 策略。

# gets the current version of LTR policy for all of the databases on an instance

$Databases = Get-AzSqlInstanceDatabase -ResourceGroupName $resourceGroup -InstanceName $instanceName

$LTRParams = @{
    InstanceName = $instanceName
    ResourceGroupName = $resourceGroup
}

foreach($database in $Databases.Name){
    Get-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRParams  -DatabaseName $database
 }

清除 LTR 策略

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

# remove the LTR policy from a database
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup 
    RemovePolicy = $true
}
Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy

查看 LTR 备份

此示例展示了如何列出实例内的 LTR 备份。

$instance = Get-AzSqlInstance -Name $instanceName -ResourceGroupName $resourceGroup

# 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
Get-AzSqlInstanceDatabaseLongTermRetentionBackup -Location $instance.Location

# get the list of LTR backups from the Azure region under the given managed instance
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam

# get the LTR backups for a specific database from the Azure region under the given managed instance
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    DatabaseName = $dbName
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam

# list LTR backups only from live databases (you have option to choose All/Live/Deleted)
$LTRBackupParam = @{
    Location = $instance.Location 
    DatabaseState = 'Live'
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam

# only list the latest LTR backup for each database
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    OnlyLatestPerDatabase = $true
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam 

从 LTR 备份进行还原

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

# restore a specific LTR backup as an P1 database on the instance $instanceName of the resource group $resourceGroup
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    DatabaseName = $dbname
    OnlyLatestPerDatabase = $true
}
$ltrBackup = Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam 

$RestoreLTRParam = @{
    TargetInstanceName          = $instanceName 
    TargetResourceGroupName     = $resourceGroup 
    TargetInstanceDatabaseName  = $dbName
    FromLongTermRetentionBackup = $true
    ResourceId                  = $ltrBackup.ResourceId 
}
Restore-AzSqlInstanceDatabase @RestoreLTRParam

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

1. 运行 az sql midb ltr-backup list 来获取备份 name。

2. 运行 az sql midb ltr-backup delete 命令来删除 LTR 备份。

   az sql midb ltr-backup delete \
       --location chinanorth3 \
       --managed-instance myinstance \
       --database mymanageddb \
       --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"
   

此示例展示了如何从备份列表中删除最早的 LTR 备份。 此示例从给定 SQL 托管实例下的 Azure 区域获取特定数据库的 LTR 备份列表。

# remove the earliest backup
# get the LTR backups for a specific database from the Azure region under the given SQL managed instance
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    DatabaseName = $dbName
}
$ltrBackups = Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam
$ltrBackup = $ltrBackups[0]
Remove-AzSqlInstanceDatabaseLongTermRetentionBackup -ResourceId $ltrBackup.ResourceId