Lernprogramm: Migrieren von einer lokalen oder einer Azure-VM, die PostgreSQL gehostet hat, zu Azure-Datenbank für PostgreSQL mithilfe des Migrationsdiensts

GILT FÜR: Azure Database for PostgreSQL – Flexible Server

Dieses Tutorial leitet Sie durch das Migrieren einer PostgreSQL-Instanz von Ihren lokalen oder virtuellen Azure-Computern (VMs) zu Azure Database for PostgreSQL – Flexibler Server mithilfe des Azure-Portals und Azure CLI.

Der Migrationsdienst in Azure Database for PostgreSQL ist ein vollständig verwalteter Dienst, der in das Azure-Portal und in Azure CLI integriert ist. Er wurde entwickelt, um Ihre Migrationsjourney zu Azure Database for PostgreSQL – Flexibler Server zu vereinfachen.

• Konfigurieren Ihrer Instanz des flexiblen Azure Database for PostgreSQL-Servers
• Konfigurieren der Migrationsaufgabe
• Überwachen der Migration
• Abbrechen der Migration
• Nach der Migration

Voraussetzungen (offline)

Bevor Sie Ihre Migration mit dem Migrationsdienst in Azure Database for PostgreSQL starten, müssen Sie unbedingt die folgenden Voraussetzungen erfüllen, die für Offlinemigrationsszenarien gelten.

Überprüfen der Quellversion

Die PostgreSQL-Quellversion sollte >= 9.5 sein. Wenn die PostgreSQL-Quellversion kleiner als 9.5 ist, aktualisieren Sie die PostgreSQL-Quellversion auf 9.5 oder höher, bevor Sie migrieren.

Zielsetup

• Azure Database for PostgreSQL muss vor der Migration in Azure eingerichtet werden.

• Die für die Azure Database for PostgreSQL-Instanz gewählte SKU sollte den Spezifikationen der Quelldatenbank entsprechen, um Kompatibilität und angemessene Leistung sicherzustellen.

• Ausführliche Anweisungen zum Erstellen einer neuen Azure Database for PostgreSQL-Instanz finden Sie unter dem folgenden Link: Schnellstart: Erstellen eines Servers.

Netzwerkeinrichtung

Das ordnungsgemäße Netzwerksetup ist unerlässlich, um während der Migration eine erfolgreiche Verbindung zwischen der Quelle und dem Ziel sicherzustellen. Im Folgenden finden Sie eine Anleitung zum Einrichten der Netzwerkverbindung für verschiedene Szenarien:

Netzwerkanforderungen für die Migration:

• ExpressRoute-/IPsec-VPN-/VPN-Tunneling: Wenn Sie Ihre lokale/AWS-Quelle mit Azure verbinden, müssen Sie möglicherweise eine ExpressRoute, ein IPsec-VPN oder VPN-Tunneling einrichten, um eine sichere Datenübertragung zu ermöglichen.

• VNet-Peering: Richten Sie Peering virtueller Netzwerke zwischen den beiden unterschiedlichen VNets ein, um die direkte Netzwerkkonnektivität zu ermöglichen, eine Voraussetzung für die Migration zwischen der Azure-VM und der Azure Database for PostgreSQL-Instanz.

Konnektivitätsszenarien:

Die folgende Tabelle kann beim Einrichten des Netzwerks zwischen der Quelle und dem Ziel helfen.

Quelle	Ziel	Konnektivitätstipps
Öffentlich	Öffentlich	Es ist keine andere Aktion erforderlich, wenn die Quelle in den Firewallregeln des Ziels in der Positivliste aufgeführt ist.
Privat	Public	Diese Konfiguration wird nicht unterstützt. Verwenden Sie pg_dump/pg_restore für die Datenübertragung.
Öffentlich	Privat	Es ist keine andere Aktion erforderlich, wenn die Quelle in den Firewallregeln des Ziels in der Positivliste aufgeführt ist.
Privat	Privat	Richten Sie eine ExpressRoute, ein IPsec-VPN, VPN-Tunneling oder Peering virtueller Netzwerke zwischen der Quelle und dem Ziel ein.
Privat	Privater Endpunkt	Diese Konfiguration wird nicht unterstützt. Wenden Sie sich an den Microsoft-Support.

