管理 Azure SQL 托管实例长期备份保留

一个有效的 Azure 订阅。

为 Azure CLI 准备环境。

• 在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 入门。

  

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

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

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

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

为 PowerShell 准备环境。

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

   

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 年的保留策略，并为年度长期保留（LTR）备份设定在 4 月 15 日这一周进行。

   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 SQL Managed Instance
$subId = "<subscriptionId>"
$instanceName = "<instanceName>"
$resourceGroup = "<resourceGroupName>"
$dbName = "<databaseName>"

Connect-AzAccount

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 门户中，选择 SQL 托管实例，然后选择“ 备份”。 在“可用备份”选项卡上，选择要查看其可用备份的数据库。 选择“管理”。

   

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

   

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

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

1. 登录 Azure 门户。

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

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

   

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

   

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

   

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 eastus2 \
    --managed-instance myinstance

从 LTR 备份进行还原

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

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

    get_backup_id=$(az sql midb ltr-backup show
       --location eastus2 \
       --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 SQL 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 SQL 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 eastus2 \
       --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