Migrationsjob zu einer vorhandenen Zielinstanz erstellen

Der Database Migration Service verwendet Migrationsjobs, um Daten aus der Quelldatenbankinstanz in die Zieldatenbankinstanz zu migrieren. Das Erstellen eines Migrationsjobs für eine vorhandene Zielinstanz umfasst Folgendes:

  • Einstellungen für den Migrationsjob festlegen
  • Verbindungsprofil für die Quelldatenbank auswählen
  • Vorhandene Zieldatenbankinstanz auswählen
  • Herabstufen der vorhandenen Instanz, um sie in ein Lesereplikat umzuwandeln
  • Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten
  • Den Migrationsjob testen, um zu überprüfen, ob die für den Job angegebenen Verbindungsinformationen gültig sind

Hinweis

Bevor Sie einen Migrationsjob zu einer vorhandenen Zieldatenbankinstanz erstellen, müssen Sie Folgendes tun:

  1. Prüfen Sie, ob dieser Migrationstyp Ihr Szenario unterstützt. Wenn Sie beispielsweise zu einer Datenbank migrieren möchten, die außerhalb von Database Migration Service erstellt wurde, muss die Cloud SQL-Zielinstanz leer sein oder nur Systemkonfigurationsdaten enthalten. Weitere Informationen finden Sie unter Bekannte Einschränkungen.
  2. Erstellen Sie die erforderlichen Ressourcen, konfigurieren Sie Ihre Quelldatenbank und stellen Sie eine Netzwerkverbindung her. Das Erstellen eines Migrationsjobs ist einer der Schritte im vollständigen Migrationsprozess. Wir empfehlen Ihnen, die Schritt-für-Schritt-Anleitung zur Migration zu befolgen und zu diesem Verfahren zurückzukehren, wenn Sie den Schritt „Migrationsjob“ erreicht haben. Weitere Informationen finden Sie unter Zu einer vorhandenen Instanz migrieren.

Migrationsjob mit der Google Cloud Console erstellen

