Управление долгосрочным хранением резервных копий для Управляемого экземпляра SQL Azure

Активная подписка Azure.

Подготовьте среду к работе с Azure CLI.

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.

  

• Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью 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. Чтобы создать политику LTR, выполните команду az sql midb ltr-policy set. В следующем примере для еженедельного резервного копирования задается политика долгосрочного хранения на 12 недель.

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

   В этом примере политика хранения для еженедельного резервного копирования устанавливается на 12 недель, для ежегодного резервного копирования — на 5 лет, а также на неделю с 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

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. На странице "Обзор" выберите +Создать базу данных, чтобы открыть страницу "Создание управляемой базы данных SQL Azure".

   

4. На вкладке "Основы" на странице "Создание управляемой базы данных SQL Azure" укажите сведения о подписке и группе ресурсов в разделе "Сведения о проекте". Затем в разделе "Сведения о базе данных" укажите новое имя базы данных, который вы планируете восстановить. Убедитесь, что правильный управляемый экземпляр указан в раскрывающемся списке. Затем нажмите кнопку Next: Источник данных >

   

5. На вкладке "Источник данных" выберите восстановление на определенный момент времени в разделе "Использование существующих данных". Укажите подписку, группу ресурсов и управляемый экземпляр, содержащий исходную базу данных. В раскрывающемся списке управляемой базы данных выберите базу данных , которую вы хотите восстановить, а затем выберите точку во времени, из которой нужно восстановить базу данных. Исходный и целевой экземпляр могут быть одинаковыми или двумя различными экземплярами. Нажмите кнопку "Далее" : дополнительные параметры >

   

6. На вкладке "Дополнительные параметры" можно установить флажок, чтобы наследовать политику хранения из исходной базы данных или, кроме того, можно выбрать "Настроить хранение", чтобы открыть страницу "Настройка политик" и задать нужные политики хранения для восстановленной базы данных. Завершив этот процесс, выберите Просмотреть и создать.

   

7. При успешном выполнении проверки нажмите кнопку "Создать ", чтобы восстановить базу данных.

Это действие запускает процесс восстановления, который создает новую базу данных и заполняет ее данными из исходной базы данных на указанный момент времени. Дополнительные сведения о процессе восстановления см. в статье Время восстановления.

Просмотр политик LTR

Чтобы просмотреть политику LTR для отдельной базы данных в экземпляре, выполните команду az sql midb ltr-policy show.

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

Просмотр резервных копий LTR

Чтобы просмотреть резервные копии LTR в экземпляре, выполните команду az sql midb ltr-backup list.

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

Восстановление из резервных копий LTR

Чтобы восстановить базу данных из резервной копии LTR, выполните команду az sql midb ltr-backup restore. Чтобы получить , можно выполнить 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 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. Обратите внимание, что интерфейс не меняется, но для параметра идентификатора ресурса теперь требуется наличие идентификатора ресурса резервной копии LTR.

# 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. Чтобы удалить резервную копию LTR, выполните команду az sql midb ltr-backup delete.

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

В этом примере показано, как удалить раннюю резервную копию LTR из списка резервных копий. Этот пример получает список резервных копий LTR для определенной базы данных из региона Azure в заданном управляемом экземпляре SQL.

# 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