Migrationsjob zu einem vorhandenen Zielcluster erstellen

Wenn Sie zu einem vorhandenen AlloyDB for PostgreSQL-Zielcluster migrieren, stuft Database Migration Service den Zielcluster herab, um ihn als externes Replikat zu konfigurieren. Durch das Herabstufen eines Clusters wird AlloyDB for PostgreSQL nicht in den Lesemodus versetzt. Das Ausführen bestimmter Vorgänge während des Migrationsprozesses kann jedoch zu Migrationsfehlern führen. Beachten Sie bei der Migration zu einem vorhandenen Zielcluster die folgenden betrieblichen Überlegungen:
  • Cluster-Herabstufung: Database Migration Service stuft den Zielcluster herab, um ihn als Replikat der Quelldatenbank zu konfigurieren.
  • Vermeiden Sie Schreibvorgänge für migrierte Daten: Führen Sie im Zielcluster keine Schreibvorgänge (z. B. INSERT, UPDATE, DELETE oder DDL-Schemaänderungen) für Tabellen oder Datenbanken aus, die in der Migration enthalten sind. Solche Vorgänge können zu Replikationskonflikten mit Daten aus der Quelle führen.
  • Datenbanknutzer verwalten: Sie können Datenbanknutzer jederzeit mit Standard-psql-Befehlen oder über AlloyDB for PostgreSQL in der Google Cloud Console erstellen und verwalten. Weitere Informationen finden Sie in der AlloyDB for PostgreSQL-Dokumentation unter Datenbanknutzer verwalten.

Weitere Informationen finden Sie unter Bekannte Einschränkungen für vorhandene Zielcluster.

Database Migration Service verwendet Migrationsjobs, um Daten aus der Quelldatenbank in den AlloyDB for PostgreSQL-Zielcluster zu migrieren. Das Erstellen eines Migrationsjobs für einen vorhandenen Zielcluster umfasst Folgendes:

  • Einstellungen für den Migrationsjob festlegen
  • Quelleinstellungen definieren und zu migrierende Datenbanken auswählen
  • Vorhandenen AlloyDB for PostgreSQL-Zielcluster auswählen
  • Der vorhandene Cluster wird herabgestuft, um ihn als Replikat der Quelldatenbankzu konfigurieren
  • Verbindung zwischen den Quell- und Zieldatenbanken einrichten
  • Den Migrationsjob testen, um zu überprüfen, ob die angegebenen Verbindungsinformationen gültig sind

Hinweis

Bevor Sie einen Migrationsjob zu einem vorhandenen AlloyDB for PostgreSQL-Zielcluster erstellen, müssen Sie Folgendes tun:

  1. Prüfen Sie, ob dieser Migrationstyp Ihr Szenario unterstützt. Wenn Sie beispielsweise zu einem Cluster migrieren möchten, der außerhalb von Database Migration Service erstellt wurde, muss der AlloyDB for PostgreSQL-Zielcluster leer sein oder nur Systemkonfigurationsdaten enthalten. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

  2. Erstellen Sie den AlloyDB for PostgreSQL-Zielcluster und die zugehörige primäre Instanz. Weitere Informationen finden Sie in der AlloyDB for PostgreSQL-Dokumentation unter Cluster und zugehörige primäre Instanz erstellen.

  3. Bereiten Sie die Quelldatenbankinstanz vor. Weitere Informationen finden Sie auf den folgenden Seiten:
    1. Quelldatenbank konfigurieren
    2. Quellverbindungsprofil erstellen
    3. Konnektivität konfigurieren

So erstellen Sie einen Migrationsjob für einen vorhandenen Zielcluster:

Console