Zusätzliche Überlegungen zum Netzwerk:

• pg_hba.conf-Konfiguration: Um die Konnektivität zwischen den PostgreSQL-Quell- und Zielinstanzen zu unterstützen, ist es wichtig, die Datei pg_hba.conf zu überprüfen und gegebenenfalls zu ändern. Diese Datei enthält die Clientauthentifizierung und muss so konfiguriert sein, dass die PostgreSQL-Zielinstanz eine Verbindung mit der Quelle herstellen kann. Änderungen an der Datei pg_hba.conf erfordern in der Regel einen Neustart der PostgreSQL-Quellinstanz, um wirksam zu werden.

Hinweis

Die Datei pg_hba.conf befindet sich im Datenverzeichnis der PostgreSQL-Installation. Diese Datei sollte überprüft und konfiguriert werden, wenn es sich bei der Quelldatenbank um einen lokalen PostgreSQL-Server handelt, oder einen PostgreSQL-Server, der auf einer Azure-VM gehostet wird. Bei PostgreSQL-Instanzen auf AWS RDS oder ähnlichen verwalteten Diensten ist die Datei pg_hba.conf nicht direkt zugänglich oder anwendbar. Stattdessen wird der Zugriff über die bereitgestellten Sicherheits- und Netzwerkzugriffskonfigurationen des Diensts gesteuert.

Weitere Informationen zum Netzwerksetup finden Sie im Netzwerkhandbuch für den Migrationsdienst in Azure Database for PostgreSQL – Flexibler Server.

Erweiterungen

Erweiterungen sind zusätzliche Features, die PostgreSQL hinzugefügt werden können, um seine Funktionalität zu verbessern. Erweiterungen werden in Azure Database for PostgreSQL unterstützt, müssen jedoch manuell aktiviert werden. Führen Sie die folgenden Schritte aus, um Erweiterungen zu aktivieren:

• Verwenden Sie den Befehl „auswählen“ in der Quelle, um alle Erweiterungen aufzulisten, die verwendet werden – select extname,extversion from pg_extension;

• Suchen Sie auf der Seite „Serverparameter“ in Ihrer Azure Database for PostgreSQL-Instanz nach dem Serverparameter azure.extensions. Aktivieren Sie die Erweiterungen, die in der Quelle in PostgreSQL gefunden wurden.

• Speichern Sie die Parameteränderungen, und starten Sie die Azure Database for PostgreSQL-Instanz neu, um die neue Konfiguration bei Bedarf anzuwenden.

  

• Überprüfen Sie, ob die Liste eine der folgenden Erweiterungen enthält:

  • PG_CRON
  • PG_HINT_PLAN
  • PG_PARTMAN_BGW
  • PG_PREWARM
  • PG_STAT_STATEMENTS
  • PG_AUDIT
  • PGLOGICAL
  • WAL2JSON

Wenn ja, durchsuchen Sie die Seite „Serverparameter“ nach dem Parameter shared_preload_libraries. Dieser Parameter gibt den Satz von Erweiterungsbibliotheken an, der beim Neustart des Servers vorab geladen wird.

Benutzer und Rollen

Bei der Migration zu Azure Database for PostgreSQL ist es wichtig, die Migration von Benutzer*innen und Rollen separat zu behandeln, da sie manuelle Eingriffe erfordern:

• Manuelle Migration von Benutzer*innen und Rollen: Benutzer*innen und ihre zugehörigen Rollen müssen manuell zur Azure Database for PostgreSQL-Instanz migriert werden. Um diesen Prozess zu unterstützen, können Sie das pg_dumpall-Hilfsprogramm mit der --globals-only-Kennzeichnung verwenden, um globale Objekte wie Rollen und Benutzerkonten zu exportieren. Führen Sie den folgenden Befehl aus, indem Sie <<username>> mit dem tatsächlichen Benutzernamen und <<filename>> mit dem von Ihnen gewünschten Ausgabedateinamen ersetzen:

  pg_dumpall --globals-only -U <<username>> -f <<filename>>.sql
  

