Tutorial: Offlinemigration von Amazon RDS for 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. Mithilfe der in diesem Tutorial beschriebenen Schritte können Sie Ihre Datenbank nahtlos in Azure Database for PostgreSQL – Flexibler Server übertragen und von den leistungsstarken Features und der Skalierbarkeit von Azure profitieren.

Wenn Sie die Migration über das Azure-Portal durchführen möchten, müssen Sie zuerst die Migrationsaufgabe konfigurieren. Anschließend können Sie eine Verbindung mit der Quelle und dem Ziel herstellen und dann die Migration durchführen.

Konfigurieren der Migrationsaufgabe

Der Migrationsdienst verfügt über eine einfache, Assistenten-basierte Erfahrung im Azure-Portal.

1. Browsen Sie zum Portal. Geben Sie Ihre Anmeldeinformationen ein. Die Standardansicht ist Ihr Dienstdashboard.

2. Navigieren Sie zu Ihrer Instanz von Azure Database for PostgreSQL – Flexibler Server.

3. Scrollen Sie auf der Registerkarte Übersicht des flexiblen Servers im linken Menü nach unten zu Migration, und wählen Sie diese Option aus.

   

4. Wählen Sie die Schaltfläche Erstellen aus, um von Amazon RDS for PostgreSQL zu einem flexiblen Server zu migrieren.

   Hinweis

   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 jetzt Informationen zu den durchgeführten Migrationsversuchen.

5. Wählen Sie die Schaltfläche Erstellen aus, um eine Assistenten-basierte Reihe von Registerkarten zu durchlaufen, um eine Migration durchzuführen.

   

Setup

Der Benutzer muss mehrere Details im Zusammenhang mit der Migration bereitstellen, z. B. den Namen der Migration, den Quellservertyp, die Option und den Modus.

• Beim Migrationsnamen handelt es sich um den eindeutigen Bezeichner für eine Migration zu diesem Flexible Server-Ziel. In dieses Feld dürfen nur alphanumerische Zeichen eingegeben werden, und mit Ausnahme von Bindestrichen (-) dürfen keine Sonderzeichen verwendet werden. Der Name darf nicht mit einem Bindestrich beginnen und muss für den Zielserver eindeutig sein. Zwei Migrationen zum selben Flexible Server-Ziel dürfen nicht denselben Namen aufweisen.

• Quellservertyp – Abhängig von der PostgreSQL-Quelle können Sie Amazon RDS for PostgreSQL auswählen.

• Migrationsoption – Ermöglicht es Ihnen, Validierungen durchzuführen, bevor Sie eine Migration auslösen. Folgenden Optionen stehen zur Auswahl:

  • Überprüfen: Mit dieser Option werden die Server- und Datenbankbereitschaft für die Migration zum Ziel überprüft.
  • Migrieren: Überspringt Überprüfungen 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.

Das Auswählen der Option Überprüfen oder Überprüfen und migrieren ist eine bewährte Methode, um vor der Migration Überprüfungen durchzuführen.

Weitere Informationen zur Validierung vor der Migration finden Sie unter Vormigration.

• Im Migrationsmodus können Sie den Modus für die Migration auswählen. Offline ist die Standardoption.

Wählen Sie die Schaltfläche Weiter: Mit Quelle verbinden aus.

Auswählen des Runtimeservers

Der Runtimeserver für die Migration ist ein spezielles Feature innerhalb des Migrationsdiensts, das während der Migration als Zwischenserver fungiert. Es handelt sich um eine separate Instanz von Azure Database for PostgreSQL – Flexibler Server, die nicht als Zielserver fungiert, sondern verwendet wird, um die Migration von Datenbanken aus einer Quellumgebung zu ermöglichen, auf die nur über ein privates Netzwerk zugegriffen werden kann.

Weitere Informationen zum Runtimeserver finden Sie im Artikel zum Runtimeserver für die Migration.

Herstellen einer Verbindung mit der Quelle

Auf der Registerkarte Mit Quelle verbinden werden Sie aufgefordert, Details zu der Quelle anzugeben, die auf der Registerkarte „Setup“ ausgewählt und die Quelle der Datenbanken ist.

• Servername – Geben Sie den Hostnamen oder die IP-Adresse der PostgreSQL-Quellinstanz an
• Port – Portnummer des Quellservers
• Anmeldename des Serveradministrators – Benutzername des PostgreSQL-Quellservers
• Kennwort – Kennwort des PostgreSQL-Quellservers
• SSL-Modus – Unterstützte Werte werden bevorzugt und sind erforderlich. Wenn SSL auf dem PostgreSQL-Quellserver DEAKTIVIERT ist, verwenden Sie SSLMODE=prefer. Wenn SSL auf dem Quellserver AKTIVIERT ist, verwenden Sie SSLMODE=require. SSL-Werte können in der Datei postgresql.conf bestimmt werden.
• Verbindung testen: Testet die Verbindung zwischen Ziel und Quelle. Nach erfolgreicher Verbindungsherstellung können Benutzer mit dem nächsten Schritt fortfahren. Sie müssen die Netzwerkprobleme zwischen dem Ziel und der Quelle identifizieren und den Benutzernamen und das Kennwort für die Quelle überprüfen. Das Herstellen einer Testverbindung dauert einige Minuten.

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

Auswählen des Migrationsziels

Auf der Registerkarte Migrationsziel auswählen werden Metadaten für das Flexibler Server-Ziel angezeigt, z. B. Abonnementname, Ressourcengruppe, Servername, Speicherort und PostgreSQL-Version.

• Administratorbenutzername – Administratorbenutzername des PostgreSQL-Zielservers
• Kennwort – 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. Hierbei kann es sich beispielsweise um Einträge wie flexibleserver.example.com, 198.1.0.2 oder um einen PostgreSQL-FQDN wie flexibleserver.postgres.database.azure.com handeln, wenn der benutzerdefinierte DNS-Server die DNS-Zone postgres.database.azure.com enthält oder Abfragen für diese Zone an 168.63.129.16 weiterleitet, wobei der FQDN in der öffentlichen oder privaten DNS-Zone von Azure aufgelöst wird.
• Verbindung testen – Führt den Verbindungstest zwischen Ziel und Quelle durch. Sobald die Verbindung erfolgreich hergestellt ist, können Benutzer*innen mit dem nächsten Schritt fortfahren. Andernfalls müssen die Netzwerkprobleme zwischen dem Ziel und der Quelle identifiziert und der Benutzername und das Kennwort des Ziels überprüft werden. „Verbindung testen“ benötigt einige Minuten, um eine Verbindung zwischen Ziel und Quelle herzustellen

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

Auswählen der Datenbank für die Migration

Unter der Registerkarte Datenbank für die Migration auswählen können Sie eine Liste der Benutzerdatenbanken auswählen, 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 die Schaltfläche Validierung und Migration starten aus.

Überwachen der Migration

Nachdem Sie die Schaltfläche Validierung und Migration starten ausgewählt haben, wird nach einigen Sekunden eine Benachrichtigung angezeigt, die Sie informiert, dass die Validierungs- oder Migrationserstellung erfolgreich war. Sie werden zur Seite Migration des flexiblen Servers umgeleitet. Der Eintrag befindet sich im Status InProgress und dem Substatus 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, Quellservertyp, Datenbanken, **„Dauer“ und Startzeit. Die Einträge werden in absteigender Reihenfolge nach Startzeit angezeigt, mit dem aktuellsten Eintrag zuoberst. Sie können die Schaltfläche „Aktualisieren“ verwenden, um den Status der Validierungs- oder Migrationsausführung zu aktualisieren.

Details zur Migration

Wählen Sie den Migrationsnamen im Raster aus, um die zugehörigen Details anzuzeigen.

Auf der Registerkarte Setup haben wir die Migrationsoption als Überprüfen und Migrieren ausgewählt. In diesem Szenario werden Validierungen als erstes ausgeführt, bevor die Migration startet. Nach Abschluss des Substatus PerformingPreRequisiteSteps wechselt der Workflow in den Substatus Validierung in Arbeit.

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

• Wenn die Validierung ohne Fehler abgeschlossen ist, wird die Migration gestartet, und der Workflow wechselt in den Substatus Migrieren von Daten.

Validierungsdetails sind auf Instanz- und Datenbankebene verfügbar.

• Validierung auf Instanzebene

  • Umfasst eine Validierung im Zusammenhang mit der Verbindungsüberwachung, Quellversion (d. h. PostgreSQL-Version >= 9.5) und Serverparameterüberprüfung, wenn die Erweiterungen in den Serverparametern der Instanz von Azure Database for PostgreSQL – Flexibler Server aktiviert sind.

• Validierung auf Datenbankebene

  • Dies enthält eine Validierung der einzelnen Datenbanken im Zusammenhang mit Erweiterungen und Sortierungsunterstützung in Azure Database for PostgreSQL, einem flexiblen Server.

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

Hier finden Sie einige mögliche Migrationszustände:

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 InProgress 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 gestoppt, und sie wechseln in den Zustand Abgebrochen. Die Aktion „Abbrechen“ führt ein Rollback aller Änderungen aus, die vom Migrationsdienst auf Ihrem Zielserver vorgenommen wurden.

In diesem Artikel wird erläutert, wie Sie eine PostgreSQL-Datenbank über die Azure CLI von Amazon RDS for PostgreSQL zu Azure Database for PostgreSQL migrieren. Die Azure CLI ist eine leistungsstarke und flexible Befehlszeilenschnittstelle, mit der Sie verschiedene Aufgaben ausführen können, einschließlich einer Datenbankmigration. Mithilfe der in diesem Artikel beschriebenen Schritte können Sie Ihre Datenbank nahtlos in Azure übertragen und von den leistungsstarken Features und der Skalierbarkeit von Azure profitieren.

Weitere Informationen zur Verwendung der Azure CLI mit dem Migrationsdienst finden Sie in der Anleitung zum Einrichten der Azure CLI für den Migrationsdienst.

Öffnen Sie nach der Installation der CLI die Eingabeaufforderung, und melden Sie sich mit dem folgenden Befehl bei Ihrem Azure-Konto an.

az login

Konfigurieren der Migrationsaufgabe

Um mit der Migration zu beginnen, müssen Sie eine JSON-Datei mit den Migrationsdetails erstellen. Die JSON-Datei enthält die folgenden Informationen:

• Bearbeiten Sie die folgenden Platzhalter << >> in den JSON-Zeilen, und speichern Sie diese auf dem lokalen Computer, auf dem die CLI aufgerufen wird, als <<filename>>.json. In diesem Tutorial haben wir die Datei in C:\migration-CLI\migration_body.json gespeichert

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "AWS_RDS",
        "sslMode": "Require"
    }
}

• Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Migrationen ausgeführt werden. Der Migrationsname ist für die Migrationen innerhalb des Ziels 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
  

• In den obigen 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"
  

• 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 sich den Status von Azure Database for PostgreSQL – Flexibler Server aber auch im Azure-Portal ansehen.

• Mithilfe des Befehls cancel können alle laufenden Migrationsversuche abgebrochen werden. Dieser Befehl stoppt den jeweiligen Migrationsversuch und macht alle Änderungen auf Ihrem Zielserver rückgängig. Der 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