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

En aktiv Azure-prenumeration.

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 installerar du Azure CLI. Om du kör i Windows eller macOS kan du 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 om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Förbered din miljö för PowerShell.

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

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 säkerhetskopieringar varje vecka, månad eller år. 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äljer du Använd.

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
   

# 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

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 sql-målhanterad instans där du planerar att återställa databasen till.

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

   

4. På fliken Grundinställningar på sidan Skapa Azure SQL Managed Database anger du prenumerations- och resursgruppsinformation under Projektinformation. Under Databasinformation anger du sedan det nya namnet på den databas 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 från. 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 Granska + skapa.

   

7. När verifieringen lyckas i Granska och skapa väljer du Skapa för att återställa databasen.

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.

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 visa 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 restore 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
   

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-princip

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

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äkerhetskopior . Ett fönster visas med en lista över tillgängliga LTR-säkerhetskopior för den valda databasen.
3. I fönstret Tillgängliga LTR-säkerhetskopior som visas granskar du de tillgängliga säkerhetskopiorna. Välj en säkerhetskopia att ta bort. Välj Ta bort.

1. Kör az sql midb ltr-backup list för att hämta säkerhetskopieringen 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"
   

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