Migrationsjob zu einer vorhandenen Zielinstanz erstellen

Übersicht

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. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

Der Database Migration Service-Assistent unterstützt Sie beim Erstellen eines Migrationsjobs. Dieser Assistent besteht aus den folgenden Bereichen: Erste Schritte, Quelle definieren, Ziel erstellen, Verbindungsmethode definieren, Migrationsdatenbanken konfigurieren und Migrationsjob testen und erstellen. Informationen zum Ausfüllen der einzelnen Bereiche finden Sie in den folgenden Abschnitten dieser Seite.

Migrationsjob mit der Google Cloud Console erstellen

Einstellungen für den Migrationsjob festlegen

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

2. Klicken Sie oben auf der Seite auf Migrationsjob erstellen.

3. Geben Sie einen Namen für den Migrationsjob an. Wählen Sie einen aussagekräftigen Namen, damit Sie den Migrationsjob leicht identifizieren können. Der Jobname sollte keine vertraulichen oder personenidentifizierbaren Informationen enthalten.

4. Behalten Sie die automatisch generierte Migrationsjob-ID bei.

5. Wählen Sie das Quelldatenbankmodul aus.

6. Wählen Sie AlloyDB for PostgreSQL als Zielmodul aus.

7. Wählen Sie die Zielregion für die Migration aus. Diese Region muss mit der Region übereinstimmen, in der sich Ihre Zieldatenbank befindet. Nachdem Sie die Zielregion ausgewählt haben, kann diese Auswahl nicht mehr geändert werden.

8. Wählen Sie als Typ des Migrationsjobs Kontinuierlich (Snapshot + laufende Änderungen) aus.

9. Klicken Sie im Abschnitt Bevor Sie fortfahren, lesen Sie die Voraussetzungen auf Öffnen, um automatisch generierte Anleitungen aufzurufen, die Ihnen bei der Vorbereitung Ihrer Quelldatenbank für die Migration helfen können. Es ist am besten, diese Voraussetzungen in diesem Schritt zu erfüllen. Sie können sie aber auch jederzeit erfüllen, bevor Sie den Migrationsjob testen oder starten. Weitere Informationen finden Sie unter Quelle konfigurieren.

10. Klicken Sie auf Speichern und fortfahren.

Informationen zum Quellverbindungsprofil angeben

1. Wenn Sie ein Verbindungsprofil erstellt haben, wählen Sie es aus der Liste der vorhandenen Verbindungsprofile aus.

   Wenn Sie noch kein Verbindungsprofil erstellt haben, klicken Sie unten in der Drop-down-Liste auf Verbindungsprofil erstellen und führen Sie dann die gleichen Schritte wie unter Quellverbindungsprofil erstellen aus.

   Es wird empfohlen, ein spezielles Verbindungsprofil für die AlloyDB-Migration zu erstellen.

2. Klicken Sie im Abschnitt Datendump-Konfigurationen anpassen auf Datendump-Konfigurationen anzeigen.

   Die Geschwindigkeit der Parallelität des Datendumps hängt von der Belastung Ihrer Quelldatenbank ab. Sie haben die folgenden Möglichkeiten:

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

   Wenn Sie angepasste Einstellungen für die Parallelität des Datendumps verwenden möchten, müssen Sie die Parameter max_replication_slots, max_wal_senders und max_worker_processes in der Quelldatenbank erhöhen. Sie können Ihre Konfiguration überprüfen, indem Sie am Ende der Erstellung des Migrationsjobs den Migrationsjobtest ausführen.

3. Klicken Sie auf Speichern und fortfahren.

Zielinstanz auswählen

1. Wählen Sie im Menü Typ des Zielclusters die Option Vorhandener Cluster aus.
2. Wählen Sie im Bereich Zielcluster auswählen den Zielcluster aus.
3. Prüfen Sie die Informationen zu Ihrem Cluster und klicken Sie auf Auswählen und fortfahren.
4. Wenn Sie zu einer vorhandenen Zieldatenbank migrieren möchten, stuft Database Migration Service die Zielinstanz herab und konvertiert sie in ein Replikat. Geben Sie im Bestätigungsfenster die Kennung der Zielinstanz ein, um anzugeben, dass die Herabstufung sicher durchgeführt werden kann.
5. Klicken Sie auf Bestätigen und fortfahren.

Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten

1. Wählen Sie im Drop-down-Menü Verbindungsmethode eine Netzwerkverbindungsmethode aus. Diese Methode definiert, wie der neu erstellte AlloyDB-Cluster eine Verbindung zur Quelldatenbank herstellt. Zu den aktuellen Netzwerkverbindungsmethoden gehören IP-Zulassungsliste, VPC-Peering, Private Service Connect-Schnittstellen, Reverse-SSH-Tunnel und TCP-Proxy über eine in der Cloud gehostete VM.
2. Wenn Sie die Netzwerkverbindungsmethode „IP-Zulassungsliste“ auswählen, müssen Sie die ausgehende IP-Adresse Ihrer Zielinstanz angeben. Kopieren Sie die ausgehenden IP-Adressen für die primäre und die sekundäre Instanz und konfigurieren Sie damit die Netzwerkfirewall für Ihren Quelldatenbankserver und in der Datei pg_hba.conf, sodass die Quelle Verbindungen von diesen Adressen akzeptieren kann.

