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

• Einstellungen für den Migrationsjob festlegen
• Quellverbindungsprofil auswählen
• Vorhandene Zieldatenbankinstanz auswählen
• Herabstufen der vorhandenen Instanz, um sie in ein Lesereplikat zu konvertieren
• 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 berücksichtigen sollten, wenn Sie zu einer Zielinstanz migrieren möchten, die außerhalb von Database Migration Service erstellt wurde. Ihre Cloud SQL-Zielinstanz muss beispielsweise leer sein oder darf 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.

   Zu „Migrationsjobs“

2. Klicken Sie auf Migrationsjob erstellen.

   Die Seite des Assistenten für die Konfiguration von Migrationsjobs 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 & BEENDEN klicken. Alle Daten, die Sie bis dahin 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 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 mithilfe von Google Cloud CLI-Befehlen oder der 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 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, muss Ihre Region für diese Version unterstützt werden. 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 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 physischer Sicherungsdateien, die von 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 Einstellungen für den Dump. 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 dann den Ordner aus, in den Sie die vollständige Dump-Datei hochgeladen haben. Wählen Sie den dedizierten 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 logische Sicherungsdatei zu sehen.

     Verwenden Sie im Bereich 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 Bereich Datenbankdump konfigurieren den Vorgangstyp aus, den Database Migration Service ausführen soll:

        • Paralleles Ausgeben von Daten: Verwenden Sie eine leistungsstarke Parallelisierungsoption, die bei der Migration zu MySQL-Version 5.7 oder 8 verfügbar ist.
          Wenn Sie die Parallelität des Datenexports verwenden möchten, müssen Sie die erforderlichen Berechtigungen für die Quelldatenbank für Ihr Szenario 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 Belastung Ihrer Quelldatenbank ab:

          • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank.
          • Maximal: Bietet die höchste Dump-Geschwindigkeit, 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 (Dump-Flags): Diese Option schließt Data dump parallelism (Datendump-Parallelität) aus. Mit dieser Einstellung können Sie Flags 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 umschließt jede Tabelle, die in der Dump-Datei enthalten ist, mit LOCK TABLES- und UNLOCK TABLES-Anweisungen. Dadurch werden Einfügungen beschleunigt, 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 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.
               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 rechts neben der Zeile, die das Flag enthält, auf das Papierkorbsymbol.

     2. Eigene bereitstellen

        Diese Option wird nicht empfohlen, da Database Migration Service standardmäßig einen ersten Dump im Rahmen des Migrationsjobs 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.

        Prüfen Sie, ob der Dump innerhalb der letzten 24 Stunden generiert wurde und den Dumpanforderungen entspricht.

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.
4. Wenn Sie zu einer vorhandenen Zieldatenbank migrieren, 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.
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 eine Verbindung zur Quelldatenbank herstellt. Zu den aktuellen Methoden für die Netzwerkverbindung gehören IP-Zulassungsliste, Reverse-SSH-Tunnel, Private Service Connect-Schnittstellen und VPC-Peering.

Wenn Sie… 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 Instanz mit Hochverfügbarkeit ist, geben Sie die ausgehenden IP-Adressen für die primäre und die sekundäre Instanz an.
Die Methode für die Netzwerkverbindung über umgekehrte 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 Skript zur Verfügung, das die Schritte zum Einrichten des Tunnels zwischen den Quell- und Zieldatenbanken ausführt. 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 Verbindungsmethode für Private Service Connect-Schnittstellen	Database Migration Service stellt die erforderlichen Verbindungen automatisch her. Diese Verbindungsmethode ist nur verfügbar, wenn Sie die Instanz mit aktiviertem Private Service Connect mit einem Netzwerkanhang haben. Weitere Informationen zu Private Service Connect-Schnittstellen finden Sie in der Cloud SQL-Dokumentation unter Private Service Connect-Ausgangsverbindungen.
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

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 mit 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 beginnt, wird Ihrer Organisation die Zielinstanz in Rechnung gestellt.

   Die Migration wird jetzt durchgefü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, ist für Database Migration Service zusätzlich eine kurze Unterbrechung der Schreibvorgänge (ca. unter einer Minute) zu Beginn der Migration erforderlich. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

   Achtung:Wenn Sie Terraform zum Bereitstellen Ihrer Zieldatenbank verwendet haben, kann es während der Ausführung des Migrationsjobs zu Konfigurationsabweichungen kommen. Versuchen Sie nicht, Terraform-Einstellungen noch einmal anzuwenden, bevor die Migration abgeschlossen ist. Weitere Informationen finden Sie unter Terraform-Konfigurationsabweichung.
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 -Konsole verwenden, da Database Migration Service das Zielverbindungsprofil für Sie erstellt und entfernt.

Hinweise

Bevor Sie mit der gcloud CLI einen Migrationsjob für eine vorhandene Zieldatenbankinstanz erstellen, müssen Sie Folgendes tun:

• Erstellen Sie die Instanz für Ihre Zieldatenbank.
• Bereiten Sie Ihre Quelldatenbankinstanz vor. Siehe:
  • Quelle konfigurieren
  • Quellverbindungsprofil erstellen (Die Kennung des Quellverbindungsprofils ist erforderlich, um einen Migrationsjob zu erstellen.)
  • Konnektivität konfigurieren

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 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 durch eine maschinenlesbare Kennung für Ihr Verbindungsprofil.
• Ersetzen Sie REGION durch die Kennung der Region, in der Sie das Verbindungsprofil speichern möchten.
• DESTINATION_INSTANCE_ID durch die Instanz-ID Ihrer Zielinstanz.
• (Optional) Ersetzen Sie CONNECTION_PROFILE_NAME durch einen für 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, in dem Sie die Verbindung über private IP-Adressen zwischen den Quell- und Zieldatenbanken verwenden. Wenn Sie einen anderen Verbindungstyp verwenden, z. B. VPC-Peering oder einen umgekehrten SSH-Tunnel, fügen Sie die erforderlichen Flags wie --peer-vpc oder --vm, --vm-ip, --vm-port, --vpc hinzu. Weitere Informationen finden Sie unter Verbindung konfigurieren und Google Cloud CLI-Beispiele.

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 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 ID für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs mithilfe von Google Cloud CLI-Befehlen oder der 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 für Menschen lesbaren Namen für Ihren Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
• SOURCE_CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennzeichnung des Quellverbindungsprofils.
• DESTINATION_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Zielverbindungsprofils.

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

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

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

• MIGRATION_JOB_TYPE durch den Typ Ihres Migrationsjobs. Zwei Werte sind zulässig: ONE_TIME oder CONTINUOUS. Weitere Informationen finden Sie unter Migrationsarten.

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 herabstufen

Für Database Migration Service muss die Zieldatenbankinstanz während der Migration als Lesereplikat fungieren. 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 ID Ihres Migrationsjobs.

  Wenn Sie die ID 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 ist die 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 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

Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

• 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 zu sehen.

Migrationsjobs verwalten

An diesem Punkt 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 überprüfen.

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

• MIGRATION_JOB_ID durch die ID Ihres Migrationsjobs.

  Wenn Sie die ID 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 ist die 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 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

Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

• 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 zu sehen.

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 ID 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 ist die 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 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

Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

• 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 zu sehen.

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 ID 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 ist die 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 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

Um zu sehen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

• 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 zu sehen.