Teilen über

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

  • Artikel

Die Azure CLI bietet eine Reihe von Befehlen für Azure-Dienste zum Erstellen und Verwalten von Ressourcen. Sie bietet die gleichen Funktionen wie das Azure-Portal, ist aber für Benutzer optimiert, die lieber in einer Befehlszeilenumgebung arbeiten. Um mit der Migration mittels Azure CLI zu beginnen, müssen Sie die Azure CLI auf Ihrem lokalen Computer installieren.

Voraussetzungen

  • Installieren der Azure CLI: Laden Sie die Azure CLI für Ihr Betriebssystem herunter, und installieren Sie sie. Sue ist für Windows, macOS und Linux verfügbar.
  • Azure CLI-Installationsleitfaden: Befolgen Sie die Anweisungen in der offiziellen Azure-Dokumentation zum Installieren der Azure CLI: Installieren der Azure CLI.
  • Überprüfen der Azure CLI-Version: Stellen Sie sicher, dass Sie mindestens die Azure CLI-Version 2.56.0 verwenden, da diese für den Migrationsdienst erforderlich ist. Verwenden Sie den Befehl az --version, um Ihre aktuelle Version zu überprüfen.
  • Anmelden bei Azure: Führen Sie nach der Installation az login zur Authentifizierung aus. Dadurch wird Ihr Standardbrowser geöffnet, um den Anmeldevorgang mit Ihren Azure-Anmeldeinformationen abzuschließen.

Diese Schritte bereiten Ihre Umgebung auf die Verwendung der Azure CLI vor, um den Migrationsdienst in Azure Database for PostgreSQL effektiv zu verwalten. Informationen zu Updates oder Änderungen am Installationsprozess finden Sie stets in der aktuellen Azure-Dokumentation.

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.

az login

Migrationsbefehle

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

Help-Befehl

Der Befehl --help in der Azure CLI ist eine nützliche Option, die detaillierte Dokumentation zu den Befehlen und ihren Unterbefehlen bereitstellt, einschließlich der erforderlichen Verben für Vorgänge. Der Befehl –-help zeigt die erforderlichen Befehle und die zugehörigen Aktionen für den Migrationsdienst in Azure Database for PostgreSQL an.

az postgres flexible-server migration –-help

Die Ausgabe führt Sie durch die erforderlichen Schritte und Parameter, die zum effektiven Verwalten Ihrer Datenbankmigration mithilfe der Azure CLI erforderlich sind.

Create-Befehl

Der Befehl az postgres flexible-server migration create in der Azure CLI wird verwendet, um einen neuen Migrationsworkflow zu initiieren. Er erleichtert die Migration von Datenbanken von einer PostgreSQL-Quellinstanz zu einer Zielinstanz von Azure Database for PostgreSQL – Flexibler Server. Mit diesem Befehl werden die erforderlichen Parameter und Konfigurationen eingerichtet, um einen reibungslosen und effizienten Migrationsprozess sicherzustellen.

Weitere Informationen finden Sie unter az postgres flexible-server migration create.

Befehl „list“

Mit dem Befehl az postgres flexible-server migration list werden alle Migrationsversuche aufgelistet, die zu einem Azure Database for PostgreSQL-Ziel vorgenommen wurden. Dieser Befehl bietet eine Übersicht über die Migrationsvorgänge, die initiiert wurden, sodass Sie den Status und die Details der einzelnen Migrationsversuche nachverfolgen können.

Weitere Informationen finden Sie unter az postgres flexible-server migration list

Befehl „Show“

Der Befehl az postgres flexible-server migration show hilft Ihnen bei der Überwachung laufender Migrationen und gibt den aktuellen Zustand und Unterzustand der Migration an. Dies umfasst Informationen zum aktuellen Zustand und Unterzustand der Migration.

Weitere Informationen finden Sie unter az postgres flexible-server migration show

Hier finden Sie einige mögliche Migrationszustände:

Migrationsstatus

State Beschreibung
InProgress Die Migrationsinfrastruktur wird gerade eingerichtet, oder die eigentliche Datenmigration wird gerade durchgeführt.
Canceled Die Migration wurde abgebrochen oder gelöscht.
Fehlgeschlagen Bei der Migration ist ein Fehler aufgetreten.
Überprüfung fehlgeschlagen Die Überprüfung war nicht erfolgreich.
Erfolgreich Die Migration wurde erfolgreich durchgeführt und ist beendet.
WaitingForUserAction Gilt nur für die Onlinemigration. Warten auf Benutzeraktion zum Ausführen des Cutover.

Migrationsunterzustände

Unterzustand Beschreibung
PerformingPreRequisiteSteps Die Infrastruktur für die Datenmigration wird gerade eingerichtet.
Überprüfung wird ausgeführt Die Überprüfung wird ausgeführt.
MigratingData Die Datenmigration wird durchgeführt.
CompletingMigration Die Migration ist fast abgeschlossen.
Abgeschlossen Die Migration wurde abgeschlossen.
Fehler Die Migration ist fehlgeschlagen.

Unterzustände der Überprüfung

Unterzustand Beschreibung
Fehler Fehler bei der Überprüfung.
Erfolgreich Die Überprüfung war erfolgreich.
Warning Die Überprüfung befindet sich im Zustand „Warnung“.

Update-Befehl

Der Befehl az postgres flexible-server migration update wird verwendet, um die Migration zu einer Instanz von Azure Database for PostgreSQL – Flexibler Server zu verwalten. Insbesondere kann er für Folgendes verwendet werden:

  • Ausführen eines Cutovers: Dadurch wird der Migrationsprozess abgeschlossen, indem der Datenbankdatenverkehr vom Quellserver auf den flexiblen Zielserver umgeschaltet wird.
    • Nach Abschluss der Basisdatenmigration wechselt die Migrationsaufgabe in den Unterstatus WaitingForCutoverTrigger. In diesem Zustand können Benutzer den Cutover über das Portal auslösen, indem sie den Migrationsnamen im Migrationsraster oder über die CLI auswählen.
    • Vor dem Initiieren der Übernahme ist es wichtig, folgendes zu gewährleisten:
      • Schreibvorgänge in die Quelle wurden beendet.
      • Der Wert latency sinkt auf 0 oder auf einen Wert nahe 0.
      • Der Wert latency gibt an, wann das Ziel zuletzt mit der Quelle synchronisiert wurde. Zu diesem Zeitpunkt können Schreibvorgänge an die Quelle beendet und der Übernahmevorgang initiiert werden. Falls es einen starken Datenverkehr an der Quelle gibt, empfiehlt es sich, die Schreibvorgänge zuerst zu beenden, damit Latency sich 0 nähert und dann die Übernahme initiiert wird.
      • Der Übernahmevorgang wendet alle ausstehenden Änderungen von der Quelle auf das Ziel an und schließt die Migration ab. Wenn Sie eine „Übernahme“ auslösen, auch wenn Latency nicht Null ist, wird die Replikation bis zu diesem Zeitpunkt angehalten. Alle Quelldaten, bis der Übernahmepunkt auf das Ziel angewendet wird. Angenommen, die Latenzzeit zum Zeitpunkt der Übernahme betrug 15 Minuten, dann werden alle geänderten Daten der letzten 15 Minuten auf das Ziel angewendet.
  • Abbrechen der Migration: Bei Bedarf können Sie mit dieser Option den Migrationsprozess beenden.
  • Einrichten der logischen Replikation für die Quelle: Dies ist nützlich, wenn der Quellserver eine Instanz von Azure Database for PostgreSQL – Einzelserver ist, da der Server auf die Datenreplikation in der Instanz von „Flexibler Server“ vorbereitet wird.

Weitere Informationen finden Sie unter az postgres flexible-server migration update

Zusammenfassung

In der folgenden Tabelle werden die von den Migrationsbefehlen verwendeten Parameter zusammengefasst:

Parameter Relevante Befehle Beschreibung
subscription create, list, show, update Abonnement-ID des PostgreSQL – Flexibler Server
resource-group create, list, show, update Ressourcengruppe des PostgreSQL – Flexibler Server
name create, list, show Name des flexiblen PostgreSQL – Flexibler Server-Ziels
migration-name create, show, update 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.
filter Liste Zum Filtern von Migrationen werden zwei Werte unterstützt – Aktiv und Alle
help create, list, show, update Bietet Informationen zu den einzelnen Befehlen.
migration-mode create Dies ist ein optionaler Parameter. Zulässige Werte: offline, online. Standardwert: Offline.
migration-option create 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 create Absoluter Pfad zu einer JSON-Datei mit den Informationen zu Quelle, Zielserver, den zu migrierenden Datenbanken, SSL-Modi, definierenden Quelltypen

Details der JSON-Datei

Der Befehl az postgres flexible-server migration create erfordert einen JSON-Dateipfad als Teil des Parameters --properties, der Konfigurationsdetails für die Migration enthält, z. B. die Ressourcen-ID des Quelldatenbankservers, Administratoranmeldeinformationen, zu migrierende Datenbanken und andere wichtige Einstellungen. Nachfolgend sind die verschiedenen Eigenschaften aufgeführt:

Eigenschaftenname Beschreibung
sourceDbServerResourceId Details des Quellservers im Format für lokale Ressourcen, virtuelle Maschinen (VMs), cloudbasierten PostgreSQL-Dienst – <<hostname or IP address>>:<<port>>@<<username>>. Wenn es sich bei dem Quellserver um eine Instanz von Azure Database for PostgreSQL – Einzelserver handelt, hat die Ressourcen-ID das Format /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>.
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 dienen zur Authentifizierung gegenüber dem Quell- und Zielserver. Er enthält zwei Untereigenschaften: sourceServerPassword und targetServerPassword.
targetServerUserName Der Standardwert ist der bei der Erstellung des flexiblen PostgreSQL-Zielservers erstellte Administratorbenutzer, und das angegebene Kennwort wird für die Authentifizierung gegenüber diesem Benutzer verwendet.
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 diese Eigenschaft auf „true“ (Standardwert) festgelegt ist und auf dem Zielserver bereits eine Datenbank mit demselben Namen vorhanden ist wie diejenige, die Sie migrieren möchten, überschreibt der Migrationsdienst die Datenbank automatisch.
migrationRuntimeResourceId Erforderlich, wenn ein Laufzeitserver für die Migration verwendet werden muss. Das Format ist - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Erforderlicher Parameter. Zulässige Werte: lokal, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode SSL-Modi für die Migration. Der SSL-Modus für PostgreSQLSingleServer ist VerifyFull und Prefer/Require für andere Quelltypen

Zugehöriger Inhalt