Wenn Sie mit der Google Cloud Console zu einer vorhandenen Instanz migrieren, verwaltet Database Migration Service das Zielverbindungsprofil automatisch für Sie. So erstellen Sie einen Migrationsjob zu einer vorhandenen Instanz mit der Google Cloud 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 Erste Schritte 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 des Database Migration Service zu arbeiten.

    3. Wählen Sie in der Liste Quelldatenbankmodul die Option MySQL aus.

      Das Feld Zieldatenbankmodul wird automatisch ausgefüllt und kann nicht geändert werden.

    4. 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, Zieldatenbanken), in einer einzigen Region gespeichert werden müssen. Wählen Sie die Region basierend auf dem Standort der Dienste aus, die Ihre Daten benötigen, z. B. Compute Engine-Instanzen oder App Engine-Anwendungen und andere Dienste. Nachdem Sie die Zielregion ausgewählt haben, kann diese Auswahl nicht mehr geändert werden.

  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 Konfiguration für vollständigen Dump anpassen auf Konfiguration bearbeiten.
  3. Wählen Sie im Bereich Konfiguration für vollständigen Dump bearbeiten im Drop-down-Menü Methode für vollständigen Dump eine der folgenden Optionen aus:
    • Physisch: Wählen Sie diese Option aus, wenn Sie das Dienstprogramm Percona XtraBackup verwenden möchten, um eine eigene Sicherungsdatei bereitzustellen. Dieser Ansatz erfordert zusätzliche Vorbereitungsschritte. Eine vollständige Anleitung zur Verwendung von physischen Sicherungsdateien, die von Percona XtraBackup generiert wurden, finden Sie unter Datenbanken mit einer physischen Percona XtraBackup-Datei migrieren.
    • Logisch basiert: Wählen Sie diese Option aus, wenn Sie eine logische Sicherungsdatei verwenden möchten, die mit dem Dienstprogramm mysqldump erstellt wurde. Database Migration Service kann diese Sicherungsdatei automatisch für Sie generieren oder Sie können eine eigene Kopie bereitstellen.
  4. Bearbeiten Sie die restlichen Dump-Einstellungen. Führen Sie einen der folgenden Schritte aus:
    • Wenn Sie die physische Sicherungsdatei verwenden, klicken Sie unter Ordner angeben auf Durchsuchen und wählen Sie den Ordner aus, in den Sie die vollständige Dump-Datei hochgeladen haben. Wählen Sie den dedizierten Ordner aus, der die Vollsicherungsdatei enthält, und nicht den Storage-Bucket selbst.

    • Wenn Sie eine logische Sicherungsdatei verwenden, konfigurieren Sie die Parallelität des Datendumps oder die Dump-Flags.

      Maximieren Sie diesen Abschnitt, um die vollständigen Schritte für die logische Sicherung von Dateien einzublenden.

      Verwenden Sie im Abschnitt Legen Sie fest, wie die Dumpdatei generiert werden soll eine der folgenden Optionen:

      1. Automatisch generiert (empfohlen)

        Diese Option wird empfohlen, da Database Migration Service immer eine erste Datenbank-Dumpdatei generiert, nachdem der Migrationsjob erstellt und gestartet wurde.

        Database Migration Service verwendet diese Datei, um die ursprünglichen Objektdefinitionen und Tabellendaten Ihrer Quelldatenbank zu reproduzieren, damit diese Informationen in eine Cloud SQL-Zieldatenbankinstanz migriert werden können.

        Wenn Sie den automatisch generierten Dump verwenden, wählen Sie im Abschnitt Datendumpvorgang konfigurieren den Vorgangstyp aus, den Database Migration Service ausführen soll:

        • Parallelität des Datendumps: Verwenden Sie eine leistungsstarke Parallelitätsoption, die bei der Migration zu MySQL-Versionen 5.7 oder 8 verfügbar ist.

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

          • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank.
          • Maximum: Bietet die höchsten Dump-Geschwindigkeiten, kann aber zu einer erhöhten Belastung der Quelldatenbank führen.
          • Minimum: Beansprucht die geringste Menge an Rechenressourcen in der Quelldatenbank, kann aber einen langsameren Dump-Durchsatz haben.
        • Dump-Flags: Diese Option schließt sich mit Datendump-Parallelität gegenseitig aus. Mit dieser Einstellung können Sie Flags für das Dienstprogramm mysqldump, das zum Erstellen der Dumpdatei verwendet wird, direkt konfigurieren.

          So fügen Sie ein Flag hinzu:

          1. Klicken Sie auf Flag hinzufügen.

          2. Wählen Sie eines der folgenden Flags aus:

            • add-locks:: Dieses Flag umschließt jede Tabelle, die in der Dumpdatei enthalten ist, mit LOCK TABLES- und UNLOCK TABLES-Anweisungen. Dies führt zu schnelleren Einfügungen, wenn die Dumpdatei in die Zielinstanz geladen wird.
            • ignore-error: Mit diesem Flag können Sie eine Liste von kommagetrennten Fehlernummern eingeben. Diese Zahlen stehen für die Fehler, die das Dienstprogramm mysqldump ignoriert.
            • max-allowed-packet: Mit diesem Flag legen Sie die maximale Größe des Puffers für die Kommunikation zwischen dem MySQL-Client und der MySQL-Quelldatenbank fest. Die Standardgröße des Puffers beträgt 24 MB, die maximale Größe 1 GB.
          3. Klicken Sie auf FERTIG.
          4. Wiederholen Sie diese Schritte für jedes Flag, das Sie hinzufügen möchten.

          Wenn Sie ein Flag entfernen möchten, klicken Sie rechts neben der Zeile mit dem Flag auf das Papierkorbsymbol.

      2. Eigene bereitstellen

        Diese Option wird nicht empfohlen, da Database Migration Service standardmäßig im Rahmen der Ausführung des Migrationsjobs einen ersten Dump ausführt.

        Wenn Sie Ihre eigene Dumpdatei verwenden möchten, wählen Sie Eigene Datei bereitstellen aus, klicken Sie auf DURCHSUCHEN, wählen Sie Ihre Datei (oder den gesamten Cloud Storage-Ordner, wenn Sie mehrere Dateien verwenden) aus und klicken Sie dann auf AUSWÄHLEN.

        Der Dump muss innerhalb der letzten 24 Stunden generiert worden sein und den Dump-Anforderungen entsprechen.

  5. Klicken Sie auf Speichern und fortfahren.

Cloud SQL-Zielinstanz auswählen

  1. Wählen Sie im Menü Typ der Zielinstanz die Option Vorhandene Instanz aus.
  2. Wählen Sie im Abschnitt Zielinstanz auswählen die Zielinstanz aus.

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

    Für die Migration zu einer vorhandenen Zieldatenbank stuft Database Migration Service die Zielinstanz herab und konvertiert sie in ein Replikat. Geben Sie im Bestätigungsfenster die Kennung der Zielinstanz ein, um zu bestätigen, dass die Herabstufung sicher durchgeführt werden kann.

  4. Klicken Sie auf Bestätigen und fortfahren.

Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten

Wählen Sie im Drop-down-Menü Verbindungsmethode eine Methode für die Netzwerkverbindung aus. Diese Methode definiert, wie die neu erstellte Cloud SQL-Instanz eine Verbindung zur Quelldatenbank herstellt. Zu den aktuellen Methoden für die Netzwerkverbindung gehören IP-Zulassungslisten, umgekehrte SSH-Tunnel, Private Service Connect-Schnittstellen und VPC-Peering.

Wenn Sie Folgendes verwenden möchten…Vorgehensweise
Die Netzwerkverbindungsmethode „IP-Zulassungsliste“ Sie müssen die ausgehende IP-Adresse Ihrer Zielinstanz angeben. Wenn die von Ihnen erstellte Cloud SQL-Instanz eine Hochverfügbarkeitsinstanz ist, geben Sie die ausgehenden IP-Adressen sowohl für die primäre als auch für die sekundäre Instanz an.
Die Netzwerkverbindungsmethode „Umgekehrter SSH-Tunnel“ Sie müssen die Compute Engine-VM-Instanz auswählen, die den Tunnel hosten 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. Sie müssen das Skript in der Google Cloud CLI ausführen.

Führen Sie die Befehle 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 die Private Service Connect-fähige Instanz mit einem Netzwerkanhang haben. Weitere Informationen zu Private Service Connect-Schnittstellen finden Sie in der Cloud SQL-Dokumentation unter Ausgehende Private Service Connect-Verbindungen.
Die VPC-Peering-Netzwerkverbindungsmethode, Sie müssen das VPC-Netzwerk auswählen, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, um eine Verbindung zu diesem Netzwerk herzustellen.

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. Die Zielinstanz darf keine Datenbanken enthalten, die denselben Namen wie die Datenbanken haben, die Sie für die Migration auswählen. Wenn Database Migration Service auf einen Datenbanknamenskonflikt stößt, wird die betroffene Datenbank vor der Migration im Ziel gelöscht.

  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, können Sie die angezeigte Liste filtern und die Datenbanken auswählen, die Database Migration Service zu Ihrem 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, können Sie das Problem an der entsprechenden Stelle des Ablaufs beheben und zum erneuten Test zurückkehren. Informationen zur Fehlerbehebung bei einem fehlgeschlagenen Migrationsjobtest finden Sie unter Probleme für MySQL 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 der Zielinstanz in Rechnung gestellt.

    Die Migration wird jetzt ausgeführt. Wenn Sie den Migrationsjob starten, beginnt Database Migration Service mit dem vollständigen Dump und sperrt die Quelldatenbank kurzzeitig. Wenn sich Ihre Quelle in Amazon RDS oder Amazon Aurora befindet, erfordert der Database Migration Service zusätzlich eine kurze (ca. eine Minute) Unterbrechung der Schreibvorgänge zu Beginn der Migration. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

  3. Fahren Sie mit Migrationsjob prüfen fort.

Migrationsjob mit der Google Cloud CLI erstellen

Wenn Sie mit der Google Cloud CLI zu einer vorhandenen Instanz migrieren, müssen Sie das Verbindungsprofil für die Zielinstanz manuell erstellen. Dies ist nicht erforderlich, wenn Sie die Google Cloud Console verwenden, da Database Migration Service das Erstellen und Entfernen des Zielverbindungsprofils für Sie übernimmt.

Zielverbindungsprofil erstellen

Erstellen Sie das Zielverbindungsprofil für Ihre vorhandene Zielinstanz, indem Sie den Befehl gcloud database-migration connection-profiles create ausführen:

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:

  • CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennung für Ihr Verbindungsprofil.
  • REGION durch die Kennung der Region, in der Sie das Verbindungsprofil speichern möchten.
  • DESTINATION_INSTANCE_ID durch die Instanz-ID Ihrer Zielinstanz.
  • (Optional) CONNECTION_PROFILE_NAME durch einen menschenlesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

Windows (PowerShell)

gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Sie sollten eine Antwort ähnlich der folgenden erhalten:

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

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

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Migrationsjob erstellen

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 Regionskennung, 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.
  • 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= \

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= `

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= ^

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]

Zieldatenbank herabstufen

Database Migration Service erfordert, dass die Zieldatenbankinstanz während der Migration als Lesereplikat fungiert. Bevor Sie den Migrationsjob starten, führen Sie den Befehl gcloud database-migration migration-jobs demote-destination aus, um die Zieldatenbankinstanz herabzustufen.

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 Verbindungsprofil 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:

Migrationsjobs verwalten

An dieser Stelle ist Ihr Migrationsjob konfiguriert und mit Ihrer Zieldatenbankinstanz verbunden. Sie können sie mit den Vorgängen verify, start, stop, restart und resume verwalten.

Migrationsjob prüfen

Wir empfehlen, den Migrationsjob zuerst mit dem Befehl gcloud database-migration migration-jobs verify zu prüfen.

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 Verbindungsprofil 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:

Migrationsjob starten

Starten Sie den Migrationsjob mit dem Befehl 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 Verbindungsprofil 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:

Migrationsjob hochstufen

Sobald die Migration die CDC-Phase (Change Data Capture) erreicht, können Sie die Zieldatenbankinstanz von einem Lesereplikat zu einer eigenständigen Instanz hochstufen. Zum Abrufen der aktuellen Richtlinie führen Sie den Befehl gcloud database-migration migration-jobs promote aus:

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 Verbindungsprofil 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: 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: