Freigeben über

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

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. Es 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.

Schritte zum Einrichten von CLI-Befehlen

  1. Installieren Sie Azure CLI: Befolgen Sie die Anweisungen in der offiziellen Azure-Dokumentation, um die Azure CLI zu installieren – Installieren der Azure CLI.

  2. Überprüfen Sie die Azure CLI-Version: Stellen Sie sicher, dass Ihre Azure CLI-Version mindestens 2.56.0 oder höher ist. Verwenden Sie den Befehl az --version, um Ihre aktuelle Version zu überprüfen.

  3. 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.

Nachdem die CLI installiert wurde, öffnen Sie die Eingabeaufforderung, und melden Sie sich mit dem folgenden Befehl beim Azure-Konto an.

az login

Migrationsbefehle

Der Migrationsdienst stellt die folgenden Befehle bereit, die Ihnen beim Migrieren Ihrer PostgreSQL-Instanzen zu Azure Database for PostgreSQL flexiblen Server helfen.

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. Sie erleichtert die Migration von Datenbanken von einer Quell-PostgreSQL-Instanz zu einer Azure-Zieldatenbank für flexible Serverinstanz von PostgreSQL. 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 migrationen, 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.
Fehler Fehler bei der Migration.
Überprüfung fehlgeschlagen Fehler bei der Überprüfung
Erfolgreich Die Migration war erfolgreich und ist abgeschlossen.
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 ist abgeschlossen.
Fehler Fehler bei der Migration.

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 az postgres flexible-server migration update Befehl wird verwendet, um den Migrationsprozess zu einem flexiblen Azure-Server für PostgreSQL zu verwalten. Insbesondere kann er für Folgendes verwendet werden:

  • Durchführen eines Übernahmevorgangs: 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, sollten Sie die Schreibvorgänge zuerst 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 an der Quelle: Dies ist nützlich, wenn der Quellserver eine Azure-Datenbank für PostgreSQL - Single Server ist, da er den Server für die Datenreplikation auf den flexiblen Server vorbereitet.

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 Erstellen, Auflisten, Anzeigen, Aktualisieren Abonnement-ID des PostgreSQL – Flexibler Server
resource-group Erstellen, Auflisten, Anzeigen, Aktualisieren Ressourcengruppe des PostgreSQL – Flexibler Server
name erstellen, auflisten, anzeigen Name des flexiblen PostgreSQL – Flexibler Server-Ziels
migration-name erstellen, anzeigen, aktualisieren Eindeutiger Bezeichner für Versuche der Migrationen zu einem flexiblen Server. In dieses Feld dürfen nur alphanumerische Zeichen eingegeben werden, und mit Ausnahme von Bindestrichen (-) dürfen keine Sonderzeichen verwendet werden. Der Name kann nicht mit -beginnen, und keine zwei Migrationen zu einem flexiblen Serverziel können denselben Namen haben.
filter list Zum Filtern von Migrationen werden zwei Werte unterstützt – Aktiv und Alle
help Erstellen, Auflisten, Anzeigen, Aktualisieren 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. Im Folgenden 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 einem flexiblen 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>>
sourceDBServerFullyQualifiedDomainName Nur erforderlich, wenn die Quelle ein einzelner Server ist und sich hinter einem benutzerdefinierten DNS-Server, benutzerdefinierten DNS-Namespaces, benutzerdefinierten FQDN befindet oder über IP zugänglich sein muss.
targetDBServerFullyQualifiedDomainName Nur erforderlich, wenn das Ziel hinter einem benutzerdefinierten DNS-Server, benutzerdefinierten DNS-Namespaces, benutzerdefiniertem FQDN oder über IP zugänglich sein muss.
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

Verwandte Inhalte

  • Last updated on