Einstellungen für den Migrationsjob festlegen

  1. Rufen Sie in der Google Cloud Console die Seite Migrationsjobs auf.

    Zu Migrationsjobs

  2. Klicken Sie auf Migrationsjob erstellen.

    Die Seite des Konfigurationsassistenten für Migrationsjobs wird geöffnet. Dieser Assistent enthält mehrere Bereiche, die Sie durch die einzelnen Konfigurationsschritte führen.

    Sie können die Erstellung eines Migrationsjobs jederzeit pausieren, indem Sie auf Speichern und beenden klicken. Alle Daten, die Sie bis zu diesem Zeitpunkt eingeben, werden in einem Migrationsjobentwurf gespeichert. Sie können den Migrationsjobentwurf später fertigstellen.

  3. Geben Sie auf der Seite Einstieg die folgenden Informationen ein:
    1. Name des Migrationsjobs

      Dies ist ein menschenlesbarer Name für Ihren Migrationsjob. Dieser Wert wird in der Google Cloud Console angezeigt.

    2. Migrationsjob-ID

      Dies ist eine maschinenlesbare Kennung für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs über Google Cloud CLI-Befehle oder die API von Database Migration Service zu arbeiten.

    3. Wählen Sie in der Liste Quelldatenbankmodul die Option PostgreSQL aus.
    4. Wählen Sie in der Liste Zieldatenbankmodul die Option AlloyDB for PostgreSQL aus.
    5. Wählen Sie die Region aus, in der Sie den Migrationsjob speichern möchten.

      Database Migration Service ist ein vollständig regionales Produkt. Das bedeutet, dass alle Entitäten, die mit Ihrer Migration zusammenhängen (Quell- und Zielverbindungsprofile, Migrationsjobs, Zielcluster), in einer einzigen Region gespeichert werden müssen. Wählen Sie die Region aus, in der sich Ihr vorhandener Zielcluster befindet. Nachdem Sie die Zielregion ausgewählt haben, kann diese Auswahl nicht mehr geändert werden.

    6. Wählen Sie als Typ des Migrationsjobs Kontinuierlich (Snapshot + laufende Änderungen) aus. Homogene Migrationen zu AlloyDB for PostgreSQL unterstützen ausschließlich kontinuierliche Migrationen.
  4. Klicken Sie auf Speichern und fortfahren.

Informationen zum Quellverbindungsprofil angeben

Führen Sie auf der Seite Quelle definieren die folgenden Schritte aus:

  1. Wählen Sie im Drop-down-Menü Quellverbindungsprofil das Verbindungsprofil für Ihre Quelldatenbank aus.
  2. Klicken Sie im Abschnitt Parallelitätskonfigurationen anpassen auf Parallelitätskonfigurationen einblenden.

    Während des ersten vollständigen Dumps repliziert die pglogical-Erweiterung Daten auf Tabellenebene und teilt eine einzelne nicht partitionierte Tabelle, Blattpartition oder Tabelle ohne Primärschlüssel nicht auf mehrere Abos auf. Das bedeutet, dass die erweiterte Parallelität von Daten-Dumps die anfängliche Dump-Geschwindigkeit für eine einzelne große, nicht partitionierte Tabelle nicht erhöhen kann, da diese Tabelle innerhalb eines Abos kopiert wird. Weitere Informationen finden Sie unter Überlegungen zur Parallelität von Daten-Dumps.

    Die Geschwindigkeit der Datendump-Parallelität hängt von der Last ab, die auf Ihre Quelldatenbank ausgeübt wird:

    • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank. Database Migration Service erstellt bis zu zwei Abos pro Datenbank (insgesamt bis zu zwei Abos für alle Datenbanken, mit mindestens einem Abo pro migrierter Datenbank).
    • Maximum: Bietet die höchsten Dump-Geschwindigkeiten, kann aber zu einer erhöhten Belastung der Quelldatenbank führen. Database Migration Service erstellt bis zu 4 Abos pro Datenbank (insgesamt bis zu 4 Abos für alle Datenbanken, mit mindestens 1 Abo pro migrierter Datenbank).
    • Minimum: Beansprucht die geringste Menge an Rechenressourcen in der Quelldatenbank, kann aber einen langsameren Dump-Durchsatz haben. Database Migration Service erstellt ein Abo pro Datenbank.

    Wenn Sie angepasste Einstellungen für die Parallelität des Datendumps auswählen, müssen Sie die Parameter max_replication_slots, max_wal_senders und max_worker_processes in Ihrer Quelldatenbank erhöhen.

  3. Klicken Sie auf Speichern und fortfahren.

AlloyDB for PostgreSQL-Zielcluster auswählen

  1. Wählen Sie im Menü Typ der Zielinstanz die Option Vorhandener Cluster aus.
  2. Wählen Sie im Abschnitt Zielcluster auswählen den AlloyDB for PostgreSQL-Zielcluster aus.

  3. Prüfen Sie die Informationen im Abschnitt Clusterdetails und klicken Sie auf Auswählen und fortfahren.

    Für die Migration zu einer vorhandenen Zieldatenbank stuft Database Migration Service den Zielcluster herab und konfiguriert ihn als Replikat. Geben Sie im Bestätigungsfenster die Kennung des Zielclusters ein, um zu bestätigen, dass die Herabstufung sicher durchgeführt werden kann.

  4. Klicken Sie auf Bestätigen und fortfahren.

Verbindung zwischen der Quelldatenbankinstanz und dem Zielcluster einrichten

Wählen Sie im Drop-down-Menü Verbindungsmethode eine Methode für die Netzwerkverbindung aus. Diese Methode definiert, wie der AlloyDB for PostgreSQL-Zielcluster eine Verbindung zur Quelldatenbank herstellt. Zu den aktuellen Methoden für die Netzwerkverbindung gehören IP-Zulassungslisten, umgekehrte SSH-Tunnel, Private Service Connect-Schnittstellen, VPC-Peering und TCP-Proxys über eine in der Cloud gehostete VM.

Wenn Sie Folgendes verwenden möchten…Vorgehensweise
Die Netzwerkverbindungsmethode „IP-Zulassungsliste“ Kopieren Sie beide ausgehenden öffentlichen IP-Adressen der primären Instanz Ihres Zielclusters und konfigurieren Sie damit die Netzwerkfirewall für Ihren Quelldatenbankserver und in der Datei pg_hba.conf.
Die Netzwerkverbindungsmethode „Umgekehrter SSH-Tunnel“ Wählen Sie die Compute Engine-VM-Instanz aus, auf der der Tunnel gehostet werden soll.

Nachdem Sie die Instanz angegeben haben, stellt Google ein Script bereit, mit dem die Schritte zum Einrichten des Tunnels zwischen der Quell- und der Zieldatenbank ausgeführt werden. Führen Sie das Skript in der Google Cloud CLI auf einem Computer aus, der sowohl mit der Quelldatenbank als auch mit Google Cloudverbunden ist.
Die Private Service Connect-Schnittstellenverbindungsmethode, Database Migration Service stellt die erforderlichen Verbindungen automatisch her. Diese Verbindungsmethode ist nur verfügbar, wenn Sie einen Private Service Connect-fähigen Zielcluster mit einem Netzwerkanhang haben. Weitere Informationen zu Private Service Connect finden Sie unter Private Service Connect konfigurieren in der AlloyDB for PostgreSQL-Dokumentation.
Die VPC-Peering-Netzwerkverbindungsmethode, Wählen Sie das VPC-Netzwerk aus, in dem sich die Quelldatenbank befindet. Der AlloyDB for PostgreSQL-Cluster stellt über den Zugriff auf private Dienste eine Verbindung zu diesem Netzwerk her.
Die Verbindungsmethode „TCP-Proxy über eine in der Cloud gehostete VM“ Geben Sie die erforderlichen Details für die neue Compute Engine-VM-Instanz ein, die den TCP-Proxy hosten soll.

Nachdem Sie die Details angegeben haben, stellt die Google Cloud Konsole ein Script bereit, mit dem der Proxy zwischen der Quell- und der Zieldatenbank eingerichtet wird. Führen Sie das Skript auf einem Computer mit einer aktualisierten Google Cloud CLI aus.

Geben Sie nach dem Ausführen des Skripts die private IP-Adresse der neu erstellten VM ein und klicken Sie auf Konfigurieren und fortfahren.

Nachdem Sie die Netzwerkverbindung ausgewählt und konfiguriert haben, klicken Sie auf Konfigurieren und fortfahren.

Datenbanken für Migration konfigurieren

Sie können alle Datenbanken aus Ihrer Quellinstanz migrieren oder nur bestimmte Datenbanken auswählen.

  1. Wählen Sie in der Liste Zu migrierende Datenbanken eine der folgenden Optionen aus:
    • Alle Datenbanken: Es werden alle Datenbanken ausgewählt, die in der Quelle vorhanden sind.
    • Bestimmte Datenbanken: Sie können bestimmte Datenbanken aus allen Datenbanken auswählen, die in der Quelle vorhanden sind.

  2. Wenn Sie bestimmte Datenbanken migrieren möchten, filtern Sie die angezeigte Liste und wählen Sie die Datenbanken aus, die Database Migration Service zum Ziel migrieren soll.

    Wenn die Liste nicht angezeigt wird und ein Fehler bei der Datenbankerkennung auftritt, klicken Sie auf Aktualisieren. Wenn die Datenbankerkennung fehlschlägt, werden alle Datenbanken migriert. Sie können mit dem Erstellen eines Migrationsjobs fortfahren und Verbindungsfehler später beheben.

  3. Klicken Sie auf Speichern und fortfahren.

Migrationsjob testen, erstellen und ausführen

Prüfen Sie in diesem letzten Schritt die Zusammenfassung der Einstellungen für den Migrationsjob, die Quelle, das Ziel und die Verbindungsmethode und testen Sie dann die Gültigkeit der Einrichtung des Migrationsjobs. Wenn Probleme auftreten, können Sie die Einstellungen des Migrationsjobs ändern. Nicht alle Einstellungen können bearbeitet werden.

  1. Klicken Sie auf der Seite Migrationsjob testen und erstellen auf Job testen.

    Wenn der Test fehlschlägt, beheben Sie das Problem an der entsprechenden Stelle des Ablaufs und führen Sie den Test noch einmal aus. Informationen zur Fehlerbehebung bei einem fehlgeschlagenen Migrationsjobtest finden Sie unter Probleme für AlloyDB for PostgreSQL diagnostizieren.

  2. Wenn der Test des Migrationsjobs abgeschlossen ist, klicken Sie auf Job erstellen und starten, um den Migrationsjob zu erstellen und sofort zu starten, oder auf Job erstellen, um den Migrationsjob zu erstellen, ohne ihn sofort zu starten.

    Wenn der Job nicht zum Zeitpunkt der Erstellung gestartet wird, kann er auf der Seite Migrationsjobs durch Klicken auf Starten gestartet werden. Unabhängig davon, wann der Migrationsjob gestartet wird, werden Ihrer Organisation die Kosten für die Existenz des Zielclusters in Rechnung gestellt.

    Die Migration wird jetzt ausgeführt. Wenn Sie den Migrationsjob starten, beginnt Database Migration Service mit dem ersten vollständigen Dump und der kontinuierlichen Replikation. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

  3. Fahren Sie mit Migrationsjob prüfen fort.

Google Cloud CLI

Wenn Sie mit der Google Cloud CLI zu einem vorhandenen Cluster migrieren, müssen Sie das Verbindungsprofil für den Zielcluster manuell erstellen. Dies ist nicht erforderlich, wenn Sie die Google Cloud -Konsole verwenden, da Database Migration Service das Erstellen und Entfernen des Zielverbindungsprofils für Sie übernimmt.

  1. Erstellen Sie das Zielverbindungsprofil.
    Erstellen Sie das Zielverbindungsprofil für Ihren vorhandenen Zielcluster, indem Sie den Befehl gcloud database-migration connection-profiles create ausführen (klicken Sie auf den Link, um ihn zu maximieren):

    gcloud database-migration connection-profiles create postgresql

    In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie den Befehl gcloud database-migration operations describe verwenden, um zu prüfen, ob der Vorgang erfolgreich war.

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • DEST_CONN_ID durch die Kennung des Zielverbindungsprofils.
    • REGION durch die Region, in der Sie das Verbindungsprofil speichern möchten. Diese Region sollte mit der Region des Zielclusters übereinstimmen.
    • DEST_CLUSTER durch die ID des zuvor erstellten AlloyDB for PostgreSQL-Zielclusters.
    • DEST_USER durch den Nutzernamen des Migrationsnutzers in der Zieldatenbank.
    • DEST_PASSWORD durch das Passwort für den Migrationsnutzer in der Zieldatenbank.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
  --region=REGION \
  --alloydb-cluster=DEST_CLUSTER \
  --username=DEST_USER \
  --password=DEST_PASSWORD \
  --role=DESTINATION \
  --no-async

    Windows (PowerShell)

    gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
  --region=REGION `
  --alloydb-cluster=DEST_CLUSTER `
  --username=DEST_USER `
  --password=DEST_PASSWORD `
  --role=DESTINATION `
  --no-async

    Windows (cmd.exe)

    gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
  --region=REGION ^
  --alloydb-cluster=DEST_CLUSTER ^
  --username=DEST_USER ^
  --password=DEST_PASSWORD ^
  --role=DESTINATION ^
  --no-async

    Sie sollten eine Antwort ähnlich der folgenden erhalten:

    Waiting for connection profile [DEST_CONN_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile DEST_CONN_ID [OPERATION_ID]

  2. Migrationsjob erstellen
    Das folgende Beispiel zeigt ein Migrationsszenario, in dem Sie eine private IP-Verbindung zwischen der Quell- und der Zieldatenbank verwenden. Wenn Sie einen anderen Verbindungstyp verwenden (z. B. IP-Zulassungsliste, VPC-Peering oder einen Reverse-SSH-Tunnel), müssen Sie die erforderlichen Flags hinzufügen, z. B. --static-ip, --peer-vpc oder --vm, --vm-ip, --vm-port und --vpc. Weitere Informationen finden Sie unter Konnektivität konfigurieren und Beispiele für die Google Cloud CLI.
    Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

    gcloud database-migration migration-jobs create

    In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie den Befehl gcloud database-migration operations describe verwenden, um zu prüfen, ob der Vorgang erfolgreich war.

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch eine maschinenlesbare Kennung für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs über Google Cloud CLI-Befehle oder die API des Database Migration Service zu arbeiten.
    • REGION durch die Regions-ID, in der Sie den Migrationsjob speichern möchten.
    • MIGRATION_JOB_NAME durch einen menschenlesbaren Namen für den Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
    • SOURCE_CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennung des Quellverbindungsprofils. Weitere Informationen finden Sie unter Quellverbindungsprofil erstellen.
    • DESTINATION_CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennung des Zielverbindungsprofils.

    • Optional: Database Migration Service migriert standardmäßig alle Datenbanken in Ihrer Quelle. Wenn Sie nur bestimmte Datenbanken migrieren möchten, verwenden Sie das Flag --databases-filter und geben Sie die Kennungen als durch Kommas getrennte Liste an.

      Beispiel: --databases-filter=my-business-database,my-other-database

      Sie können Migrationsjobs, die Sie mit dem Flag --databases-filter erstellt haben, später mit dem Befehl gcloud database-migration migration-jobs update bearbeiten.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS

    Sie sollten eine Antwort ähnlich der folgenden erhalten:

    Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

  3. Stufen Sie die Zieldatenbank herab.
    Für Database Migration Service müssen Sie den vorhandenen Zielcluster herabstufen, um ihn als externes Replikat zu konfigurieren, bevor Sie den Migrationsjob starten. Führen Sie den Befehl gcloud database-migration migration-jobs demote-destination aus (klicken Sie auf den Link, um ihn zu maximieren):

    gcloud database-migration migration-jobs demote-destination

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch die Kennung Ihres Migrationsjobs.

      Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

    • REGION durch die Kennung der Region, in der Ihr Migrationsjob gespeichert ist.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

    Ergebnis

    Die Aktion wird asynchron ausgeführt. Daher gibt dieser Befehl eine Vorgangsentität zurück, die einen Vorgang mit langer Ausführungszeit darstellt: 

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

    Wenn Sie prüfen möchten, ob der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

  4. Optional: Migrationsjob prüfen.
    An dieser Stelle ist Ihr Migrationsjob konfiguriert und mit Ihrem Zielcluster verbunden. Sie können sie mit den Vorgängen verify, start, stop, restart und resume verwalten. Wir empfehlen, den Migrationsjob zuerst mit dem Befehl gcloud database-migration migration-jobs verify zu prüfen (klicken Sie auf den Link, um ihn zu maximieren):

    gcloud database-migration migration-jobs verify

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch die Kennung Ihres Migrationsjobs.

      Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

    • REGION durch die Kennung der Region, in der Ihr Migrationsjob gespeichert ist.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration migration-jobs \
verify MIGRATION_JOB_ID \
  --region=REGION

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
verify MIGRATION_JOB_ID `
  --region=REGION

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
verify MIGRATION_JOB_ID ^
  --region=REGION

    Ergebnis

    Die Aktion wird asynchron ausgeführt. Daher gibt dieser Befehl eine Vorgangsentität zurück, die einen Vorgang mit langer Ausführungszeit darstellt: 

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: verify
name: OPERATION_ID

    Wenn Sie prüfen möchten, ob der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

  5. Migrationsjob starten
    Starten Sie den Migrationsjob mit dem Befehl gcloud database-migration migration-jobs start (klicken Sie auf den Link, um ihn zu maximieren):

    gcloud database-migration migration-jobs start

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch die Kennung Ihres Migrationsjobs.

      Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

    • REGION durch die Kennung der Region, in der Ihr Migrationsjob gespeichert ist.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration migration-jobs \
start MIGRATION_JOB_ID \
  --region=REGION

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
start MIGRATION_JOB_ID `
  --region=REGION

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
start MIGRATION_JOB_ID ^
  --region=REGION

    Ergebnis

    Die Aktion wird asynchron ausgeführt. Daher gibt dieser Befehl eine Vorgangsentität zurück, die einen Vorgang mit langer Ausführungszeit darstellt: 

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

    Wenn Sie prüfen möchten, ob der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

  6. Migrationsjob hochstufen
    Sobald die Migration die CDC-Phase (Change Data Capture) erreicht hat, können Sie den Zielcluster von einem Replikat zu einem eigenständigen primären Cluster hochstufen. Führen Sie den Befehl gcloud database-migration migration-jobs promote aus (klicken Sie auf den Link, um ihn zu maximieren):

    gcloud database-migration migration-jobs promote

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch die Kennung Ihres Migrationsjobs.

      Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

    • REGION durch die Kennung der Region, in der Ihr Migrationsjob gespeichert ist.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

    Ergebnis

    Die Aktion wird asynchron ausgeführt. Daher gibt dieser Befehl eine Vorgangsentität zurück, die einen Vorgang mit langer Ausführungszeit darstellt: 

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: promote
name: OPERATION_ID

    Wenn Sie prüfen möchten, ob der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen: