Verwalten der langfristigen Sicherungsaufbewahrung für Azure SQL Managed Instance

Ein aktives Azure-Abonnement.

Bereiten Sie die Umgebung für die Azure CLI vor.

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

  • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

  • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.

  • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Bereiten Sie die Umgebung für PowerShell vor.

Für Get-AzSqlInstanceDatabaseLongTermRetentionBackup und Restore-AzSqlInstanceDatabase, müssen Sie Mitglied einer der folgenden Rollen sein:

• Rolle „Besitzer des Abonnements“ oder
• Rolle „Mitwirkender“ für SQL Managed Instance oder
• Benutzerdefinierte Rolle mit den folgenden Berechtigungen:
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

Für Remove-AzSqlInstanceDatabaseLongTermRetentionBackup, müssen Sie Mitglied einer der folgenden Rollen sein:

• Rolle „Besitzer des Abonnements“ oder
• Benutzerdefinierte Rolle mit der folgenden Berechtigung:
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

1. Wählen Sie im Azure-Portal Ihre verwaltete Instanz aus, und wählen Sie dann Sicherungen. Wählen Sie auf der Registerkarte Aufbewahrungsrichtlinien die Datenbank(en) aus, für die Sie Richtlinien für die langfristige Sicherungsaufbewahrung festlegen oder ändern möchten. Änderungen gelten nicht für Datenbanken, die nicht ausgewählt wurden.

   

2. Geben Sie im Bereich Richtlinien konfigurieren den gewünschten Aufbewahrungszeitraum für wöchentliche, monatliche oder jährliche Sicherungen an. Wählen Sie den Aufbewahrungszeitraum „0“ aus, um anzugeben, dass keine Langzeitaufbewahrung von Sicherungen festgelegt werden soll.

   

3. Wählen Sie Anwenden aus, wenn Sie fertig sind.

1. Führen Sie den Befehl az sql midb show aus, um Details zur SQL Managed Instance-Datenbank zu erhalten.

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

2. Führen Sie den Befehl az sql midb ltr-policy set aus, um eine LTR-Richtlinie zu erstellen. Im folgenden Beispiel wird eine Richtlinie für die Langzeitaufbewahrung für die wöchentliche Sicherung über 12 Wochen definiert.

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

   In diesem Beispiel wird eine Aufbewahrungsrichtlinie für 12 Wochen für die wöchentliche Sicherung, für 5 Jahre für die jährliche Sicherung und für die Woche ab dem 15. April erstellt, in der die jährliche LTR-Sicherung erstellt werden soll.

   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ühren Sie die folgenden Schritte aus, um verfügbare langfristige Sicherungen aus dem Azure-Portal anzuzeigen:

1. Wählen Sie im Azure-Portal Ihre verwaltete Instanz aus, und wählen Sie dann Sicherungen. Wählen Sie auf der Registerkarte Verfügbare Sicherungen die Datenbank aus, für die Sie verfügbare Sicherungen anzeigen möchten. Wählen Sie Verwalten aus.

   

2. Überprüfen Sie im Bereich Sicherungen verwalten die verfügbaren Sicherungen.

   

Sie können auch eine Wiederherstellung auf dieser Seite durchführen, indem Sie die Sicherung wählen und Wiederherstellen auswählen.

Alternativ können Sie die folgenden Schritte auswählen, um eine Sicherung aus der langfristigen Aufbewahrung mithilfe des Azure-Portals wiederherzustellen:

1. Melden Sie sich beim Azure-Portal an.

2. Wechseln Sie zu dem Ziel „SQL Managed Instance“, in dem Sie ihre Datenbank wiederherstellen möchten.

3. Wählen Sie auf der Seite Übersicht die Option + Neue Datenbank, um die Seite Azure SQL verwaltete Datenbank erstellen zu öffnen.

   

4. Geben Sie auf der Registerkarte Grundlagen der Seite Azure SQL verwaltete Datenbank erstellen unter Projektdetails die Details zum Abonnement und zur Ressourcengruppe an. Geben Sie dann unter Datenbankdetails den neuen Namen der Datenbank an, die Sie wiederherstellen möchten. Vergewissern Sie sich, dass die richtige verwaltete Instanz in der Dropdownliste aufgeführt ist. Wählen Sie dann Weiter: Datenquelle> aus.

   

