Hantera långsiktig kvarhållning av säkerhetskopior i Azure SQL Managed Instance

gäller för:Azure SQL Managed Instance

• Azure SQL Database
• Azure SQL Managed Instance

I Azure SQL Managed Instance kan du konfigurera en långsiktig säkerhetskopieringspolicy (LTR). På så sätt kan du automatiskt behålla databassäkerhetskopior i separata Azure Blob Storage-containrar i upp till 10 år. Du kan sedan återställa en databas med hjälp av dessa säkerhetskopior med Azure-portalen, Azure CLI och PowerShell.

Följande avsnitt visar hur du använder Azure-portalen, PowerShell och Azure CLI för att konfigurera långsiktig kvarhållning av säkerhetskopior, visa säkerhetskopior i Azure SQL Storage och återställa från en säkerhetskopia i Azure SQL Storage.

Förutsättningar

Portal

En aktiv Azure-prenumeration.

Azure CLI

Förbered din miljö för Azure CLI.

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i snabbstart för Bash i Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installera Azure CLI. Om du kör i Windows eller macOS kan du överväga att köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI-.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI-.

  • Kör az version för att hitta den version och de beroendebibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

PowerShell

Förbered din miljö för PowerShell.

Anteckning

Den här artikeln använder Azure Az PowerShell-modulen, som är den rekommenderade PowerShell-modulen för interaktion med Azure. Information om hur du kommer igång med Az PowerShell-modulen finns i Installera Azure PowerShell. Information om hur du migrerar till Az PowerShell-modulen finns i Migrera Azure PowerShell från AzureRM till Az.

Viktig

Azure Resource Manager-modulen för PowerShell (AzureRM) blev föråldrad den 29 februari 2024. All framtida utveckling bör använda Az.Sql-modulen. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar. AzureRM-modulen underhålls inte längre eller stöds inte längre. Argumenten för kommandona i Az PowerShell-modulen och i AzureRM-modulerna är i stort sätt identiska. Mer information om deras kompatibilitet finns i Introduktion till den nya Az PowerShell-modulen.

För Get-AzSqlInstanceDatabaseLongTermRetentionBackup och Restore-AzSqlInstanceDatabasemåste du vara medlem i någon av följande roller:

• Rollen prenumerationsägare eller
• SQL Managed Instance-deltagarroll eller
• Anpassad roll med följande behörigheter:
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

För Remove-AzSqlInstanceDatabaseLongTermRetentionBackupmåste du vara medlem i någon av följande roller:

• Rollen prenumerationsägare eller
• Anpassad roll med följande behörighet:
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

Behörigheter

Om du vill visa och återställa LTR-säkerhetskopior måste du vara medlem i följande roller:

• Prenumerationsägare-rollen eller
• SQL Managed Instance-deltagarrollen eller
• Anpassad roll med följande behörigheter:
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

Om du vill ta bort LTR-säkerhetskopior måste du vara medlem i någon av följande roller:

• rollen som prenumerationsägare eller
• Anpassad roll med följande behörighet:
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

Notera

Rollen SQL Managed Instance Medverkare har inte behörighet att ta bort LTR-säkerhetskopior.

Behörigheter för rollbaserad åtkomstkontroll i Azure kan beviljas på antingen prenumerationsnivå eller resursgruppsnivå . För att få åtkomst till LTR-säkerhetskopior som tillhör en borttagen instans måste behörigheten dock beviljas i -prenumerationen omfånget för den instansen.

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

Skapa långsiktiga kvarhållningsprinciper

Du kan konfigurera SQL Managed Instance för att behålla automatiserade säkerhetskopieringar under en period som är längre än kvarhållningsperioden för tjänstnivån.

Portal

1. I Azure-portalen väljer du din hanterade instans och väljer sedan Säkerhetskopieringar. På fliken Kvarhållningsprinciper väljer du de databaser som du vill ange eller ändra principer för långsiktig kvarhållning av säkerhetskopior på. Ändringar gäller inte för databaser som lämnas omarkerade.

   

2. I fönstret Konfigurera principer anger du önskad kvarhållningsperiod för veckovisa, månatliga eller årliga säkerhetskopieringar. Välj kvarhållningsperioden "0" för att ange att ingen långsiktig kvarhållning av säkerhetskopior ska anges.

   

3. När du är klar, välj Använd.

Viktig