3. Wenn Sie den umgekehrten SSH-Tunnel als Netzwerkverbindungsmethode auswählen, wählen Sie die Compute Engine-VM-Instanz aus, 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 Cloud verbunden ist.

4. Wenn Sie eine der Methoden für private IP-Verbindungen verwenden, wählen Sie VPC-Peering oder PSC-Schnittstelle aus.

5. Wenn Sie die Verbindungsmethode „TCP-Proxy über in der Cloud gehostete VM“ auswählen, 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 Skript zur Verfügung, das die Schritte zum Einrichten des Proxys zwischen den Quell- und Zieldatenbanken ausführt. Sie müssen das Skript auf einem Computer mit einer aktualisierten Google Cloud CLI ausführen.

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

6. Nachdem Sie die Netzwerkverbindungsmethode ausgewählt und alle zusätzlichen Informationen für die Methode angegeben haben, klicken Sie auf KONFIGURIEREN UND FORTFAHREN.

Datenbanken für Migration konfigurieren

Sie können die Datenbanken auswählen, die Sie migrieren möchten.

1. Wählen Sie in der Liste Zu migrierende Datenbanken eine der folgenden Optionen aus:
   • Alle Datenbanken: Hiermit 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 von Database Migration Service zu Ihrem Ziel migriert werden sollen.

   Wenn die Liste nicht angezeigt wird und ein Fehler bei der Datenbankermittlung angezeigt wird, klicken Sie auf Neu laden. 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 und erstellen

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 JOB TESTEN, um Folgendes zu prüfen:

   • Die Quelldatenbank wurde gemäß den Voraussetzungen richtig konfiguriert.
   • Die Quell- und Zielinstanzen können miteinander kommunizieren.
   • Alle erforderlichen Aktualisierungen der privaten IP-Adressen am Ziel werden vorgenommen.
   • Der Migrationsjob ist gültig und die Quell- und Zielversionen sind kompatibel.

   Wenn der Test fehlschlägt, können Sie das Problem an der entsprechenden Stelle des Ablaufs beheben und zum erneuten Test zurückkehren.

   Der Migrationsjob kann auch dann erstellt werden, wenn der Test fehlschlägt. Nach dem Start des Jobs kann es jedoch sein, dass er während der Ausführung fehlschlägt.

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

   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 zu Beginn der Migration zusätzlich eine kurze Unterbrechung der Schreibvorgänge (ca. unter einer Minute) erforderlich. Weitere Informationen finden Sie unter Überlegungen zur Parallelität von Datenexporten.

3. Der Migrationsjob wird der Liste der Migrationsjobs hinzugefügt und kann direkt aufgerufen werden.

4. 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:

gcloud database-migration connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --alloydb-cluster=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

gcloud database-migration connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --alloydb-cluster=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --alloydb-cluster=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 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.

Führen Sie folgenden Befehl 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=CONTINUOUS \

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 `

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]

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:

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

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

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 folgenden Vorgängen verwalten:

1. Optional: Migrationsjob überprüfen
   Wir empfehlen, den Migrationsjob zuerst mit dem Befehl gcloud database-migration migration-jobs verify zu überprüfen.

   Weitere Informationen finden Sie im folgenden Abschnitt:

   gcloud database-migration migration-jobs verify

   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

   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
   

   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.

2. Optional: Informationen zu den für die Migration ausgewählten Datenbanken abrufen.
   Wenn Sie bestimmte Datenbanken migrieren, muss Database Migration Service die Details zu den Datenbanken, die Sie für den Migrationsjob ausgewählt haben, mit dem Flag --database-filter abrufen.

   Bevor Sie den Migrationsjob starten, führen Sie den Befehl gcloud database-migration migration-jobs fetch-source-objects aus.

   Weitere Informationen finden Sie im folgenden Abschnitt:

   gcloud database-migration migration-jobs fetch-source-objects

   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

   gcloud database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   gcloud database-migration migration-jobs `
   fetch-source-objects MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   gcloud database-migration migration-jobs ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   Ergebnis

   Die Ausgabe sieht etwa so aus:

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   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.

3. Migrationsjob starten
   Starten Sie den Migrationsjob mit dem Befehl gcloud database-migration migration-jobs start.

   Weitere Informationen finden Sie im folgenden Abschnitt:

   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

   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
   

   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:

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

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

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

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