5. Wählen Sie auf der Registerkarte Datenquelle unter Vorhandene Daten verwenden die Option Point-in-Time-Wiederherstellung aus. Geben Sie das Abonnement, die Ressourcengruppe und die verwaltete Instanz an, die die Quelldatenbank enthält. Wählen Sie in der Dropdownliste Verwaltete Datenbank die Datenbank aus, die Sie wiederherstellen möchten, und wählen Sie dann den Zeitpunkt aus, an dem Sie die Datenbank wiederherstellen möchten. Die Quell- und Zielinstanz können identisch oder zwei verschiedene Instanzen sein. Wählen Sie Weiter: Zusätzliche Einstellungen>aus.

   

6. Auf der Registerkarte Zusätzliche Einstellungen können Sie das Kontrollkästchen aktivieren, um die Aufbewahrungsrichtlinie aus der Quelldatenbank zu erben, oder alternativ können Sie Aufbewahrung konfigurieren auswählen, um die Seite Richtlinien konfigurieren zu öffnen und die gewünschten Aufbewahrungsrichtlinien für Ihre wiederhergestellte Datenbank festzulegen. Wenn Sie fertig sind, wählen Sie Überprüfen und erstellen aus.

   

7. Wählen Sie unter Überprüfen + erstellen die Option Erstellen aus, um Ihre Datenbank wiederherzustellen, wenn die Überprüfung erfolgreich ist.

Daraufhin wird der Wiederherstellungsprozess gestartet. Hierbei wird eine neue Datenbank erstellt und mit Daten aus der ursprünglichen Datenbank zum angegebenen Zeitpunkt aufgefüllt. Weitere Informationen zum Wiederherstellungsprozess finden Sie unter Wiederherstellungszeit.

Anzeigen von LTR-Richtlinien

Führen Sie den Befehl az sql midb ltr-policy show aus, um die LTR-Richtlinie für eine einzelne Datenbank innerhalb einer Instanz anzuzeigen.

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

Anzeigen von LTR-Sicherungen

Führen Sie den Befehl az sql midb ltr-backup list aus, um die LTR-Sicherungen innerhalb einer Instanz anzuzeigen.

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

Wiederherstellen von LTR-Sicherungen

Führen Sie den Befehl az sql midb ltr-backup restore aus, um Ihre Datenbank aus einer LTR-Sicherung wiederherzustellen. Sie können den Befehl az sql midb ltr-backup show ausführen, um die backup-id abzurufen.

1. Erstellen Sie mit dem Befehl az sql db ltr-backup show eine Variable für die backup-id zur zukünftigen Verwendung.

    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. Wiederherstellen der Datenbank aus einer LTR-Sicherung

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

Anzeigen von LTR-Richtlinien

In diesem Beispiel wird gezeigt, wie Sie die LTR-Richtlinien in einer Instanz für eine Einzeldatenbank auflisten.

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

In diesem Beispiel wird gezeigt, wie Sie die LTR-Richtlinien für alle Datenbanken in einer Instanz auflisten.

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

Löschen einer LTR-Richtlinie

In diesem Beispiel wird gezeigt, wie Sie eine LTR-Richtlinie aus einer Datenbank löschen.

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

Anzeigen von LTR-Sicherungen

In diesem Beispiel wird gezeigt, wie Sie die LTR-Sicherungen in einer Instanz auflisten.

$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 

Wiederherstellen von LTR-Sicherungen

Dieses Beispiel zeigt, wie Sie eine LTR-Sicherung wiederherstellen. Beachten Sie, dass sich diese Schnittstelle nicht geändert hat, der Parameter für die Ressourcen-ID jetzt jedoch die Ressourcen-ID der LTR-Sicherung erfordert.

# 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. Navigieren Sie im Azure-Portal zur SQL Managed Instance.
2. Wählen Sie Sicherungen aus. Um die verfügbaren LTR-Sicherungen für eine bestimmte Datenbank anzuzeigen, wählen Sie in der Spalte „Verfügbare LTR-Sicherungen“ die Option Verwalten aus. Ein Bereich mit einer Liste der verfügbaren LTR-Sicherungen für die ausgewählte Datenbank wird angezeigt.
3. Überprüfen Sie im Bereich Verfügbare LTR-Sicherungen die verfügbaren Sicherungen. Wählen Sie eine zu löschende Sicherung aus. Klicken Sie auf Löschen.

1. Führen Sie den Befehl az sql midb ltr-backup list aus, um die Sicherung name abzurufen.

2. Führen Sie den Befehl az sql midb ltr-backup delete aus, um eine LTR-Sicherung zu entfernen.

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

Dieses Beispiel zeigt, wie die früheste LTR-Sicherung aus der Liste der Sicherungen gelöscht wird. Dieses Beispiel ruft die Liste der LTR-Sicherungen für eine bestimmte Datenbank aus der Azure-Region unter der angegebenen SQL Managed Instance-Instanz ab.

# 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