Gestire la conservazione a lungo termine dell’Istanza gestita di SQL di Azure

Si applica a:Istanza gestita di SQL di Azure

• Database SQL di Azure
• Istanza gestita di database SQL di Azure

In Istanza gestita di SQL di Azure è possibile configurare una policy (LTR) secondo il criterio di conservazione dei backup a lungo termine. Questo consente di conservare automaticamente i backup del database in contenitori di Archiviazione BLOB di Azure separati per un massimo di 10 anni. È quindi possibile ripristinare un database usando questi backup tramite il portale di Azure o PowerShell.

Le seguenti sezioni illustrano come usare il portale di Azure, PowerShell e l'interfaccia della riga di comando di Azure per configurare la conservazione a lungo termine dei backup, visualizzare i backup nella risorsa di archiviazione di Azure SQL ed eseguire il ripristino da un backup nella risorsa di archiviazione di Azure SQL.

Prerequisiti

Portale

Una sottoscrizione di Azure attiva.

Interfaccia della riga di comando di Azure

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

• Usare l’ambiente Bash tramite Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.

  

• Se si preferisce, installare l'interfaccia della riga di comando di Azure per eseguire i relativi comandi di riferimento. 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 Accedere tramite l'interfaccia della riga di comando di Azure.

  • Quando richiesto, installare le estensioni dell'interfaccia della riga di comando di Azure al primo utilizzo. Per altre informazioni sulle estensioni, vedere Usare 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.

PowerShell

Preparare l’ambiente per PowerShell.

Nota

Questo articolo utilizza il modulo Az di PowerShell, che è ora il modulo di PowerShell consigliato per l'interazione con Azure. Per iniziare a usare il modulo Az PowerShell, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.

Importante

Il modulo Azure Resource Manager di PowerShell è ancora supportato da Database SQL di Azure, ma tutte le attività di sviluppo future sono incentrate sul modulo Az.Sql. Per informazioni su questi cmdlet, vedere AzureRM.Sql. Gli argomenti per i comandi nei moduli Az e AzureRm sono sostanzialmente identici.

Per Get-AzSqlInstanceDatabaseLongTermRetentionBackup e Restore-AzSqlInstanceDatabase, è necessario essere membri di uno dei ruoli seguenti:

• Proprietario della sottoscrizione
• Ruolo Collaboratore di Istanza gestita di SQL oppure
• Ruolo personalizzato con le autorizzazioni seguenti:
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

Per Remove-AzSqlInstanceDatabaseLongTermRetentionBackup, è necessario essere un membro di uno dei ruoli seguenti:

• Proprietario della sottoscrizione
• Ruolo personalizzato con l'autorizzazione seguente:
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

Autorizzazioni

Per visualizzare e ripristinare i backup con conservazione a lungo termine, è necessario essere membri dei ruoli seguenti:

• Proprietario della sottoscrizione
• Ruolo Collaboratore di Istanza gestita di SQL oppure
• Ruolo personalizzato con le autorizzazioni seguenti:
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

Per eliminare i backup con conservazione a lungo termine, è necessario essere membri di uno dei ruoli seguenti:

• Proprietario della sottoscrizione
• Ruolo personalizzato con l'autorizzazione seguente:
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

Nota

Il ruolo Collaboratore per Istanza gestita di SQL non ha l'autorizzazione per l'eliminazione di backup con conservazione a lungo termine.

È possibile concedere le autorizzazioni per il controllo degli accessi in base al ruolo in ambito di sottoscrizione o gruppo di risorse. Per accedere ai backup con conservazione a lungo termine appartenenti a un server eliminato, l'autorizzazione deve essere concessa nell'ambito della sottoscrizione di tale server.

• Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

Creare criteri di conservazione a lungo termine

È possibile configurare Istanza gestita di SQL per conservare i backup automatizzati per un periodo più lungo rispetto al periodo di conservazione associato al livello di servizio.

Portale

1. Nel portale di Azure selezionare l'istanza gestita e quindi Backup. Nella scheda Configura criteri selezionare il database in cui si vuole impostare o modificare i criteri di conservazione a lungo termine dei backup. Le modifiche non verranno applicate ad alcun database non selezionato.

   

2. Nel riquadro Configura criteri scegliere se si vuole conservare i backup per settimane, mesi o anni. Scegliere un periodo di conservazione "0" per indicare che non deve essere impostata alcuna conservazione dei backup a lungo termine.

   

3. Al termine, selezionare Applica.

Importante

Quando si Abilita un criterio di conservazione dei backup a lungo termine, potrebbe essere necessario attendere fino a 7 giorni prima che il primo backup diventi visibile e disponibile per il ripristino. Per informazioni dettagliate sulla frequenza dei backup LTR, vedere conservazione dei backup a lungo termine.

Interfaccia della riga di comando di Azure