När du aktiverar en princip för långsiktig kvarhållning av säkerhetskopior kan det ta upp till 7 dagar innan den första säkerhetskopieringen blir synlig och tillgänglig för återställning. För information om säkerhetskopieringsfrekvensen av LTR, se långtidsbevarande av säkerhetskopior.

Azure CLI

1. Kör kommandot az sql midb show för att hämta information om SQL Managed Instance-databasen.

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

2. Kör kommandot az sql midb ltr-policy set för att skapa en LTR-princip. I följande exempel anges en långsiktig kvarhållningsprincip i 12 veckor för den veckovisa säkerhetskopieringen.

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

   I det här exemplet anges en kvarhållningsprincip i 12 veckor för den veckovisa säkerhetskopieringen, 5 år för den årliga säkerhetskopieringen och veckan den 15 april där den årliga LTR-säkerhetskopieringen ska utföras.

   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

Visa säkerhetskopior och återställning från en säkerhetskopia

Portal

Följ dessa steg om du vill visa tillgängliga långsiktiga säkerhetskopior från Azure-portalen:

1. I Azure-portalen väljer du din hanterade instans och väljer sedan Säkerhetskopieringar. På fliken Tillgängliga säkerhetskopior väljer du den databas som du vill se tillgängliga säkerhetskopior för. Välj Hantera.

   

2. Granska de tillgängliga säkerhetskopiorna i fönstret Hantera säkerhetskopior.

   

Du kan också återställa från den här sidan genom att välja säkerhetskopian och välja Återställ.

Du kan också återställa en säkerhetskopia från långsiktig kvarhållning med hjälp av Azure-portalen genom att följa dessa steg:

1. Logga in på Azure-portalen.

2. Gå till målinstansen för SQL Managed Instance som du planerar att återställa din databas till.

3. På sidan Översikt väljer du + Ny databas för att öppna sidan Skapa Azure SQL Managed Database.

   

4. På fliken Grundläggande på sidan Skapa Azure SQL Managed Databaseanger du prenumerations- och resursgruppsinformation under Project-information. Under databasinformation ange det nya namnet på databasen som du planerar att återställa. Bekräfta att rätt hanterad instans visas i listrutan. Välj sedan Nästa: Datakälla >

   

5. På fliken Datakälla väljer du återställning till tidpunkt under Använd befintliga data. Ange den prenumeration, resursgrupp och hanterade instans som innehåller källdatabasen. I listrutan Hanterad databas väljer du den databas som du vill återställa och väljer sedan den tidpunkt då du vill återställa databasen. Käll- och målinstansen kan vara samma eller två olika instanser. Välj Nästa: Ytterligare inställningar >

   

6. På fliken Ytterligare inställningar kan du markera kryssrutan för att ärva kvarhållningsprincipen från källdatabasen, eller så kan du välja Konfigurera kvarhållning för att öppna sidan Konfigurera principer och ange önskade kvarhållningsprinciper för den återställda databasen. När du är klar väljer du knappen Granska + skapa.

   

7. På Granska + skapaväljer du Skapa för att återställa databasen när verifieringen har slutförts.

Den här åtgärden startar återställningsprocessen, som skapar en ny databas och fyller den med data från den ursprungliga databasen vid den angivna tidpunkten. Mer information om återställningsprocessen finns i Återställningstid.

Anteckning

Härifrån kan du ansluta till den återställde databasen med HJÄLP av SQL Server Management Studio för att utföra nödvändiga uppgifter, till exempel att extrahera lite data från den återställde databasen för att kopiera till den befintliga databasen eller ta bort den befintliga databasen och byta namn på den återställde databasen till det befintliga databasnamnet.

Azure CLI

Visa LTR-principer

Kör kommandot az sql midb ltr-policy show för att visa LTR-principen för en enskild databas i en instans.

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

Visa LTR-säkerhetskopior

Använd kommandot az sql midb ltr-backup list för att se LTR-säkerhetskopiorna i en instans.

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

Återställa från LTR-säkerhetskopior

Kör kommandot az sql midb ltr-backup för att återställa databasen från en LTR-säkerhetskopia. Du kan köra az sql midb ltr-backup show för att hämta backup-id.

1. Skapa en variabel för backup-id med kommandot az sql db ltr-backup show för framtida användning.

    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. Återställa databasen från en LTR-säkerhetskopia

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

Viktig

