Migrationsjobs verwalten

In der Google Cloud Console können Sie Bulk-Aktionen für Migrationsjobs mit demselben Status ausführen. Sie können Aktionen für einen einzelnen Migrationsjob sowohl in der Google Cloud Console (entweder über die Database Migration Service-Konsole oder direkt über die Seite der Cloud SQL-Zielinstanz) als auch über die 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:
Starten Migrationsjobs starten, die nicht den Status Wird ausgeführt oder Wird gestartet haben. Weitere Informationen finden Sie unter Status von Migrationsjobs.
Beenden Laufenden Migrationsjob beenden Die Datenverschiebung 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 hochstufen.
Fortsetzen Wenn Sie einen Migrationsjob während des inkrementellen Ladens beenden, 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, die den Fehler nicht beheben können, wird der gesamte Migrationsprozess wiederholt, einschließlich des anfänglichen Ladens der vollständigen Vollsicherungsdatei.
  • 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 werden Ihre Cloud SQL for SQL Server-Zieldatenbanken in den Wiederherstellungsmodus versetzt, in dem sie vollständig von Database Migration Service verwaltet werden. Sie können erst dann Lese- oder Schreibvorgänge für die Zieldatenbanken ausführen, wenn Sie den Migrationsjob oder die ausgewählten Datenbanken hochgestuft haben. 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

Sie können einen Migrationsjob über die Database Migration Service-Konsole oder über die Seite der Zielinstanz starten.

Über die Database Migration Service-Konsole:

  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.

Von der Zielinstanz:

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Anzeigenamen der Zielinstanz für die Migration.

    Die Seite mit den Instanzdetails wird geöffnet.

  3. Klicken Sie im Bereich Migration auf Starten.
  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 Migrationsjob 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

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:

Migrationsjob beenden

Sie können einen laufenden Migrationsjob jederzeit beenden. Gehen Sie dazu so vor:

Console

Sie können einen Migrationsjob über die Database Migration Service-Konsole oder die Seite der Zielinstanz beenden.

In der Database Migration Service-Konsole:

  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.

Von der Zielinstanz:

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Anzeigenamen der Zielinstanz für die Migration.

    Die Seite mit den Instanzdetails wird geöffnet.

  3. Klicken Sie im Bereich Migration 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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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:

Migrationsjob fortsetzen

So können Sie einen beendeten Migrationsjob fortsetzen:

Console

Sie können einen Migrationsjob über die Database Migration Service-Konsole oder die Seite der Zielinstanz fortsetzen.

In der Database Migration Service-Konsole:

  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.

Von der Zielinstanz:

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Anzeigenamen der Zielinstanz für die Migration.

    Die Seite mit den Instanzdetails wird geöffnet.

  3. Klicken Sie im Bereich Migration 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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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:

Migrationsjob neu starten

So starten Sie einen Migrationsjob neu:

Console

Sie können einen Migrationsjob über die Database Migration Service-Konsole oder über die Seite der Zielinstanz neu starten.

Über die Database Migration Service-Konsole:

  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.

Von der Zielinstanz:

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Anzeigenamen der Zielinstanz für die Migration.

    Die Seite mit den Instanzdetails wird geöffnet.

  3. Klicken Sie im Bereich Migration auf Neu starten.
  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 --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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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:

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.
  • Konfiguration für differenzielle Sicherung: Sie können konfigurieren, ob der Migrationsjob differenzielle Sicherungsdateien aus dem Cloud Storage-Bucket verwenden kann. Fügen Sie dem Befehl eines der folgenden Flags hinzu:
    • --sqlserver-diff-backup, um differenzielle Sicherungsdateien für Ihre Migration zu aktivieren
    • --no-sqlserver-diff-backup, um differenzielle Sicherungsdateien für die Migration zu deaktivieren

    Weitere Informationen zu unterstützten Sicherungsdateien finden Sie unter Unterstützte Sicherungsdateitypen.

  • COMMA_SEPARATED_DATABASE_ID_LIST durch eine durch Kommas getrennte Liste von Datenbank-IDs des SQL Servers, den Sie aus Ihren Sicherungsdateien migrieren möchten.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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 ^
  --sqlserver-databases=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

Wenn Sie dem Migrationsjob eine neue Datenbank hinzufügen möchten, müssen Sie zuerst einen neuen dedizierten Ordner in Ihrem Cloud Storage-Bucket erstellen und die Sicherungsdateien dorthin hochladen. Weitere Informationen finden Sie unter Cloud Storage-Buckets konfigurieren.

Wenn Sie die erforderlichen Sicherungsdateien im Cloud Storage-Bucket haben, führen Sie die folgenden Schritte aus:

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. Klicken Sie auf Bearbeiten.
  4. Wählen Sie im Abschnitt Zu migrierende Datenbanken auswählen die Kästchen für die neue Datenbank 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. (Optional) Wenn Sie verschlüsselte Sicherungen verwenden, geben Sie die Verschlüsselungsschlüssel für Ihre Sicherungen an. Weitere Informationen zur Verwendung verschlüsselter Sicherungen finden Sie unter Verschlüsselte Sicherungen verwenden.

    Führen Sie folgende Aktionen durch:

    • Klicken Sie neben der Datenbank, die Sie für die Migration ausgewählt haben, auf Details bearbeiten.

      Die Seitenleiste Verschlüsselung wird geöffnet.

    • Wählen Sie Ihre Schlüssel über die Menüs Verschlüsselungsschlüssel aus.
    • Geben Sie im Feld Passwort das Passwort für den Verschlüsselungsschlüssel ein.
    • Klicken Sie auf Speichern und schließen.

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 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.
  • COMMA_SEPARATED_DATABASE_ID_LIST durch eine durch Kommas getrennte Liste von Datenbank-IDs des SQL Servers, den Sie aus Ihren Sicherungsdateien migrieren möchten. Diese Kennungen müssen mit den Datenbankordnernamen in Ihrem Cloud Storage übereinstimmen.

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

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_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

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME

Windows (cmd.exe)

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

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 der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

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

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

Windows (cmd.exe)

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:

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

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

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: