Gestire la conservazione a lungo termine dei backup dell'Istanza gestita di SQL di Azure

Una sottoscrizione di Azure attiva.

Preparare l'ambiente per interfaccia della riga di comando di Azure.

• Utilizzare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Introduzione ad Azure Cloud Shell.

  

• Se si preferisce eseguire localmente i comandi della CLI di riferimento, installare la CLI di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Eseguire l'autenticazione ad Azure con l'interfaccia della riga di comando di Azure.

  • Quando richiesto, al primo utilizzo installare l'estensione di interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare e gestire le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Prepara il tuo ambiente per PowerShell.

1. Nel portale di Azure selezionare l'istanza gestita di SQL e quindi selezionare Backup. Nella scheda Criteri di conservazione selezionare i database per i quali si desidera impostare o modificare i criteri di conservazione dei backup a lungo termine. Le modifiche non verranno applicate ad alcun database non selezionato.

   

2. Nel riquadro Configura criteri, specificare il periodo di conservazione desiderato per i backup settimanali, mensili o annuali. Scegliere un periodo di conservazione pari a "0" per indicare che non dev'essere impostata alcuna conservazione dei backup a lungo termine.

   

3. Al termine, selezionare Applica.

1. Esegui il comando az sql midb show per ottenere i dettagli del database dell'Istanza gestita di SQL.

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

2. Eseguire il comando az sql midb ltr-policy set per creare un criterio di conservazione a lungo termine. Nell'esempio seguente viene impostato un criterio di conservazione a lungo termine per 12 settimane per il backup settimanale.

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

   In questo esempio vengono impostati criteri di conservazione per 12 settimane per il backup settimanale, cinque anni per il backup annuale, e per la settimana che include il 15 aprile in cui eseguire il backup annuale 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 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

Per visualizzare i backup a lungo termine disponibili dal portale di Azure, seguire questa procedura:

1. Nel portale di Azure selezionare l'istanza gestita di SQL e quindi selezionare Backup. Nella scheda Available backups (Backup disponibili) selezionare il database per cui si vuole visualizzare i backup disponibili. Seleziona Gestisci.

   

2. Nel riquadro Gestisci Backup esaminare i backup disponibili.

   

È anche possibile eseguire il ripristino da questa pagina scegliendo il backup e selezionando Ripristina.

In alternativa, per ripristinare un backup dalla conservazione a lungo termine usando il portale di Azure, seguire questa procedura:

1. Accedere al portale di Azure.

2. Passare all'Istanza SQL gestita di destinazione in cui si prevede di ripristinare il database.

3. Nella pagina Panoramica scegliere + Nuovo database per aprire la pagina Crea database gestito di Azure SQL.

   

4. Nella scheda Informazioni di base della pagina Crea database gestito di Azure SQL, specificare i dettagli della sottoscrizione e del gruppo di risorse in Dettagli progetto. Quindi, in Dettagli database specificare il nuovo nome del database che si intende ripristinare. Verificare che l'istanza gestita di SQL corretta sia elencata nell'elenco a discesa. Selezionare quindi Avanti: Fonte dati >.

   

5. Nella scheda Origine dati scegliere Ripristino temporizzato in Usa dati esistenti. Specificare la sottoscrizione, il gruppo di risorse e l'istanza gestita di SQL che contiene il database di origine. Nell'elenco a discesa Database gestito scegliere il database da ripristinare. Scegliere quindi il punto nel tempo da cui si vuole ripristinare il database. L'istanza di origine e di destinazione può essere la stessa o due istanze diverse. Selezionare Avanti: Impostazioni >aggiuntive.

   

6. Nella scheda Impostazioni aggiuntive è possibile selezionare la casella per ereditare i criteri di conservazione dal database di origine. In alternativa, è possibile selezionare Configura conservazione per aprire la pagina Configura criteri e impostare i criteri di conservazione desiderati per il database ripristinato. Al termine, selezionare Rivedi e crea.

   

7. Nella scheda Rivedi e crea, al termine della convalida, selezionare Crea per ripristinare il database.

Questa azione avvia il processo di ripristino, che crea un nuovo database e lo popola con i dati del database originale al momento specificato. Per altre informazioni sul processo di recupero, vedere Tempo di recupero.

Visualizza le politiche LTR

Eseguire il comando az sql midb ltr-policy show per visualizzare i criteri di conservazione a lungo termine per un singolo database all'interno di un'istanza.

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

Visualizzare i backup con conservazione a lungo termine

Usare il comando az sql midb ltr-backup list per visualizzare i backup di conservazione a lungo termine all'interno di un'istanza.

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

Eseguire il ripristino dai backup LTR

Eseguire il comando az sql midb ltr-backup restore per ripristinare il database da un backup con conservazione a lungo termine. È possibile eseguire az sql midb ltr-backup show per ottenere backup-id.

1. Creare una variabile per backup-id con il comando az sql db ltr-backup show per un uso futuro.

    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. Ripristinare il database da un backup con conservazione a lungo termine

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

Visualizza le politiche LTR

Questo esempio illustra come elencare i criteri di conservazione a lungo termine all’interno di un’istanza per un database singolo.

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

Questo esempio illustra come elencare i criteri di conservazione a lungo termine per tutti i database in un’istanza.

# 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
 }

Cancellare una politica LTR

Questo esempio illustra come rimuovere i criteri di conservazione a lungo termine da un database.

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

Visualizzare i backup con conservazione a lungo termine

Questo esempio illustra come elencare i backup con conservazione a lungo termine in un'istanza.

$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

Eseguire il ripristino dai backup LTR

Questo esempio illustra come eseguire il ripristino da un backup con conservazione a lungo termine. Si noti che questa interfaccia non è stata modificata, ma il parametro ID risorsa ora richiede l'ID risorsa di backup 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. Nel portale di Azure, andare sull’Istanza gestita di SQL.
2. Selezionare Backup. Per visualizzare i backup con conservazione a lungo termine disponibili per un database specifico, selezionare Gestisci nella colonna Backup con conservazione a lungo termine disponibili. Viene visualizzato un riquadro con un elenco dei backup con conservazione a lungo termine disponibili per il database selezionato.
3. Nel pannello Backup con conservazione a lungo termine disponibili visualizzato, verifica i backup disponibili. Selezionare un backup da eliminare. Selezionare Elimina.

1. Eseguire az sql midb ltr-backup list per ottenere il backup name.

2. Eseguire il comando az sql midb ltr-backup delete per rimuovere un backup LTR.

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

Questo esempio illustra come eliminare il backup LTR più vecchio dall'elenco di backup. Questo esempio ottiene l'elenco dei backup a lungo termine (LTR) per un database specifico dall'area di Azure sotto l'istanza gestita SQL specificata.

# 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