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 "Erste Schritte mit 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. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe 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 und Verwalten 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.

1. Wählen Sie im Azure-Portal Ihre verwaltete SQL-Instanz und dann Sicherungen aus. Wählen Sie auf der Registerkarte "Aufbewahrungsrichtlinien " die Datenbanken aus, für die Sie aufbewahrungsrichtlinien für langfristige Sicherungen festlegen oder ändern möchten. Änderungen gelten nicht für nicht ausgewählte Datenbanken.

   

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ünf Jahre für die jährliche Sicherung und die Woche vom 15. April festgelegt, in der die jährliche LTR-Sicherung verwendet 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 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

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 SQL-Instanz und dann Sicherungen aus. 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 SQL-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. Stellen Sie das Abonnement, die Ressourcengruppe und die verwaltete SQL-Instanz bereit, die die Quelldatenbank enthält. Wählen Sie in der Dropdownliste "Verwaltete Datenbank " die Datenbank aus, die Sie wiederherstellen möchten. Wählen Sie dann den Zeitpunkt aus, an dem Sie die Datenbank wiederherstellen möchten. Die Quell- und Zielinstanz kann die gleiche oder zwei verschiedene Instanzen sein. Wählen Sie "Weiter" aus: Zusätzliche Einstellungen >.

   

6. Auf der Registerkarte "Zusätzliche Einstellungen " können Sie das Kontrollkästchen aktivieren, um die Aufbewahrungsrichtlinie von der Quelldatenbank zu erben. Alternativ können Sie " Aufbewahrung konfigurieren" auswählen, um die Seite " Richtlinien konfigurieren " zu öffnen und Ihre 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 backup-id eine Variable für die az sql db ltr-backup show 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 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

Wiederherstellen von LTR-Sicherungen

Dieses Beispiel zeigt, wie Sie eine LTR-Sicherung wiederherstellen. Beachten Sie, dass diese Schnittstelle nicht geändert wurde, aber der Ressourcen-ID-Parameter erfordert jetzt die LTR-Sicherungsressourcen-ID.

# 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