Migrationsjobs verwalten

Sie können Aktionen über die Liste der Migrationsjobs, die Detailseite eines einzelnen Migrationsjobs oder direkt über die Seite der Zielinstanz in Cloud SQL ausführen. In der Google Cloud Console können Sie Aktionen für mehrere Jobs gleichzeitig ausführen, wenn sie alle denselben Status haben. Sie können Aktionen für einen einzelnen Migrationsjob sowohl in der Google Cloud Console als auch mit der Google Cloud CLI ausführen.

Sie können einige Aktionen für Migrationsjobs insgesamt ausführen, während andere Aktionen (z. B. Neustart, Hochstufen oder Details ansehen) auch für ausgewählte einzelne Datenbanken innerhalb eines Migrationsjobs ausgeführt werden können.

Sie können die folgenden Aktionen für Migrationsjobs ausführen:

Aktion	Beschreibung
Bearbeiten	Bearbeiten Sie den Migrationsjob, um die folgenden Änderungen vorzunehmen: Wechseln Sie zwischen der Migration aller Datenbanken und der Migration bestimmter Datenbanken. Sie können Datenbanken in jedem Migrationsstatus oder jeder Migrationsphase beliebig oft hinzufügen oder entfernen. Wenn Sie eine Datenbank entfernen, beendet Database Migration Service den Replikationsprozess für diese Datenbank, entfernt sie jedoch nicht aus der Zielinstanz. Weitere Informationen finden Sie unter Datenbanken hinzufügen oder entfernen. Bearbeiten Sie den Parallelitätsgrad des Datendumps eines laufenden Migrationsjobs. Sie müssen den Job speichern und neu starten, nachdem Sie die Änderungen vorgenommen haben. Aktualisieren Sie den Anzeigenamen des Migrationsjobs mit der gcloud CLI. Weitere Informationen finden Sie unter Migrationsjob bearbeiten, der kein Entwurf ist.
Starten	Migrationsjobs starten, die erstellt, aber nicht gestartet wurden. Sie können Jobs starten, die sich nicht im Status Wird ausgeführt oder Wird gestartet befinden. Weitere Informationen finden Sie unter Status von Migrationsjobs.
Beenden	Sie können einen laufenden Migrationsjob jederzeit beenden. Die Datenmigration wird angehalten und der Status des Migrationsjobs ändert sich in Stopping und anschließend in Stopped. Wenn der Migrationsjob während der ersten vollständigen Dump-Phase beendet wird, können Sie den Job löschen oder neu starten. In den Replikationsslots der Quelldatenbank sammeln sich jedoch weiterhin WAL-Logs an, was letztendlich dazu führen kann, dass der Speicherplatz der Quelldatenbank ausgeht. Außerdem fragt Database Migration Service weiterhin Messwerte zur Replikationsverzögerung ab, was weiterhin Netzwerkverkehr verbraucht. Wenn der Migrationsjob während der Change Data Capture-Phase (CDC) angehalten wird, können Sie den Job fortsetzen, hochstufen oder löschen. Überwachen Sie die Replikationsslots und den Speicherplatz Ihres Quelldatenbankservers. Wenn Sie den Migrationsjob löschen, werden alle Replikationsslots in der Quelle gelöscht und der Netzwerkverkehr wird beendet.
Fortsetzen	Wenn ein fortlaufender Migrationsjob während der CDC-Phase beendet wurde, kann er fortgesetzt werden. Wenn Sie den Migrationsjob fortsetzen, wird die Replikation von Ereignissen und Datenänderungen, die sich während der Unterbrechung angesammelt haben, neu gestartet.
Neu starten	Wenn ein Migrationsjob fehlgeschlagen ist und nicht wiederhergestellt werden kann oder während der ersten vollständigen Dump-Phase beendet wurde, können Sie ihn von vorn starten. Wenn Sie die Migration neu starten, werden alle Daten aus allen Zieldatenbanken gelöscht, die von Fehlern betroffen sind, und es wird ein neuer vollständiger Dump erstellt. Wenn seit dem Start der Migration neue Datenbanken auf dem PostgreSQL-Quellserver erstellt wurden, werden diese neuen Datenbanken beim Neustart der Migration ebenfalls in die Zielinstanz repliziert. Sie können alle Datenbanken im Migrationsjob oder nur ausgewählte Datenbanken neu starten.
Löschen	Migrationsjob löschen Sie können Migrationsjobs in jedem Status löschen. Einen laufenden Migrationsjob können Sie jedoch nur in der Google Cloud Console löschen. Das Ergebnis hängt vom Status des Jobs ab: Wenn der Status des Migrationsjobs Completed lautet, wird der Eintrag aus der Liste der Migrationsjobs gelöscht. Wenn der Migrationsjob einen anderen Status hat, können Sie in der Google Cloud Console auswählen, ob die Cloud SQL-Zielinstanz gelöscht werden soll. Wenn Sie einen Migrationsjob löschen, werden zugewiesene Replikationsslots in der Quelldatenbank entfernt und der Netzwerkverkehr wird beendet. Durch das Löschen eines Migrationsjobs werden die Quelldatenbanken nicht gelöscht.
Bewerben	Stufen Sie die Zielinstanz von einem Replikat zu einer eigenständigen primären Datenbankinstanz hoch und trennen Sie die Zielinstanz von der Quelle. Sie können den gesamten Migrationsjob oder ausgewählte einzelne Datenbanken hochstufen. Weitere Informationen finden Sie unter Migration hochstufen.
Bestimmte Datenbank ansehen	Migrationsdetails für eine bestimmte Datenbank ansehen, die für die Migration konfiguriert ist.
Alle Datenbanken ansehen	Migrationsdetails für alle für die Migration konfigurierten Datenbanken ansehen.

