Langetermijnretentie van back-ups van Azure SQL Managed Instance beheren

Een actieve Azure-abonnement.

Bereid uw omgeving voor op de Azure CLI.

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container uit te voeren. Voor meer informatie, zie Hoe u de Azure CLI in een Docker-container kunt uitvoeren.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met de opdracht az login. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

Bereid uw omgeving voor op PowerShell.

1. Selecteer uw SQL-beheerde instantie in de Azure-portal en selecteer vervolgens Back-ups. Selecteer op het tabblad Bewaarbeleid de databases waarvoor u langetermijnretentiebeleid voor back-ups wilt instellen of wijzigen. Wijzigingen zijn niet van toepassing op databases die niet zijn geselecteerd.

   

2. Geef in het deelvenster Beleid configureren de gewenste bewaarperiode op voor wekelijkse, maandelijkse of jaarlijkse back-ups. Kies een bewaarperiode van '0' om aan te geven dat er geen langetermijnretentie van back-ups moet worden ingesteld.

   

3. Wanneer u klaar bent, selecteert u Toepassen.

1. Voer de opdracht az sql midb show uit om de details voor de SQL Managed Instance-database op te halen.

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

2. Voer de opdracht az sql midb ltr-policy set uit om een LTR-beleid te maken. In het volgende voorbeeld wordt een langetermijnretentiebeleid ingesteld voor 12 weken voor de wekelijkse back-up.

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

   In dit voorbeeld wordt een bewaarbeleid ingesteld voor 12 weken voor de wekelijkse back-up, vijf jaar voor de jaarlijkse back-up en de week van 15 april waarin de jaarlijkse LTR-back-up moet worden uitgevoerd.

   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

Als u beschikbare langetermijnback-ups wilt weergeven vanuit Azure Portal, voert u de volgende stappen uit:

1. Selecteer uw met SQL beheerde exemplaar in Azure Portal en selecteer vervolgens Back-ups. Selecteer op het tabblad Beschikbare back-ups de database waarvoor u beschikbare back-ups wilt zien. Selecteer Beheren.

   

2. Controleer in het deelvenster Back-ups beheren de beschikbare back-ups.

   

U kunt ook via deze pagina herstellen door de back-up te kiezen en Herstellen te selecteren.

Als u een back-up wilt herstellen vanuit langetermijnretentie met behulp van Azure Portal, voert u de volgende stappen uit:

1. Meld u aan bij het Azure-portaal.

2. Ga naar het doel-SQL Managed Instance waarnaar u de database wilt herstellen.

3. Kies + Nieuwe database op de pagina Overzicht om de pagina Azure SQL Managed Database maken te openen.

   

4. Geef op het tabblad Basisbeginselen van de pagina Azure SQL Managed Database maken abonnements- en resourcegroepgegevens op onder Projectdetails. Geef vervolgens onder Databasegegevens de nieuwe naam op van de database die u wilt herstellen. Controleer of het juiste met SQL beheerde exemplaar wordt vermeld in de vervolgkeuzelijst. Selecteer vervolgens Volgende: Gegevensbron >.

   

5. Kies op het tabblad Gegevensbron de optie Herstel naar een bepaald tijdstip onder Bestaande gegevens gebruiken. Geef het abonnement, de resourcegroep en het beheerde SQL-exemplaar op dat de brondatabase bevat. Kies in de vervolgkeuzelijst Beheerde database de database die u wilt herstellen. Kies vervolgens het tijdstip waaruit u de database wilt herstellen. Het bron- en doelexemplaar kan hetzelfde of twee verschillende exemplaren zijn. Selecteer Volgende: Aanvullende instellingen >.

   

6. Op het tabblad Aanvullende instellingen kunt u het selectievakje inschakelen om het bewaarbeleid van de brondatabase over te nemen. U kunt ook Retentie configureren selecteren om de pagina Beleid configureren te openen en uw gewenste bewaarbeleid voor uw herstelde database instellen. Wanneer u klaar bent, selecteert u Beoordelen en maken.

   

7. Wanneer de validatie is geslaagd, selecteert u Bij Controleren en maken de optie Maken om uw database te herstellen.

Met deze actie wordt het herstelproces gestart, waarmee een nieuwe database wordt gemaakt en gevuld met gegevens uit de oorspronkelijke database op het opgegeven tijdstip. Zie Hersteltijd voor meer informatie over het herstelproces.

LTR-beleid weergeven

Voer de opdracht az sql midb ltr-policy show uit om het LTR-beleid voor één database binnen een exemplaar weer te geven.

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

LTR-back-ups weergeven

Gebruik de opdracht az sql midb ltr-backup list om de LTR-back-ups binnen een exemplaar weer te geven.

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

Herstellen vanuit LTR-back-ups

Voer de opdracht az sql midb ltr-backup restore uit om uw database te herstellen vanuit een LTR-back-up. U kunt az sql midb ltr-backup show uitvoeren om de backup-id.

1. Maak een variabele voor de backup-id met de opdracht az sql db ltr-backup show voor toekomstig gebruik.

    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. Uw database herstellen vanuit een LTR-back-up

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

LTR-beleid weergeven

In dit voorbeeld ziet u hoe u het LTR-beleid in een exemplaar voor één database weergeeft.

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

In dit voorbeeld ziet u hoe u het LTR-beleid voor alle databases op een exemplaar weergeeft.

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

Een LTR-beleid opruimen

In dit voorbeeld ziet u hoe u een LTR-beleid uit een database wist.

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

LTR-back-ups weergeven

In dit voorbeeld laat zien hoe u de LTR-back-ups binnen een instantie weergeeft.

$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

Herstellen vanuit LTR-back-ups

In dit voorbeeld ziet u hoe u herstelt vanuit een LTR-back-up. Merk op dat deze interface niet is gewijzigd, maar de parameter resource-ID nu de resource-ID van een LTR-reservekopie vereist.

# 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. Navigeer in Azure Portal naar het beheerde SQL-exemplaar.
2. Selecteer Back-ups. Als u de beschikbare LTR-back-ups voor een specifieke database wilt weergeven, selecteert u Beheren onder de kolom Beschikbare LTR-back-ups . Er wordt een deelvenster weergegeven met een lijst met de beschikbare LTR-back-ups voor de geselecteerde database.
3. Controleer in het deelvenster Beschikbare LTR-back-ups dat wordt weergegeven de beschikbare back-ups. Selecteer een back-up die u wilt verwijderen. Selecteer Verwijderen.

1. Voer az sql midb ltr-backup list uit om de back-upnameop te halen.

2. Voer de opdracht az sql midb ltr-backup delete uit om een LTR-back-up te verwijderen.

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

In dit voorbeeld ziet u hoe u de vroegste LTR-back-up verwijdert uit de lijst met back-ups. In dit voorbeeld wordt de lijst met LTR-back-ups voor een specifieke database opgehaald uit de Azure-regio binnen het opgegeven SQL-beheerde exemplaar.

# 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