Migrationsjobs verwalten

In der Google Cloud Console können Sie Aktionen im Bulk für Migrationsjobs mit demselben Status ausführen. 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 die folgenden Aktionen für Migrationsjobs ausführen:

Aktion	Beschreibung
Bearbeiten	Sie können Migrationsjobs, die keine Entwürfe sind, bearbeiten, um die folgenden Änderungen vorzunehmen: Aktualisieren Sie den Anzeigenamen des Migrationsjobs mit der gcloud CLI. Weitere Informationen finden Sie unter Migrationsjob bearbeiten, der kein Entwurf ist. Datenbanken zu einem Migrationsjob hinzufügen oder daraus entfernen, der sich nicht im Status Running befindet (der Job muss sich im Status Not started, Stopped oder Failed befinden). Weitere Informationen finden Sie unter Datenbanken zum Migrationsjob hinzufügen oder daraus entfernen.
Starten	Migrationsjobs starten, die nicht den Status Wird ausgeführt oder Wird gestartet haben. Weitere Informationen finden Sie unter Status von Migrationsjobs.
Beenden	Einen laufenden Migrationsjob beenden. Die Datenübertragung wird pausiert. Der Status des Migrationsjobs ändert sich zuerst in Stopping und dann in Stopped. Sie können einen angehaltenen Migrationsjob fortsetzen, löschen oder hochladen.
Fortsetzen	Wenn Sie einen Migrationsjob während des inkrementellen Ladevorgangs stoppen, können Sie ihn später fortsetzen. Wenn Sie einen Migrationsjob fortsetzen, werden in Database Migration Service alle Transaktionsprotokolldateien erfasst, die sich angesammelt haben, als der Migrationsjob angehalten war.
Neu starten	Sie können einen Migrationsjob neu starten, bei dem ein Fehler aufgetreten ist und die Datenreplikation nicht fortgesetzt werden kann. Das Ergebnis des Neustarts eines Migrationsjobs hängt von einem der folgenden Gründe für den Fehler ab: Bei fehlgeschlagenen Migrationsjobs, bei denen der Fehler nicht behoben werden kann, wird der gesamte Migrationsprozess noch einmal versucht, einschließlich der anfänglichen Phase des vollständigen Dumps. Wenn die Replikation aufgrund eines Fehlers in einer oder mehreren Quell- oder Zieldatenbanken fehlgeschlagen ist, werden beim Neustart der Migration alle Daten aus den Zieldatenbanken gelöscht. Wenn Sie nach dem Start der Migration einen neuen Ordner für eine andere Datenbank erstellen und ihn den für die Migration ausgewählten Datenbanken hinzufügen, werden die neuen Datenbanken beim Neustart der Migration ebenfalls in die Zielinstanz repliziert.
Löschen	Ein Migrationsjob kann gelöscht werden. Das Ergebnis hängt vom Status des Jobs ab: Wenn der Migrationsjob den Status Completed hat, wird der Eintrag aus der Liste der Migrationsjobs gelöscht. Wenn der Migrationsjob einen anderen Status hat, können Sie die Cloud SQL-Zielinstanz bzw. das primäre Paar löschen.
Hochstufen	Während des Migrationsprozesses wird Ihre Cloud SQL-Zielinstanz zu einem Lesereplikat herabgestuft, das vom Database Migration Service verwaltet wird. Sie können keine Lese- oder Schreibvorgänge für die Zieldatenbanken ausführen, bis Sie die Migration hochstufen. Weitere Informationen finden Sie unter Migration hochstufen.
Ansehen	Sie können die Details einer bestimmten Datenbank in einem Migrationsjob oder aller Datenbanken aufrufen, die Sie für die Migration ausgewählt haben.

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 stoppen

Sie können einen laufenden Migrationsjob jederzeit beenden, indem Sie die folgenden Schritte ausführen:

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 Beenden.
4. Klicken Sie im Dialogfeld auf Beenden.

gcloud

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

• MIGRATION_JOB_ID durch die Kennzeichnung 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

So können Sie einen beendeten Migrationsjob fortsetzen:

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

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 einen der folgenden Neustarts durch:

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

     Das Dialogfeld „Migrationsjob neu starten“ 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 Befehl --database-filter flag 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

Führen Sie die folgenden Schritte aus, um einen Migrationsjob zu erstellen:

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 weglassen, 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 mit einer maschinenlesbaren Kennung des Zielverbindungsprofils.
• COMMA_SEPARATED_DATABASE_ID_LIST durch eine durch Kommas getrennte Liste von Datenbankkennungen der MySQL-Datenbank, 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 der Google Cloud Console oder mit der Google Cloud CLI zu einem Migrationsjob hinzufügen oder daraus entfernen, sofern der Migrationsjob nicht den Status Running hat:

• Der Migrationsjob muss den Status Not started, Stopped oder Failed haben. Wenn der Migrationsjob den Status Running hat, müssen Sie den Migrationsjob beenden, bevor Sie die Datenbankauswahl bearbeiten können.
• Wichtig: Wenn Sie Datenbanken zu einem bereits gestarteten Migrationsjob hinzufügen oder daraus entfernen, setzt Database Migration Service den Migrationsfortschritt auf die Phase des vollständigen Dumps zurück. Alle für den Migrationsjob ausgewählten Datenbanken (einschließlich der bereits migrierten Datenbanken) werden in der Cloud SQL-Zielinstanz gelöscht und aus der Quellinstanz neu exportiert.
• Wenn Sie eine Datenbank aus einem Migrationsjob entfernen, beendet Database Migration Service die Replikation von Änderungen für diese Datenbank. Bereits migrierte Daten für diese Datenbank werden jedoch nicht aus der Zielinstanz gelöscht.

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

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 Ihres Migrationsjobs.

   Die Detailseite des Migrationsjobs wird geöffnet.

3. Wenn der Status des Migrationsjobs Wird ausgeführt lautet, klicken Sie auf Beenden, bestätigen Sie im Dialogfeld und warten Sie, bis sich der Status in Beendet ändert.
4. Klicken Sie auf Bearbeiten.
5. Wählen Sie im Abschnitt Zu migrierende Objekte auswählen im Menü Zu migrierende Datenbanken zwischen Alle Datenbanken und Bestimmte Datenbanken aus. Wenn Sie Bestimmte Datenbanken auswählen, können Sie mit den Kästchen die Datenbanken auswählen, die Sie hinzufügen möchten, oder die Datenbanken deaktivieren, die Sie entfernen möchten.
6. Klicken Sie auf Speichern und neu starten (oder auf Speichern und starten, wenn der Job noch nicht gestartet wurde), um die Änderungen zu übernehmen und den Migrationsjob auszuführen, oder klicken Sie auf Speichern.

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 weglassen, 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 Migrationsjob gespeichert ist.
• DATABASE_LIST durch eine durch Kommas getrennte Liste aller Datenbanknamen, die der Migrationsjob migrieren soll (z. B. my-db-1,my-db-2). Wenn Sie den Migrationsjob wieder so einstellen möchten, dass alle Datenbanken auf der Quellinstanz migriert werden, ersetzen Sie --databases-filter=DATABASE_LIST durch --all-databases.

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 \
  --databases-filter=DATABASE_LIST

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 `
  --databases-filter=DATABASE_LIST

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 ^
  --databases-filter=DATABASE_LIST

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 bearbeiten, der kein Entwurf ist

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 -Konsole können Sie nur Migrationsjobentwürfe 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 Kennzeichnung 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 Ihr 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. Wenn Sie das tun, 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 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 im Entwurfsstatus 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.