Migrationsjob starten

Wenn Ihr Migrationsjob vollständig erstellt wurde (d. h. nicht als Entwurf gespeichert ist), können Sie ihn jederzeit starten, um mit der Migration von Daten zu beginnen.

So starten Sie einen Migrationsjob:

Console

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

   Zu Migrationsjobs

2. Klicken Sie auf dem Tab Jobs auf den Anzeigenamen des Migrationsjobs, den Sie starten möchten.

   Die Detailseite des Migrationsjobs wird geöffnet.

3. Klicken Sie auf Start.
4. Klicken Sie im Dialogfeld auf Starten.

gcloud

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

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

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:

• Verwenden Sie den Befehl gcloud database-migration migration-jobs describe mit der 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 beenden

Sie können einen laufenden Migrationsjob jederzeit beenden. Wenn Sie einen Migrationsjob beenden, wird die Datenmigration angehalten und der Status des Migrationsjobs ändert sich in Stopping und anschließend in Stopped.

Achtung: Wenn ein Migrationsjob beendet wird, sammeln sich weiterhin WAL-Logs in Replikationsslots auf dem Quelldatenbankserver an. Das kann schließlich dazu führen, dass der Speicherplatz auf Ihrer Quelldatenbank knapp wird. Außerdem fragt Database Migration Service weiterhin Messwerte zur Replikationsverzögerung ab, was weiterhin Netzwerkverkehr verursacht. Überwachen Sie die Replikationsslots und den Speicherplatz Ihres Quelldatenbankservers. Wenn Sie die Migration nicht fortsetzen möchten, löschen Sie den Migrationsjob, um die Replikationsslots zu bereinigen und den Netzwerkverkehr zu beenden.

So beenden Sie einen Migrationsjob:

Console

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

   Zu Migrationsjobs

2. Klicken Sie auf dem Tab Jobs auf den Anzeigenamen des Migrationsjobs, den Sie beenden möchten.

   Die Detailseite des Migrationsjobs wird geöffnet.

3. Klicken Sie auf Beenden.
4. Klicken Sie im Dialogfeld auf Beenden.