• Einschränkung für Superuserrollen: Azure Database for PostgreSQL unterstützt keine Superuserrollen. Daher müssen für Benutzer*innen mit Berechtigungen als Superuser diese Berechtigungen vor der Migration entfernt werden. Stellen Sie sicher, dass Sie die Berechtigungen und Rollen entsprechend anpassen.

Indem Sie diese Schritte ausführen, können Sie sicherstellen, dass Benutzerkonten und Rollen ordnungsgemäß zur Azure Database for PostgreSQL-Instanz migriert werden, ohne dass Probleme im Zusammenhang mit Einschränkungen für Superuser auftreten.

Serverparameter

Diese Parameter werden nicht automatisch in die Zielumgebung migriert und müssen manuell konfiguriert werden.

• Stimmen Sie Serverparameterwerte aus der PostgreSQL-Quelldatenbank mit der Azure Database for PostgreSQL-Instanz ab, indem Sie im Azure-Portal auf den Abschnitt „Serverparameter“ zugreifen und die Werte entsprechend manuell aktualisieren.

• Speichern Sie die Parameteränderungen, und starten Sie die Azure Database for PostgreSQL-Instanz neu, um die neue Konfiguration bei Bedarf anzuwenden.

Deaktivieren der Hochverfügbarkeit (Zuverlässigkeit) und Lesereplikaten im Ziel

• Das Deaktivieren der Hochverfügbarkeit (Zuverlässigkeit) und der Lesereplikate in der Zielumgebung ist unerlässlich. Diese Features sollten erst aktiviert werden, nachdem die Migration abgeschlossen wurde.

• Wenn Sie diese Richtlinien befolgen, können Sie einen reibungslosen Migrationsprozess ohne die zusätzlichen Variablen sicherstellen, die durch Hochverfügbarkeit und Lesereplikate eingeführt wurden. Sobald die Migration abgeschlossen und die Datenbank stabil ist, können Sie diese Features aktivieren, um die Verfügbarkeit und Skalierbarkeit Ihrer Datenbankumgebung in Azure zu verbessern.

Portal

Sie können die Migration über das Azure-Portal 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 lokal oder Azure-VMs 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 Migrationen zu Ihrem flexiblen Serverziel bereits erstellt wurden, enthält das Raster jetzt Informationen zu versuchten Migrationen.

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

   

Setup

Die erste Registerkarte ist die Registerkarte „Setup“.

Benutzer*innen müssen mehrere Details im Zusammenhang mit der Migration bereitstellen, z. B. den Migrationsnamen, 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 Ihrer PostgreSQL-Quelle können Sie Azure Database for PostgreSQL Single Server, lokal oder Azure-VM auswählen.

• Migrationsoption – Ermöglicht es Ihnen, Validierungen durchzuführen, bevor Sie eine Migration auslösen. Sie können eine der folgenden Optionen auswählen:

  • Ü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. Die Migration wird ausgelöst, wenn keine Validierungsfehler vorhanden sind.
    • Das Auswählen der Option Überprüfen oder Überprüfen und Migrieren ist immer eine gute Wahl, um vor dem Ausführen der Migration Validierungen 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.

Mit der Quelle verbinden

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 – 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. Sie müssen die Netzwerkprobleme zwischen dem Ziel und der Quelle identifizieren und den Benutzernamen/das Kennwort für die Quelle überprüfen. „Verbindung testen“ benötigt einige Minuten, um eine Verbindung zwischen Ziel und Quelle herzustellen.

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

Stellen Sie eine Verbindung zur

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

• 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 wir die Netzwerkprobleme zwischen dem Ziel und der Quelle identifizieren und den Benutzernamen/das Kennwort für das Ziel überprüfen. „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 von Datenbanken 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 automatisch auf die Migrationsseite 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 diese 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
  • Enthält eine Validierung im Zusammenhang mit der Verbindungsüberwachung, Quellversion, d. h. PostgreSQL-Version >= 9.5, Serverparameterüberprüfung, d. h., 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.

Es gibt folgende Migrationszustände:

• InProgress: Die Migrationsinfrastruktur wird eingerichtet, oder die tatsächliche Datenmigration wird aktuell ausgeführt.
• Abgebrochen: Die Migration wurde abgebrochen oder gelöscht.
• Failed: Bei der Migration ist ein Fehler aufgetreten.
• Fehler bei Überprüfung: Bei der Überprüfung ist ein Fehler aufgetreten.
• Succeeded: Die Migration wurde erfolgreich durchgeführt und ist beendet.
• WaitingForUserAction: Gilt nur für die Onlinemigration. Warten auf Benutzeraktion zum Ausführen des Cutover.

Es gibt folgende Migrationsunterzustände:

• PerformingPreRequisiteSteps: Das Einrichten der Infrastruktur wird für die Datenmigration ist in Arbeit.
• Überprüfung wird ausgeführt: Die Überprüfung wird ausgeführt.
• MigratingData: Die Datenmigration wird aktuell ausgeführt.
• CompletingMigration: Die Migration befindet sich in den letzten Phasen vor dem Abschluss.
• Abgeschlossen: Die Migration wurde abgeschlossen.
• Fehlgeschlagen: Die Migration ist fehlgeschlagen.

Mögliche Substatus der Validierung sind:

• Fehlgeschlagen: Die Validierung ist fehlgeschlagen.
• Erfolgreich: Die Validierung ist erfolgreich.
• Warnung: Die Validierung befindet sich im Substatus „Warnung“. Warnungen sind informative Meldungen, die Sie beim Planen der Migration berücksichtigen müssen.

Abbrechen der Migration über das Portal

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.

• Durch das Abbrechen einer Überprüfung werden weitere Überprüfungsaktivitäten beendet, und die Überprüfung wechselt in den Zustand Abgebrochen.
• 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.

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können mit Azure CLI migrieren.

Um mit der Migration mittels Azure CLI zu beginnen, müssen Sie die Azure CLI auf Ihrem lokalen Computer installieren.

Einrichten der Azure CLI für den Migrationsdienst in Azure Database for PostgreSQL – Flexibler Server

• Installieren Sie die Azure-Befehlszeilenschnittstelle abhängig vom Betriebssystem, auf dem die CLI-Befehle ausgeführt werden sollen.
• Azure CLI kann von hier installiert werden – Installieren der Azure-Befehlszeilenschnittstelle.
• Wenn Azure CLI bereits installiert ist, überprüfen Sie die Version mit dem Befehl „az version“. Die Version sollte mindestens 2.56.0 oder höher sein, um den Migrationsdienst zu verwenden.
• Führen Sie nach der Installation den Befehl „az sign in“ aus. Dadurch wird der Standardbrowser geöffnet und eine Azure-Anmeldeseite zur Authentifizierung geladen. Übergeben Sie Ihre Azure-Anmeldeinformationen, um eine erfolgreiche Authentifizierung durchzuführen. Weitere Möglichkeiten zum Anmelden mit Azure CLI finden Sie unter diesem Link.

Einrichten von CLI-Befehlen für den Migrationsdienst

Alle CLI-Befehle beginnen mit az postgres flexible-server migration. Es gibt auch Hilfeanweisungen, die Ihnen dabei helfen, die verschiedenen Optionen zu verstehen und die richtige Syntax für die CLI-Befehle festzulegen.

Sobald die Befehlszeilenschnittstelle installiert ist, öffnen Sie die Eingabeaufforderung, und melden Sie sich mit dem folgenden Befehl beim Azure-Konto an.

Beispiel mit Windows-Eingabeaufforderung: az login.

Befehle zur Verwendung mit dem Migrationsdienst

Der Migrationsdienst bietet die folgenden Befehle, mit denen Sie Ihre PostgreSQL-Datenbanken zu Azure Database for PostgreSQL – Flexibler Server migrieren können.

Der Befehl „help“

Der Befehl az postgres flexible-server migration –-help stellt den Namen und die entsprechenden Verben bereit.

Der Befehl „create“

Der Befehl „create“ hilft beim Migrieren von einem Quellserver zu einem Zielserver.

Mit dem Befehl „help“ können Benutzer*innen die verschiedenen Argumente verstehen, die zum Erstellen und Initiieren der Migration az postgres flexible-server migration create --help verwendet werden.

az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-option ValidateAndMigrate --properties "C:\Users\Administrator\Documents\migrationBody.JSON" --migration-mode offline

Unterschiedliche Substatus fließen, wenn der Befehl „create“ ausgelöst wird.

• Die Migration wechselt zum Status InProgress und zum Substatus PerformingPreRequisiteSteps.

• Nachdem der Substatus PerformingPreRequisiteSteps abgeschlossen wurde, wechselt die Migration in den Substatus „Daten werden migriert“, in dem die Datenbanken geklont/kopiert werden.

• Jede migrierte Datenbank verfügt über ihren Abschnitt mit sämtlichen Migrationsdetails, z. B. Anzahl der Tabellen, inkrementelle Einfügungen, Löschungen und ausstehende Bytes.

• Die Zeit bis zum Abschluss des Substatus „Daten werden migriert“ hängt von der Größe der zu migrierenden Datenbanken ab.

• Die Migration wechselt in den Status „Erfolgreich“, sobald der Substatus „Daten werden migriert“ erfolgreich abgeschlossen wurde. Wenn beim Substatus „Daten werden migriert“ ein Problem auftritt, wechselt die Migration in den Status „Fehlgeschlagen“.

Lassen Sie uns die Details der einzelnen Parameter verstehen, die im Befehl „create“ verwendet werden.

Parametername	Beschreibung
subscription	Abonnement-ID des PostgreSQL – Flexibler Server
resource-group	Ressourcengruppe des PostgreSQL – Flexibler Server
name	Name des flexiblen PostgreSQL – Flexibler Server-Ziels
migration-name	Eindeutiger Bezeichner für Migrationsversuche zu Flexible Server. 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 „-“ beginnen, und keine zwei Migrationen zu einem Flexibler Server-Ziel dürfen denselben Namen haben.
migration-mode	Dies ist ein optionaler Parameter. Standardwert: Offline. Die Offlinemigration umfasst das Kopieren Ihrer Quelldatenbanken zu einem bestimmten Zeitpunkt auf Ihren Zielserver.
migration-option	Ermöglicht es Ihnen, Validierungen durchzuführen, bevor Sie eine Migration auslösen. Der Standardwert ist ValidateAndMigrate. Zulässige Werte sind : Migrate, Validate, ValidateAndMigrate.
properties	Absoluter Pfad zu einer JSON-Datei mit den Informationen zum Quellserver

Sie müssen eine JSON-Datei mit dem absoluten Pfad als Parameter bereitstellen, während Sie die Migration initiieren.

Die JSON-Datei enthält die folgenden Informationen:

Eigenschaftenname	Beschreibung
sourceDbServerResourceId	Quellserverdetails im Format für lokale, virtuelle Azure-Computer (VMs), AWS – <<hostname or IP address>>:<<port>>@<<username>>
AdminCredentials	Dieser Parameter listet Kennwörter für Administratorbenutzer sowohl für den Quellserver als auch für den flexiblen PostgreSQL-Zielserver auf. Diese Kennwörter helfen bei der Authentifizierung gegenüber dem Quell- und Zielserver
targetServerUserName	Der Standardwert ist der bei der Erstellung des flexiblen Servers erstellte Administratorbenutzer, und das angegebene Kennwort wird für die Authentifizierung gegenüber diesem Benutzer verwendet. Wenn Sie nicht den Standardbenutzer verwenden, ist dieser Parameter der/die Benutzer*in oder die Rolle auf dem Zielserver für die Migration. Diese*r Benutzer*in sollte ein Mitglied der Rollen azure_pg_admin, pg_read_all_settings, pg_read_all_stats und pg_stat_scan_tables sein sowie über die Attribute „Rolle erstellen“ und „Datenbank erstellen“ verfügen
dbsToMigrate	Geben Sie die Liste der Datenbanken an, die Sie zu Flexible Server migrieren möchten. Sie können pro Vorgang maximal acht Datenbanknamen angeben. Bereitstellen der Liste der Datenbanken im Arrayformat.
OverwriteDBsInTarget	Wenn er auf WAHR (Standard) festgelegt ist und auf dem Zielserver bereits eine Datenbank mit demselben Namen vorhanden ist wie diejenige, die Sie migrieren möchten, überschreibt das Migrationstool die Datenbank automatisch
MigrationMode	Der Modus der Migration. Der unterstützte Wert ist „Offline“
sourceType	Erforderlicher Parameter. Werte können sein – OnPremises, AWS, AzureVM, PostgreSQLSingleServer
sslMode	SSL-Modi für die Migration. Der SSL-Modus für PostgreSQLSingleServer ist VerifyFull und Prefer/Require für andere Quelltypen

Der Befehl „list“

Der Befehl „list“ listet alle Migrationsversuche auf, die zu einem Azure Database for PostgreSQL-Ziel vorgenommen wurden.

az postgres flexible-server migration list [--subscription] [--resource-group][--name] [--filter]

Parametername	Beschreibung
subscription	Abonnement-ID des PostgreSQL – Flexibler Server-Ziels
resource-group	Ressourcengruppe des PostgreSQL – Flexibler Server-Ziels
name	Name des PostgreSQL – Flexibler Server-Ziels
filter	Zum Filtern von Migrationen werden zwei Werte unterstützt – Aktiv und Alle

Der Befehl „show“

Der Befehl „show“ hilft Ihnen bei der Überwachung laufender Migrationen und gibt den aktuellen Status und Substatus der Migration an. Dies umfasst Informationen zum aktuellen Zustand und Unterzustand der Migration.

az postgres flexible-server migration show [--subscription][--resource-group][--name][--migration-name]

Parametername	Beschreibung
subscription	Abonnement-ID des PostgreSQL – Flexibler Server-Ziels
resource-group	Ressourcengruppe des PostgreSQL – Flexibler Server-Ziels
name	Name des PostgreSQL – Flexibler Server-Ziels
migration-name	Eindeutiger Bezeichner für Migrationsversuche zu Flexible Server. 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 „-“ beginnen, und keine zwei Migrationen zu einem Flexibler Server-Ziel dürfen denselben Namen haben.

Unterschiedliche Status, die im Befehl „show“ unterstützt werden

Migrationszustand	Beschreibung
InProgress	Die Migrationsinfrastruktur wird eingerichtet, oder die tatsächliche Datenmigration ist in Arbeit
Canceled	Die Migration wurde abgebrochen oder gelöscht
Failed	Die Migration ist fehlgeschlagen
Succeeded	Die Migration war erfolgreich und ist abgeschlossen
WaitingForUserAction	Gilt nur für die Onlinemigration. Warten auf Benutzeraktion zum Ausführen des Cutover
ValidationFailed	Die Validierung auf Datenbank- oder Serverebene ist fehlgeschlagen

Unterschiedliche Substatus, die im Befehl „show“ für die Migration unterstützt werden

SubState der Migration	Beschreibung
PerformingPreRequisiteSteps	Infrastruktur wird eingerichtet und für die Datenmigration vorbereitet
MigratingData	Datenmigration ist in Arbeit
Completed	Migration ist abgeschlossen
Failed	Migration ist fehlgeschlagen
Validation in Progress	Validierung ist in Arbeit
CompletingMigration	Migration befindet sich in den letzten Phasen des Abschlusses

Validierungsdetails befinden sich auf Instanz- und Datenbankebene

• Validierung auf Instanzebene

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

• Validierung auf Datenbankebene

  • Enthält eine Validierung der einzelnen Datenbanken im Zusammenhang mit Erweiterungen, Sortierungsunterstützung in Azure Database for PostgreSQL – Flexibler Server.

Unterschiedliche Substatus, die im Befehl „show“ für die Validierung unterstützt werden.

SubState der Validierung	Beschreibung
Failed	Validierung ist fehlgeschlagen
Succeeded	Validierung ist erfolgreich
Warning	Validierung befindet sich im Status „Warnung“ Warnungen sind informative Meldungen, die Sie beim Planen der Migration berücksichtigen müssen

Abbrechen der Migration

Sie können alle laufenden Migrationsversuche mit dem Befehl cancel abbrechen. Dieser Befehl beendet den jeweiligen Migrationsversuch, löscht jedoch keine Änderungen auf Ihrem Zielserver und führt auch kein Rollback aus. Der CLI-Befehl zum Löschen einer Migration lautet folgendermaßen:

az postgres flexible-server migration update cancel [--subscription][--resource-group][--name][--migration-name]

Beispiel:

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

Weitere Informationen zu diesem Befehl erhalten Sie über den Parameter help:

az postgres flexible-server migration update cancel -- help

Mit der Quelle verbinden

Wir werden „ticketdb“, „inventorydb“, „salesdb“ nach Azure Database for PostgreSQL – Flexibler Server migrieren.

Durchführen der Migration mittels CLI

• Öffnen Sie die Eingabeaufforderung, und melden Sie sich mit dem az login-Befehl bei Azure an

  

• 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 like - "ticketdb","timedb","salesdb">>"
          ],
          "OverwriteDBsInTarget": "true",
          "MigrationMode": "Offline",
          "sourceType": "AzureVM",
          "sslMode": "Prefer"
      }
  }
  

• 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 <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --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 <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Unique Migration Name>> --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 <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Migration ID>>
  

• Der Status des Migrationsfortschritts wird in der CLI angezeigt.

  

• Sie können den Status auch im Portal von Azure Database for PostgreSQL – Flexibler Server sehen.

  

Abbrechen der Migration mit CLI

Sie können alle laufenden Migrationsversuche mit dem Befehl cancel abbrechen. 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]
                                            [--resource-group]
                                            [--name]
                                            [--migration-name]

Beispiel:

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

Weitere Informationen zu diesem Befehl erhalten Sie über den Parameter help:

 az postgres flexible-server migration update cancel -- help

Der Befehl liefert die folgende Ausgabe:

---

Nach der Migration

Nach Abschluss der Datenbanken müssen Sie die Daten zwischen Quelle und Ziel manuell validieren und überprüfen, ob alle Objekte in der Zieldatenbank erfolgreich erstellt wurden.

Nach der Migration können Sie die folgenden Aufgaben ausführen:

• Überprüfen Sie die Daten auf Ihrem flexiblen Server, und stellen Sie sicher, dass es sich um eine genaue Kopie der Quellinstanz handelt.

• Nach der Überprüfung aktivieren Sie die Option für Hochverfügbarkeit auf Ihrem flexiblen Server nach Bedarf.

• Ändern Sie die SKU des flexiblen Servers entsprechend den Anwendungsanforderungen. Diese Änderung erfordert einen Neustart des Datenbankservers.

• Wenn Sie Serverparameter gegenüber ihren Standardwerten in der Quellinstanz ändern, kopieren Sie diese Serverparameterwerte auf den flexiblen Server.

• Kopieren Sie andere Servereinstellungen wie Tags, Warnungen und Firewallregeln (falls zutreffend) von der Quellinstanz auf den flexiblen Server.

• Nehmen Sie Änderungen an Ihrer Anwendung vor, um die Verbindungszeichenfolgen auf einen flexiblen Server zu verweisen.

• Überwachen Sie die Datenbankleistung genau, um festzustellen, ob Leistungsoptimierung erforderlich ist.

Zugehöriger Inhalt

• Migrationsdienst
• Migrieren von AWS RDS
• bewährten Methoden
• Bekannte Probleme und Einschränkungen
• Netzwerkeinrichtung
• Validierungen vor der Migration