Migrationsjob zu einer vorhandenen Zielinstanz erstellen

MySQL   |  PostgreSQL   |  PostgreSQL zu AlloyDB

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:

• Einstellungen für den Migrationsjob festlegen
• Verbindungsprofil der Quelldatenbank auswählen
• Vorhandene Zieldatenbankinstanz auswählen
• Vorhandene Instanz herabstufen, 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

Es gibt bestimmte Einschränkungen, die Sie beachten sollten, wenn Sie zu einer Zielinstanz migrieren möchten, die außerhalb von Database Migration Service erstellt wurde. Ihre Cloud SQL-Ziekinstanz muss beispielsweise leer sein oder nur Systemkonfigurationsdaten enthalten. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

Einstellungen für den Migrationsjob festlegen

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

   Migrationsjobs aufrufen

2. Klicken Sie auf Migrationsjob erstellen.

   Die Seite mit dem Konfigurationsassistenten für den Migrationsjob wird geöffnet. Dieser Assistent enthält mehrere Bereiche, in denen Sie durch die einzelnen Konfigurationsschritte geführt werden.

   Sie können die Erstellung eines Migrationsjobs jederzeit pausieren, indem Sie auf SPEICHERN UND SCHLIESSEN klicken. Alle Daten, die Sie bis zu diesem Punkt eingeben, werden in einem Migrationsjob-Entwurf gespeichert. Sie können den Migrationsauftrag im Entwurfsstatus später fertigstellen.

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

      Dies ist ein für Menschen lesbarer 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 zu arbeiten, indem Sie die Google Cloud CLI-Befehle oder die API des Database Migration Service verwenden.

   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.

      Der Database Migration Service ist ein vollständig regionales Produkt. Das bedeutet, dass alle mit der Migration verbundenen Entitäten (Quell- und Zielverbindungsprofile, Migrationsjobs, Zieldatenbanken) in einer einzigen Region gespeichert werden müssen. Wählen Sie die Region anhand des Standorts der Dienste aus, die Ihre Daten benötigen, z. B. Compute Engine-Instanzen, App Engine-Anwendungen und andere Dienste. Nachdem Sie die Zielregion ausgewählt haben, kann diese Auswahl nicht mehr geändert werden.

      Wichtig:Wenn Sie die Cloud SQL for MySQL Enterprise Plus-Version verwenden möchten, prüfen Sie, ob Ihre Region für diese Version unterstützt wird. Weitere Informationen finden Sie unter Regionsunterstützung für Cloud SQL for MySQL Enterprise Plus.
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 Bereich 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 basiert: Wählen Sie diese Option aus, wenn Sie das Percona XtraBackup-Dienstprogramm verwenden möchten, um Ihre eigene Sicherungsdatei bereitzustellen. Dieser Ansatz erfordert zusätzliche Vorbereitungsschritte. Eine vollständige Anleitung zur Verwendung von physischen Sicherungsdateien, die mit Percona XtraBackup generiert wurden, finden Sie unter Datenbanken mit einer physischen Percona XtraBackup-Datei migrieren.
   • Logisch: 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 dem Sie die Full-Dump-Datei hochgeladen haben. Wählen Sie den Ordner aus, der die vollständige Sicherungsdatei enthält, und nicht den Speicher-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 Sicherungsdatei zu sehen.

     Wählen Sie im Bereich Legen Sie fest, wie die Dumpdatei generiert werden soll eine der folgenden Optionen aus:

     1. Automatisch generiert (empfohlen)

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

        Der 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 Bereich Datendumpvorgang konfigurieren den Vorgang 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.
          Wenn Sie den Parallelismus für Datendumps verwenden, müssen Sie für Ihr Szenario die erforderlichen Berechtigungen für die Quelldatenbank angeben (z. B. LOCK_TABLES). Weitere Informationen zu den erforderlichen Berechtigungen für Quelldatenbanken finden Sie unter Quelldatenbank konfigurieren.

          Die Geschwindigkeit der Datenparallelität hängt von der Auslastung Ihrer Quelldatenbank ab:

          • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank.
          • Maximal: Bietet die höchste Dumpgeschwindigkeit, kann aber zu einer erhöhten Belastung der Quelldatenbank führen.
          • Minimum: Beansprucht die geringste Menge an Rechenressourcen in der Quelldatenbank, hat aber möglicherweise einen langsameren Dump-Durchsatz.
        • Dump-Flags: Diese Option ist nicht mit Datendump-Parallelität kompatibel. Mit dieser Einstellung können Sie Flags direkt für das Dienstprogramm mysqldump konfigurieren, mit dem die Dumpdatei erstellt wird.

          So fügen Sie ein Flag hinzu:

          1. Klicken Sie auf Flag hinzufügen.

          2. Wählen Sie eine der folgenden Markierungen aus:

             • add-locks: Dieses Flag umgibt 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 durch Kommas getrennten Fehlernummern eingeben. Diese Zahlen stehen für die Fehler, die vom mysqldump-Dienstprogramm ignoriert werden.
             • max-allowed-packet: Mit diesem Flag wird die maximale Größe des Buffers für die Kommunikation zwischen dem MySQL-Client und der Quell-MySQL-Datenbank festgelegt. Die Standardgröße des Puffers beträgt 24 MB, die maximale Größe 1 GB.
               Wenn Sie in den Tabellen der Quelldatenbank große BLOB-Spalten oder lange Strings verwenden, müssen Sie die Größe des Puffers für dieses Flag erhöhen.
             Weitere Informationen zu diesen Flags finden Sie in der Dokumentation zum Dienstprogramm mysqldump im MySQL 8.0-Referenzhandbuch.
          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 auf das Papierkorbsymbol rechts neben der Zeile, die das Flag enthält.

     2. Eigene bereitstellen

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

        Wenn Sie Ihre eigene Dumpdatei verwenden möchten, wählen Sie Eigene Datei angeben aus, klicken Sie auf SUCHEN, wählen Sie die 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 erstellt worden sein und den Anforderungen an Dumpdateien 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 Ziel-Instanz auswählen die Zielinstanz aus.
3. Prüfen Sie die Informationen im Abschnitt Instanzdetails und klicken Sie auf Auswählen und fortfahren.
4. Wenn Sie zu einer vorhandenen Zieldatenbank migrieren, stuft der Database Migration Service die Zielinstanz herab und konvertiert sie in ein Replikat. Geben Sie im Bestätigungsfenster die ID der Zielinstanz ein, um zu bestätigen, dass die Degradierung sicher durchgeführt werden kann.
5. Klicken Sie auf Bestätigen und fortfahren.

Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten

Wählen Sie im Drop-down-Menü Verbindungsmethode eine Netzwerkverbindungsmethode aus. Diese Methode definiert, wie die neu erstellte Cloud SQL-Instanz mit der Quelldatenbank verbunden wird. Zu den aktuellen Netzwerkverbindungsmethoden gehören IP-Zulassungsliste, Reverse-SSH-Tunnel und VPC-Peering.

Sie möchten…	Gehen Sie dann so vor:
Die Netzwerkverbindungsmethode „IP-Zulassungsliste“	Sie müssen die ausgehende IP-Adresse der Zielinstanz angeben. Wenn die von Ihnen erstellte Cloud SQL-Instanz eine Hochverfügbarkeits-Instanz 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, auf der der Tunnel gehostet wird. Nachdem Sie die Instanz angegeben haben, stellt Google ein Script zur Verfügung, mit dem der Tunnel zwischen der Quell- und der Zieldatenbank eingerichtet wird. Sie müssen das Script in der Google Cloud CLI ausführen. Führen Sie die Befehle auf einem Computer aus, der sowohl eine Verbindung zur Quelldatenbank als auch zu Google Cloudhat.
Die Netzwerkverbindungsmethode „VPC-Peering“	Sie müssen das VPC-Netzwerk auswählen, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, damit eine Verbindung mit diesem Netzwerk hergestellt wird.

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

Migrationsjob testen, erstellen und ausführen

In diesem letzten Schritt sehen Sie sich die Zusammenfassung der Einstellungen, der Quelle, des Ziels und der Verbindungsmethode des Migrationsjobs an und testen dann die Gültigkeit der Konfiguration des Migrationsjobs. Falls 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 Test eines Migrationsjobs finden Sie unter Probleme für MySQL diagnostizieren.

2. Klicken Sie nach Abschluss des Tests 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 direkt nach dem Erstellen gestartet wird, können Sie ihn auf der Seite Migrationsjobs durch Klicken auf STARTEN starten. Unabhängig davon, wann der Migrationsjob gestartet wird, wird Ihrer Organisation die Existenz der Zielinstanz in Rechnung gestellt.

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

   Achtung:Wenn Sie Ihre Zieldatenbank mit Terraform bereitgestellt haben, kann es während der Ausführung des Migrationsjobs zu Konfigurationsabweichungen kommen. Versuchen Sie nicht, die Terraform-Einstellungen noch einmal anzuwenden, bevor die Migration abgeschlossen ist. Weitere Informationen finden Sie unter Abweichungen bei Terraform-Konfigurationen.
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. Wenn Sie die Google Cloud Console verwenden, ist das nicht erforderlich, da das Zielverbindungsprofil vom Database Migration Service für Sie erstellt und entfernt wird.

Hinweis

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

• Erstellen Sie die Zieldatenbankinstanz.
• Quelldatenbankinstanz vorbereiten Siehe:
  • Quelle konfigurieren
  • Erstellen Sie das Quellverbindungsprofil. Die ID des Quellverbindungsprofils ist erforderlich, um einen Migrationsjob zu erstellen.
  • Konnektivität konfigurieren

Zielverbindungsprofil erstellen

Erstellen Sie das Zielverbindungsprofil für Ihre vorhandene Zielinstanz. Führen Sie dazu den Befehl gcloud database-migration connection-profiles create aus:

In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass einige Befehle einige Zeit in Anspruch nehmen können. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe prüfen, ob der Vorgang erfolgreich war.

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

• CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung für Ihr Verbindungsprofil.
• REGION durch die Kennung der Region ersetzen, in der Sie das Verbindungsprofil speichern möchten.
• DESTINATION_INSTANCE_ID durch die Instanz-ID der Zielinstanz.
• Optional: CONNECTION_PROFILE_NAME mit einem von Menschen lesbaren 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

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Hinweis: Die folgenden Beispiele stellen ein Migrationsszenario dar, bei dem Sie die private IP-Verbindung zwischen der Quell- und der Zieldatenbank verwenden. Wenn Sie einen anderen Verbindungstyp verwenden (z. B. VPC-Peering oder einen umgekehrten SSH-Tunnel), fügen Sie die erforderlichen Flags hinzu, z. B. --peer-vpc oder --vm, --vm-ip, --vm-port, --vpc. Weitere Informationen finden Sie unter Verbindung konfigurieren und Beispiele für die Google Cloud CLI.

In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass einige Befehle einige Zeit in Anspruch nehmen können. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe 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 zu arbeiten, indem Sie die Google Cloud CLI-Befehle oder die API des Database Migration Service verwenden.
• REGION durch die Regionskennung ersetzen, in der Sie den Migrationsjob speichern möchten.
• MIGRATION_JOB_NAME durch einen für Menschen lesbaren Namen für den Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
• SOURCE_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Quellverbindungsprofils.
• DESTINATION_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Zielverbindungsprofils.
• MIGRATION_JOB_TYPE durch den Typ des Migrationsjobs. Es sind zwei Werte zulässig: ONE_TIME oder CONTINUOUS. Weitere Informationen finden Sie unter Migrationstypen.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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=MIGRATION_JOB_TYPE \

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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=MIGRATION_JOB_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 degradieren

Für den Database Migration Service muss die Zieldatenbankinstanz während der Migration als Lesereplika funktionieren. Führen Sie vor dem Starten des Migrationsjobs 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 ID 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 IDs aufrufen.

• REGION mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 lang andauernden Vorgang 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

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

• Verwenden Sie den Befehl gcloud database-migration migration-jobs describe, um den Status des Migrationsjobs aufzurufen.
• Verwenden Sie gcloud database-migration operations describe mit OPERATION_ID, um den Status des Vorgangs selbst aufzurufen.

Migrationsjobs verwalten

Ihr Migrationsjob ist jetzt konfiguriert und mit der 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 ID 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 IDs aufrufen.

• REGION mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 lang andauernden Vorgang 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

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

• Verwenden Sie den Befehl gcloud database-migration migration-jobs describe mit MIGRATION_JOB_ID, um den Status des Migrationsjobs aufzurufen.
• Verwenden Sie den Befehl gcloud database-migration operations describe mit OPERATION_ID, um den Status des Vorgangs selbst aufzurufen.

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 ID 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 IDs aufrufen.

• REGION mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 lang andauernden Vorgang 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

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

• Verwenden Sie den Befehl gcloud database-migration migration-jobs describe mit MIGRATION_JOB_ID, um den Status des Migrationsjobs aufzurufen.
• Verwenden Sie den Befehl gcloud database-migration operations describe mit OPERATION_ID, um den Status des Vorgangs selbst aufzurufen.

Migrationsjob hochstufen

Sobald die Migration die CDC-Phase (Change Data Capture) erreicht hat, 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 ID 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 IDs aufrufen.

• REGION mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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 lang andauernden Vorgang 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

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

• Verwenden Sie den Befehl gcloud database-migration migration-jobs describe mit MIGRATION_JOB_ID, um den Status des Migrationsjobs aufzurufen.
• Verwenden Sie den Befehl gcloud database-migration operations describe mit OPERATION_ID, um den Status des Vorgangs selbst aufzurufen.