Tutorial: Offlinemigration von Amazon Aurora PostgreSQL zu Azure Database for PostgreSQL mit dem Migrationsdienst

Das Azure-Portal bietet eine einfache und intuitive assistentenbasierte Oberfläche, die Sie durch die Migration führt. Indem Sie die in diesem Lernprogramm beschriebenen Schritte ausführen, können Sie Ihre Datenbank nahtlos auf azure Database for PostgreSQL flexiblen Server übertragen und ihre leistungsstarken Features und Skalierbarkeit nutzen.

Um mithilfe des Azure-Portals zu migrieren, konfigurieren Sie zuerst die Migrationsaufgabe. Stellen Sie dann eine Verbindung mit der Quelle und dem Ziel her, und initiieren Sie die Migration.

Konfigurieren der Migrationsaufgabe

So konfigurieren Sie die Migrationsaufgabe im Azure-Portal

1. Öffnen Sie Ihren Webbrowser, und navigieren Sie zum Azure-Portal. Geben Sie Ihre Anmeldeinformationen ein.

2. Wechseln Sie zu Ihrer Instanz von Azure Database for PostgreSQL Flexible Server.

3. Wählen Sie im Dienstmenü die Option Migration aus.

   

4. Wählen Sie Erstellen aus, um von Amazon Aurora zu einem flexiblen Server zu migrieren.

   Bei der ersten Verwendung des Migrationsdienstes erscheint ein leeres Raster mit einer Eingabeaufforderung, um mit Ihrer ersten Migration zu beginnen. Wenn bereits Migrationen zu Ihrem Zielserver (Flexibler Server) erstellt wurden, enthält das Raster Informationen zu den durchgeführten Migrationsversuchen.

5. Wählen Sie Erstellen aus, um eine Reihe von Registerkarten zum Einrichten einer Migration zu durchlaufen.

   

Einrichten

Geben Sie die folgenden Informationen ein oder wählen Sie sie aus:

• Migrationsname: Geben Sie einen eindeutigen Bezeichner für jede Migration zur Zielinstanz des flexiblen Servers ein. Sie können nur alphanumerische Zeichen und Bindestriche (-) im Migrationsnamen verwenden. Der Name darf nicht mit einem Bindestrich beginnen und muss für den Zielserver eindeutig sein. Zwei Migrationen zur selben Zielinstanz des flexiblen Servers dürfen nicht denselben Namen aufweisen.

• Typ des Quellservers: Wählen Sie den Quelltyp aus, der Ihrer PostgreSQL-Quelle entspricht, z. B. einen cloudbasierten PostgreSQL-Dienst, ein lokales Setup oder eine virtuelle Maschine.

• Migrationsoption: Wählen Sie eine der folgenden Optionen für eine Überprüfung vor der Migration aus:

  • Validieren. Überprüft die Bereitschaft Ihres Servers und Ihrer Datenbank für die Migration zur Zielumgebung.
  • Migrieren. Überspringt Validierungen und startet die Migration
  • Überprüfen und migrieren. Führt eine Überprüfung durch, bevor eine Migration ausgelöst wird. Wenn bei der Überprüfung keine Fehler festgestellt werden, wird die Migration ausgelöst.

  Es empfiehlt sich, die Option Überprüfen oder Überprüfen und migrieren für Überprüfungen vor der Migration auszuwählen.

  Weitere Informationen finden Sie unter Validierungen vor der Migration.

• Migrationsmodus: Wählen Sie den Modus für die Migration aus. Die Standardoption ist Offline.

Wählen Sie Weiter: Mit Quelle verbinden aus.

Auswählen des Runtimeservers

Der Migrationsruntimeserver ist ein spezielles Feature des Migrationsdiensts. Der Runtimeserver fungiert während der Migration als Zwischenserver. Es handelt sich um eine separate Instanz des Azure Database for PostgreSQL Flexibel-Servers, die nicht der Zielserver ist. Der Runtimeserver erleichtert die Migration von Datenbanken aus einer Quellumgebung, auf die nur über ein privates Netzwerk zugegriffen werden kann.

Weitere Informationen finden Sie unter Runtimeserver für die Migration mit dem Migrationsdienst in Azure Database for PostgreSQL.

Mit der Quelle verbinden

Geben Sie auf der Registerkarte Mit Quelle verbinden die folgenden Informationen für die Datenbankquelle ein, oder wählen Sie sie aus:

• Servername: Geben Sie den Hostnamen oder die IP-Adresse der PostgreSQL-Quellinstanz an.
• Port: Geben Sie die Portnummer des Quellservers ein.
• Anmeldename des Serveradministrators: Geben Sie den Benutzernamen des PostgreSQL-Quellservers ein.
• Kennwort: Geben Sie das Kennwort des PostgreSQL-Quellservers ein.
• SSL-Modus: Unterstützte Werte sind Prefer und Require. Wenn Secure Sockets Layer (SSL) auf dem PostgreSQL-Quellserver deaktiviert ist, wählen Sie Prefer aus. Wenn SSL auf dem Quellserver aktiviert ist, verwenden Sie Require. SSL-Werte werden in der Datei postgresql.conf festgelegt.
• Verbindung testen: Initiiert einen Konnektivitätstest zwischen Ziel und Quelle. Nach erfolgreicher Verbindungsherstellung fahren Sie mit dem nächsten Schritt fort, um Netzwerkprobleme zwischen dem Ziel und der Quelle zu identifizieren und den Benutzernamen und das Kennwort für die Quelle zu überprüfen. Das Herstellen einer Testverbindung dauert einige Minuten.

Wählen Sie nach dem erfolgreichen Testen der Verbindung Weiter: Migrationsziel auswählen aus.

Wählen Sie das Migrationsziel aus.

Geben Sie auf der Registerkarte Migrationsziel auswählen die folgenden Informationen für die Zielinstanz des flexiblen Servers zusätzlich zu Abonnement, Ressourcengruppe und Servername ein, oder wählen Sie diese Informationen aus:

• Administratorbenutzername: Der Administratorbenutzername des PostgreSQL-Zielservers
• Kennwort: Das Kennwort des PostgreSQL-Zielservers
• FQDN/IP-Adresse (benutzerdefiniert): Die Angabe in diesem Feld ist optional und kann verwendet werden, wenn sich das Ziel hinter einem benutzerdefinierten DNS-Server befindet oder über benutzerdefinierte DNS-Namespaces verfügt, sodass nur über bestimmte FQDNs oder IP-Adressen darauf zugegriffen werden kann. Dies kann z. B. Einträge wie flexibleserver.example.com, 198.1.0.2 oder einen PostgreSQL-FQDN wie flexibleserver.postgres.database.azure.com enthalten, wenn der benutzerdefinierte DNS-Server die DNS-Zone postgres.database.azure.com enthält oder Weiterleitungsabfragen für diese Zone an 168.63.129.16 weiterleitet, wo der FQDN in der öffentlichen oder privaten Azure-DNS-Zone aufgelöst wird.
• Verbindung testen: Initiiert einen Konnektivitätstest zwischen Ziel und Quelle. Nach erfolgreicher Verbindungsherstellung fahren Sie mit dem nächsten Schritt fort, um Netzwerkprobleme zwischen dem Ziel und der Quelle zu identifizieren und den Benutzernamen und das Kennwort für den Zielserver zu überprüfen. Das Herstellen einer Testverbindung dauert einige Minuten.

Wählen Sie nach dem erfolgreichen Test der Verbindung die Option Weiter: Datenbank(en) für die Migration auswählen aus.

Auswählen von Datenbanken für die Migration

Wählen Sie auf der Registerkarte Datenbank für die Migration auswählen aus einer Liste der Benutzerdatenbanken aus, die von Ihrem PostgreSQL-Quellserver migriert werden sollen.

Nachdem Sie die Datenbanken ausgewählt haben, wählen Sie Weiter: Zusammenfassung aus.

Zusammenfassung

Auf der Registerkarte Zusammenfassung werden alle Quell- und Zieldetails zum Erstellen der Validierung oder Migration zusammengefasst. Überprüfen Sie die Details, und wählen Sie dann Validierung und Migration starten aus.

Überwachen der Migration

Einige Sekunden, nachdem Sie Validierung und Migration starten ausgewählt haben, wird eine Benachrichtigung angezeigt, die Sie informiert, dass die Validierungs- oder Migrationserstellung erfolgreich war. Sie werden zum Bereich Migration der 'Flexible Server'-Instanz umgeleitet. Der Eintrag für Status lautet InProgress, und der Substatus ist PerformingPreRequisiteSteps. Der Workflow benötigt 2 bis 3 Minuten, um die Migrationsinfrastruktur einzurichten und die Netzwerkverbindungen zu überprüfen.

Das Raster, in dem die Migrationen angezeigt werden, enthält folgende Spalten:

• Name
• Status
• Migrationsmodus
• Migrationstyp
• Quellserver
• Typ des Quellservers
• Datenbanken
• Dauer
• Startzeit

Die Einträge werden in absteigender Reihenfolge nach Startzeit angezeigt, mit dem aktuellsten Eintrag zuoberst. Sie können auf der Menüleiste Aktualisieren auswählen, um den Status der Validierungs- oder Migrationsausführung zu aktualisieren.

Details zur Migration

Wählen Sie in der Liste der Migrationen den Namen einer Migration aus, um die zugehörigen Details anzuzeigen.

Wählen Sie auf der Registerkarte Setup die Migrationsoption Überprüfen und migrieren aus. In diesem Szenario werden Validierungen abgeschlossen, bevor die Migration startet. Nach Abschluss des Unterzustands PerformingPreRequisiteSteps wechselt der Workflow in den Unterzustand Überprüfung wird ausgeführt.

• Wenn bei der Überprüfung Fehler auftreten, wechselt die Migration in den Zustand Fehler.

• Wenn die Validierung ohne Fehler abgeschlossen wird, wird die Migration gestartet, und der Workflow wechselt in den Unterstatus Daten werden migriert.

Sie können Überprüfungsdetails auf Instanzebene und auf Datenbankebene überprüfen:

• Überprüfung auf Instanzebene:

  • Überprüfen Sie die Validierung im Zusammenhang mit der Konnektivitätsprüfung für die Quellversion (Serverparameterüberprüfung PostgreSQL version >= 9.5), wenn die Erweiterungen in den Serverparametern der Instanz von Azure Database for PostgreSQL – Flexibler Server aktiviert sind.

• Überprüfung auf Datenbankebene:

  • Überprüfen Sie die Validierung der einzelnen Datenbanken im Zusammenhang mit der Unterstützung von Erweiterungen und Sortierungen in Azure Database for PostgreSQL – Flexibler Server.

Sie können den aktuellen Status der Migration und der Validierung auf der Seite mit den Migrationsdetails anzeigen.

In den folgenden Tabellen werden einige mögliche Migrationszustände und Unterzustände beschrieben.

Migrationsstatus

Migrationsunterzustände

Unterzustände der Überprüfung

Abbrechen der Migration

Sie können alle aktuellen Überprüfungen oder Migrationen abbrechen. Der Workflow muss sich im Zustand Wird ausgeführt befinden, damit er abgebrochen werden kann. Sie können keine Überprüfung oder Migration abbrechen, die sich im Zustand Erfolgreich oder Fehler befindet.

Bei Abbruch einer Migration werden alle weiteren Migrationsaktivitäten auf dem Zielserver beendet, und der Migrationsversuch wechselt in den Zustand Abgebrochen. Die Aktion „Abbrechen“ setzt alle vom Migrationsdienst auf Ihrem Zielserver vorgenommenen Änderungen zurück.

In diesem Artikel wird erläutert, wie Sie die Azure CLI verwenden, um Ihre PostgreSQL-Datenbank von Amazon Aurora zu Azure Database for PostgreSQL zu migrieren. Die Azure CLI ist eine leistungsstarke und flexible Befehlszeilenschnittstelle, mit der Sie verschiedene Aufgaben ausführen können, einschließlich einer Datenbankmigration.

Weitere Informationen finden Sie unter Einrichten der Azure CLI für den Migrationsdienst.

Nachdem die Azure CLI installiert wurde, melden Sie sich in der Befehlszeile mit dem folgenden Befehl bei Ihrem Azure-Konto an:

az login

Konfigurieren der Migrationsaufgabe

1. Erstellen Sie eine JSON-Datei mit den Migrationsdetails, um mit der Migration zu beginnen. Speichern Sie die JSON-Datei auf Ihrem lokalen Computer als [Dateiname].json. Sie können die Datei beispielsweise als C:\migration-CLI\migration_body.json speichern.

   Kopieren Sie den folgenden JSON-Code, und fügen Sie ihn in die JSON-Datei ein. Ersetzen Sie <placeholders> durch relevante Informationen aus Ihrem Szenario.

   {
   "properties": {
   "SourceDBServerResourceId": "<source host name or IP address>:<port>@<username>",
           "SecretParameters": {
               "AdminCredentials": {
                   "SourceServerPassword": "<source password>",
                   "TargetServerPassword": "<target password>"
               },
               "targetServerUserName": "<target username>"
           },
           "DBsToMigrate": "<a comma-separated list of databases in an array, similar to the example "ticketdb","timedb","inventorydb">",
           "OverwriteDBsInTarget": "true",
           "sourceType": "AWS_AURORA",
           "sslMode": "Require"
       }
   }
   

2. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Migrationen ausgeführt werden. Der Migrationsname ist für Migrationen in der Zielinstanz von Azure Database for PostgreSQL – Flexibler Server eindeutig.

   az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
   

3. In den vorherigen Schritten werden keine Migrationen ausgeführt, sodass wir mit der neuen Migration beginnen, indem wir den folgenden Befehl ausführen:

   az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode offline --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
   

4. Führen Sie den folgenden Befehl aus, um den Migrationsstatus im vorherigen Schritt zu initiieren. Sie können den Status der Migration überprüfen, indem Sie den Migrationsnamen angeben

   az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
   

   Der Status des Migrationsprozesses wird in der Azure CLI angezeigt. Sie können auch den Status der Instanz der Azure-Datenbank für PostgreSQL flexiblen Server im Azure-Portal sehen.

Abbrechen oder Löschen einer Migration

Sie können alle laufenden Migrationsversuche mit dem Befehl cancel abbrechen. Dieser Befehl beendet den jeweiligen Migrationsversuch und macht alle Änderungen auf Ihrem Zielserver rückgängig.

Der Azure CLI-Befehl zum Löschen einer Migration lautet folgendermaßen:

az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1