Om du vill återställa från en LTR-säkerhetskopia efter att instansen har tagits bort måste du ha behörigheter som är begränsade till instansens prenumeration och den prenumerationen måste vara aktiv.

Notera

Härifrån kan du ansluta till den återställde databasen med HJÄLP av SQL Server Management Studio för att utföra nödvändiga uppgifter, till exempel att extrahera lite data från den återställde databasen för att kopiera till den befintliga databasen eller ta bort den befintliga databasen och byta namn på den återställde databasen till det befintliga databasnamnet. Se återställning till tidpunkt.

PowerShell

Visa LTR-principer

Det här exemplet visar hur du listar LTR-principerna i en instans för en enskild databas.

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

Det här exemplet visar hur du listar LTR-principerna för alla databaser i en instans.

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

Rensa en LTR-policy

Det här exemplet visar hur du rensar en LTR-princip från en databas.

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

Visa LTR-säkerhetskopior

Det här exemplet visar hur du visar en lista över LTR-säkerhetskopior i en instans.

$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 

Återställa från LTR-säkerhetskopior

Det här exemplet visar hur du återställer från en LTR-säkerhetskopia. Observera att det här gränssnittet inte ändrades, men resurs-ID-parametern kräver nu RESURS-ID för LTR-säkerhetskopiering.

# 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

Viktig

Om du vill återställa från en LTR-säkerhetskopia efter att instansen har tagits bort måste du ha behörigheter som är begränsade till instansens prenumeration och den prenumerationen måste vara aktiv. Du måste också utelämna den valfria parametern -ResourceGroupName.

Notera

Härifrån kan du ansluta till den återställde databasen med HJÄLP av SQL Server Management Studio för att utföra nödvändiga uppgifter, till exempel att extrahera lite data från den återställde databasen för att kopiera till den befintliga databasen eller ta bort den befintliga databasen och byta namn på den återställde databasen till det befintliga databasnamnet. Se återställning till viss tidpunkt vid .

Ta bort LTR-säkerhetskopior

Ta bort säkerhetskopior som behålls för en specifik databas med en LTR-princip.

Viktig

Att ta bort LTR-säkerhetskopieringen är oåterkalleligt. Om du vill ta bort en LTR-säkerhetskopia efter att instansen har tagits bort måste du ha behörighet för prenumerationsomfång. Du kan konfigurera meddelanden om varje borttagning i Azure Monitor genom att filtrera efter åtgärden "Tar bort en långsiktig kvarhållningssäkerhetskopia". Aktivitetsloggen innehåller information om vem och när begäran gjordes. Mer information finns i Skapa aktivitetsloggaviseringar.

Portal

1. I Azure-portalen navigerar du till den SQL-hanterade instansen.
2. Välj Säkerhetskopieringar. Om du vill visa tillgängliga LTR-säkerhetskopior för en specifik databas väljer du Hantera under kolumnen Tillgängliga LTR-säkerhetskopieringar. Ett fönster visas med en lista över tillgängliga LTR-säkerhetskopior för den valda databasen.
3. Granska de tillgängliga säkerhetskopiorna i fönstret Tillgängliga LTR-säkerhetskopieringar som visas. Välj en säkerhetskopia att ta bort. Välj Ta bort.

Azure CLI

1. Kör az sql midb ltr-backup list för att hämta säkerhetskopian name.

2. Kör kommandot az sql midb ltr-backup delete för att ta bort en LTR-säkerhetskopia.

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

PowerShell

Det här exemplet visar hur du tar bort den tidigaste LTR-säkerhetskopieringen från listan över säkerhetskopior. Det här exemplet hämtar listan över LTR-säkerhetskopior för en specifik databas från Azure-regionen under den angivna SQL-hanterade instansen.

# 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

Begränsningar

Databassäkerhetskopior från instanser som konfigurerats med SQL Server 2022 uppdateringsprincip kan återställas till instanser som konfigurerats med antingen SQL Server 2022- eller Always-up-to-date update-principen. Databassäkerhetskopior som hämtats från instanser som konfigurerats med uppdateringsprincipen Always-up-to-date kan bara återställas till instanser som också har konfigurerats med uppdateringsprincipen Always-up-to-date.

Nästa steg

• Mer information om tjänstgenererade automatiska säkerhetskopieringar finns i automatiska säkerhetskopieringar.
• Mer information om långsiktig kvarhållning av säkerhetskopior finns i långsiktig kvarhållning av säkerhetskopior.