1. Eseguire il comando az sql midb show per ottenere i dettagli per il database 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, 5 anni per il backup annuale e la settimana del 15 aprile in cui eseguire il backup di conservazione a lungo termine annuale.

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

PowerShell

# 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

Visualizzare i backup e ripristinare da backup

Portale

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

1. Nel portale di Azure selezionare l'istanza gestita e quindi 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 gestita di SQL 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 SQL di Azure.

   

4. Nella scheda Informazioni di base della pagina Crea database gestito di SQL di Azure, 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 corretta sia elencata nell'elenco a discesa. Selezionare quindi Avanti: Origine dati >

   

5. Nella scheda Origine dati scegliere Ripristino temporizzato in Usa dati esistenti. Specificare la sottoscrizione, il gruppo di risorse e l'istanza gestita che contiene il database di origine. Nell'elenco a discesa Database gestito scegliere il database da cui si vuole eseguire il ripristino e quindi scegliere 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 oppure, 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 Ora punto di ripristino.

Nota

A questo punto è possibile connettersi al database ripristinato usando SQL Server Management Studio per eseguire le attività necessarie, ad esempio per estrarre un bit di dati dal database ripristinato da copiare nel database esistente o per eliminare il database esistente e rinominare il database ripristinato con il nome del database esistente.

Interfaccia della riga di comando di Azure

Visualizzare i criteri di conservazione a lungo termine

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 con conservazione a lungo termine

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
   

Importante

Per eseguire il ripristino di un backup con conservazione a lungo termine dopo che l'istanza è stata eliminata, è necessario avere le autorizzazioni nell'ambito della sottoscrizione all'istanza e la sottoscrizione deve essere attiva.

Nota

A questo punto è possibile connettersi al database ripristinato usando SQL Server Management Studio per eseguire le attività necessarie, ad esempio per estrarre un bit di dati dal database ripristinato da copiare nel database esistente o per eliminare il database esistente e rinominare il database ripristinato con il nome del database esistente. Vedere ripristino temporizzato.

PowerShell

Visualizzare i criteri di conservazione a lungo termine

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 i criteri di conservazione a lungo termine

Questo esempio illustra come cancellare 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 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 

Eseguire il ripristino dai backup con conservazione a lungo termine

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 dell'ID risorsa richiede ora l'ID risorsa del backup con conservazione a lungo termine.

# 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

Importante

Per eseguire il ripristino di un backup con conservazione a lungo termine dopo che l'istanza è stata eliminata, è necessario avere le autorizzazioni nell'ambito della sottoscrizione all'istanza e la sottoscrizione deve essere attiva. È anche necessario omettere il parametro facoltativo -ResourceGroupName.

Nota

A questo punto è possibile connettersi al database ripristinato usando SQL Server Management Studio per eseguire le attività necessarie, ad esempio per estrarre un bit di dati dal database ripristinato da copiare nel database esistente o per eliminare il database esistente e rinominare il database ripristinato con il nome del database esistente. Vedere ripristino temporizzato.

Eliminare i backup con conservazione a lungo termine

Eliminare i backup conservati per un database specifico con criteri di conservazione a lungo termine.

Importante

L'eliminazione di un backup con conservazione a lungo termine non è reversibile. Per eliminare un backup con conservazione a lungo termine dopo che l'istanza è stata eliminata, è necessario avere l'autorizzazione nell'ambito della sottoscrizione. È possibile impostare le notifiche su ogni eliminazione in Monitoraggio di Azure filtrando in base all'operazione di 'eliminazione di un backup con conservazione a lungo termine'. Il log attività contiene informazioni su chi ha effettuato la richiesta e sul momento in cui è stata effettuata. Per istruzioni dettagliate, vedere Creare gli avvisi del log attività.

Portale

1. Nel portale di Azure, andare sull’Istanza gestita di SQL.
2. Selezionare Backup. Per visualizzare i backup di conservazione a lungo termine disponibili per un database specifico, selezionare Gestisci nella colonna Backup con conservazione a lungo termine disponibile. Viene visualizzato un riquadro con un elenco dei backup di conservazione a lungo termine disponibili per il database selezionato.
3. Nel riquadro Backup disponibili esaminare i backup disponibili. Selezionare un backup da eliminare. Selezionare Elimina.

Interfaccia della riga di comando di Azure

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 con conservazione a lungo termine.

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

PowerShell

Questo esempio illustra come eliminare il primo backup con conservazione a lungo termine dall'elenco di backup. Questo esempio ottiene l'elenco dei backup di conservazione a lungo termine per un database specifico dall'area di Azure nell'istanza gestita di 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

Passaggi successivi

• Per informazioni sui backup automatici generati dal servizio, vedere l'articolo relativo ai backup automatici
• Per altre informazioni sulla conservazione dei backup a lungo termine, vedere conservazione dei backup a lungo termine