gcloud

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

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 \
stop 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 `
stop 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 ^
stop 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: stop
name: OPERATION_ID

Um zu prüfen, ob der 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.

Migrationsjob fortsetzen

Wenn ein kontinuierlicher Migrationsjob während der Change Data Capture-Phase (CDC) angehalten wurde, können Sie ihn fortsetzen. Wenn Sie den Migrationsjob fortsetzen, wird die Replikation von Ereignissen und Datenänderungen neu gestartet, die sich in der Quelldatenbank angesammelt haben, während der Job angehalten war.

So setzen Sie einen beendeten Migrationsjob fort:

Console

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

   Zu Migrationsjobs

2. Klicken Sie auf dem Tab Jobs auf den Anzeigenamen des Migrationsjobs, den Sie fortsetzen möchten.

   Die Detailseite des Migrationsjobs wird geöffnet.

3. Klicken Sie auf Fortsetzen.
4. Klicken Sie im Dialogfeld auf Fortsetzen.

gcloud

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

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 \
resume 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 `
resume 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 ^
resume 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: resume
name: OPERATION_ID

Um zu prüfen, ob der 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.

Migrationsjob neu starten

Wenn ein Migrationsjob fehlgeschlagen ist und nicht wiederhergestellt werden kann oder während der ersten vollständigen Dump-Phase beendet wurde, können Sie ihn von vorn starten.

Wenn Sie die Migration neu starten, werden alle Daten aus allen Zieldatenbanken gelöscht, die von Fehlern betroffen sind, und es wird ein neuer vollständiger Dump gestartet. Wenn seit dem Start der Migration neue Datenbanken auf dem PostgreSQL-Quellserver erstellt wurden, werden diese neuen Datenbanken beim Neustart der Migration ebenfalls in die Zielinstanz repliziert.

Sie können alle Datenbanken im Migrationsjob oder nur bestimmte Datenbanken neu starten.

So starten Sie einen Migrationsjob neu:

Console

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

   Zu Migrationsjobs

2. Klicken Sie auf dem Tab Jobs auf den Anzeigenamen des Migrationsjobs, den Sie neu starten möchten.

   Die Detailseite des Migrationsjobs wird geöffnet.

3. Führen Sie eine der folgenden Neustartaktionen aus:

   • Wenn Sie alle in der Migration enthaltenen Datenbanken neu starten möchten, klicken Sie in der Symbolleiste des Migrationsjobs auf Neu starten.

     Das Dialogfeld zum Neustarten des Migrationsjobs wird angezeigt.

   • Wenn Sie nur bestimmte Datenbanken neu starten möchten, wählen Sie sie über die Kästchen neben den Datenbanknamen aus und klicken Sie auf dem Tab Datenbanken auf Neu starten.

     Das Dialogfeld mit einer Reihe von Datenbanken, die Sie neu starten möchten, wird angezeigt.

4. Klicken Sie im Dialogfeld auf Neu starten.

gcloud

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

• MIGRATION_JOB_ID durch die Kennung Ihres Migrationsjobs.

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

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

• 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

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 \
restart 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 `
restart 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 ^
restart 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: restart
name: OPERATION_ID

Um zu prüfen, ob der 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.

Migrationsjobentwurf aktualisieren

So schließen Sie die Erstellung eines Migrationsjobs ab:

Console

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

   Zu Migrationsjobs

2. Klicken Sie auf dem Tab Entwürfe auf den Anzeigenamen des Migrationsjobs, den Sie fertigstellen möchten.

   Der Assistent zum Erstellen von Migrationsjobs wird geöffnet.

3. Schließen Sie die Erstellung des Migrationsjobs ab. Weitere Informationen finden Sie unter Migrationsjob erstellen.

gcloud

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.
• REGION durch die Regionskennung, in der Sie das Verbindungsprofil 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.
• COMMA_SEPARATED_DATABASE_ID_LIST durch eine durch Kommas getrennte Liste von Datenbank-IDs der PostgreSQL-Datenbanken, die Sie migrieren möchten.

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 \
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST \
  --type=CONTINUOUS

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 `
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST `
  --type=CONTINUOUS

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 ^
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS

Sie sollten eine Antwort ähnlich der folgenden erhalten:

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Datenbanken zum Migrationsjob hinzufügen oder daraus entfernen

Sie können Datenbanken in jedem Migrationsstatus oder jeder Migrationsphase beliebig oft hinzufügen oder entfernen. Wenn Sie eine Datenbank entfernen, beendet Database Migration Service den Replikationsprozess für diese Datenbank, entfernt sie jedoch nicht aus der Cloud SQL-Zielinstanz.

Hinweis: Sie müssen den Migrationsjob nach jeder Änderung speichern.

So fügen Sie Ihrem Migrationsjob Datenbanken hinzu oder entfernen sie:

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

   Zu Migrationsjobs

2. Klicken Sie auf dem Tab Jobs auf den Anzeigenamen Ihres Migrationsjobs. Die Detailseite des Migrationsjobs wird geöffnet.
3. Klicken Sie auf Bearbeiten.
4. Wählen Sie im Abschnitt Zu migrierende Datenbanken auswählen die Kästchen für die neuen Datenbanken aus, die Sie dem Migrationsjob hinzufügen möchten, oder entfernen Sie die Häkchen für die Datenbanken, die Sie entfernen möchten.
5. Klicken Sie auf Speichern.

Migrationsjob bearbeiten, der kein Entwurf ist

Informationen zum Bearbeiten des Parallelitätsgrads des Datendumps eines laufenden Migrationsjobs finden Sie unter Überlegungen zur Parallelität. Sie müssen den Migrationsjob speichern und neu starten, nachdem Sie die Parallelitätseinstellungen geändert haben.

Bei Migrationsjobs, die keine Entwürfe sind, können Sie den Anzeigenamen des Migrationsjobs mit der Google Cloud CLI ändern:

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 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.
• MIGRATION_JOB_NAME durch einen menschenlesbaren Namen für den Migrationsjob. Dieser Wert wird in Database Migration Service 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 migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_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 migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_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 migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

Sie sollten eine Antwort ähnlich der folgenden erhalten:

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

Migrationsjob testen

Bevor Sie den Migrationsjob ausführen, können Sie einen Testvorgang ausführen, um zu prüfen, ob Database Migration Service alle erforderlichen Quell- und Zielentitäten erreichen kann. In der Google Cloud Console können Sie nur Entwürfe von Migrationsjobs testen, die Sie im Assistenten zum Erstellen von Migrationsjobs erstellen (siehe Migrationsjob erstellen).

Mit der gcloud CLI können Sie Migrationsjobs testen, die erstellt, aber noch nicht gestartet wurden.

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

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

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:

• Verwenden Sie den Befehl gcloud database-migration migration-jobs describe mit der 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.

Migrationsdetails für eine bestimmte Datenbank ansehen

Wenn der Migrationsjob vollständig erstellt wurde (d. h. nicht als Entwurf gespeichert ist), können Sie mit der Google Cloud CLI Details zu einer bestimmten Datenbank in diesem Migrationsjob aufrufen.

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 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.
• DATABASE_NAME durch den Namen der Datenbank.

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 objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_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 objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_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 objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

Ergebnis

Die Ausgabe sieht etwa so aus:

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING

Um zu prüfen, ob der 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.

Migrationsdetails für bestimmte Datenbanken ansehen

Wenn Ihr Migrationsjob vollständig erstellt wurde (d. h. nicht als Entwurf gespeichert ist), können Sie mit der Google Cloud CLI alle Datenbanken auflisten, die Sie für diesen Migrationsjob ausgewählt haben, und Details dazu aufrufen.

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

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 objects list --migration-job=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 objects list --migration-job=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 objects list --migration-job=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': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}

Um zu prüfen, ob der 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.