Migrationsfortschritt ansehen und verwalten

Bei heterogenen Migrationen von Oracle zu Cloud SQL for PostgreSQL können Sie den Migrationsfortschritt für den gesamten Migrationsjob oder für einzelne Tabellen im Migrationsjob überwachen und verwalten.

Auf dieser Seite werden die Aktionen beschrieben, die Sie auf den einzelnen Ebenen ausführen können. Weitere Informationen finden Sie in den Abschnitten Migrationsjobs verwalten und Einzelne Tabellen verwalten.

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 Ihren Migrationsjob ausführen:

Aktion Beschreibung
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.

Bei kontinuierlichen Migrationen: In einigen Fällen muss die Quelldatenbank die Daten beibehalten, bis Sie den Migrationsjob fortsetzen. Die Aufbewahrungsdauer für die Quelldatenbank ist möglicherweise begrenzt. Wenn der Migrationsjob länger als die Aufbewahrungsdauer pausiert und dann fortgesetzt wird, kann dies dazu führen, dass der Migrationsjob fehlschlägt. In diesem Fall müssen Sie den Migrationsjob löschen oder neu starten.

Fortsetzen Wenn Sie einen Migrationsjob fortsetzen, setzt Database Migration Service die Datenverschiebungsvorgänge fort:
  • Bei kontinuierlichen Migrationen, die während der CDC-Phase angehalten wurden, setzt Database Migration Service die Replikation von Änderungsereignissen fort, die sich ansammeln, wenn der Migrationsjob angehalten wird.
  • Bei Migrationsjobs, die während der Phase des vollständigen Dumps beendet wurden (entweder eine einmalige oder eine kontinuierliche Migration), setzt Database Migration Service das Kopieren der Daten fort, die vor dem Beenden der Migration nicht kopiert wurden.
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 davon ab, warum er fehlgeschlagen ist:

  • Wenn die Replikation aufgrund eines Fehlers in einer oder mehreren Quell- oder Zieldatenbanktabellen fehlgeschlagen ist, werden beim Neustart des Migrationsjobs alle Daten aus den im Migrationsjob enthaltenen Zieldatenbanktabellen gelöscht.
  • Durch den Neustart des Migrationsjobs werden neue Tabellen, die Sie in der Quelldatenbank erstellt haben, nicht von Database Migration Service repliziert. Sie müssen zuerst die Tabellen zum Konvertierungsarbeitsbereich hinzufügen und ihr Schema konvertieren.
Bearbeiten Weitere Informationen finden Sie unter Migrationsjob bearbeiten.
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 zugehörige Cloud SQL for PostgreSQL-Zielinstanz löschen.
Hochstufen Während des Migrationsprozesses wird die Zieldatenbank in einen schreibgeschützten Zustand versetzt, in dem sie vollständig von Database Migration Service verwaltet wird. Wenn Sie Ihre Anwendung auf die migrierte Zieldatenbank umstellen möchten, wird die Zieldatenbank durch das Hochstufen des Migrationsjobs in ein eigenständiges Replikat umgewandelt. Weitere Informationen finden Sie unter Migration hochstufen.

Migrationsjob prüfen

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

    Zu Migrationsjobs

  2. Wählen Sie einen Migrationsjob aus, um die zugehörige Detailseite aufzurufen. Diese enthält Folgendes:
    • Metadaten des Migrationsjobs, z. B. Anzeigename, ID, Migrationstyp, Quellverbindungsprofil, Quelldatenbankmodul, Ziel, Verbindungsmethode, Datum und Uhrzeit der Erstellung des Migrationsjobs und Laufzeit des Migrationsjobs.
    • Status und Unterstatus des Migrationsjobs sowie zusätzliche Informationen. Je nach Status und Unterstatus des Migrationsjobs sind verschiedene Aktionen verfügbar.

Migrationsjob starten

Wenn der Migrationsjob vollständig erstellt wurde (also 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.

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

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

Wenn Sie einen Migrationsjob neu starten, löscht Database Migration Service alle Daten aus den Zieltabellen. Ihre Quelldaten sind davon nicht betroffen. Der Migrationsprozess beginnt dann von vorn, beginnend mit der vollständigen Dump-Phase.

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. Klicken Sie auf Restart (Neu starten).
  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.

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:

  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.

Migrationsjob bearbeiten

Sie können die Konfigurationsinformationen für die Quelle ändern, z. B. die Datenbanktabellen und -schemas in der Quelle, die Database Migration Service zum Ziel migriert. Database Migration Service verwendet diese Konfigurationsinformationen, um die richtigen Daten aus der Quelle in das Ziel zu migrieren.

Objekte zur Migration hinzufügen oder daraus entfernen

So fügen Sie der Migration Tabellen oder Schemas hinzu oder entfernen sie:

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

    Zu Migrationsjobs

  2. Klicken Sie auf den Anzeigenamen des Migrationsjobs, den Sie ändern möchten. Eine Übersichtsseite für den Migrationsjob wird angezeigt.

  3. Aktivieren oder deaktivieren Sie im Abschnitt Zu migrierende Objekte auswählen die Kästchen, um die Tabellen und Schemas in der Quelle zu ändern, die Database Migration Service zum Ziel migrieren soll.

  4. Klicken Sie auf Speichern oder Speichern und neu starten.

    • Wenn Sie auf Speichern klicken, verschiebt Database Migration Service nur Verlaufsdaten für die von Ihnen ausgewählten Schemas und Tabellen.

    • Wenn Sie auf Speichern und neu starten klicken, startet Database Migration Service die Migration von vorn, nachdem alle Tabellen, die Sie im Ziel auswählen, bereinigt wurden.

Maximale Anzahl gleichzeitiger Verbindungen zur Quelldatenbank anpassen

Sie können die maximale Anzahl gleichzeitiger Verbindungen anpassen, die Database Migration Service für die Phase des vollständigen Dumps oder die CDC-Phase zu Ihrer Quellinstanz herstellen kann.

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

    Zu Migrationsjobs

  2. Klicken Sie auf den Anzeigenamen des Migrationsjobs, den Sie ändern möchten. Eine Übersichtsseite für den Migrationsjob wird angezeigt.

  3. Maximieren Sie den Bereich Quellkonfiguration anpassen > Leseeinstellungen für Quelle.

  4. Geben Sie im Abschnitt Maximale Anzahl gleichzeitiger Verbindungen für vollständigen Dump oder Maximale Anzahl gleichzeitiger CDC-Verbindungen im Feld Benutzerdefiniert das maximale Verbindungslimit für die Phase des vollständigen Dumps oder die CDC-Phase ein.

  5. Klicken Sie auf Speichern oder Speichern und neu starten.

Zielkonfigurationseinstellungen anpassen

Sie können das Transaktionszeitlimit und die maximale Anzahl gleichzeitiger Verbindungen für Ihre Zieldatenbank anpassen:

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

    Zu Migrationsjobs

  2. Klicken Sie auf den Anzeigenamen des Migrationsjobs, den Sie ändern möchten.

    Eine Übersichtsseite für den Migrationsjob wird angezeigt.

  3. Maximieren Sie den Bereich Zielkonfiguration anpassen und ändern Sie die folgenden Einstellungen:
    Maximale Anzahl gleichzeitiger Zielverbindungen

    Standardwert: 128

    Zulässige Werte: mindestens 2, maximal 256

    Sie können die maximale Anzahl gleichzeitiger Verbindungen anpassen, die Database Migration Service zur Zielinstanz herstellen kann.

    Database Migration Service passt die Anzahl der Verbindungen an, um die beste Leistung innerhalb des angegebenen Verbindungslimits zu erzielen. Wenn Sie das maximale Verbindungslimit erhöhen, kann sich die Migrationsgeschwindigkeit verbessern, aber die Ziellaufwerke werden zusätzlich belastet.

    Zeitüberschreitung bei Transaktion

    Standardwert: 30

    Zulässige Werte: mindestens 30, maximal 300

    Während des Migrationsprozesses können im Database Migration Service bestimmte Probleme auftreten, die zu einer Zeitüberschreitung der Transaktion führen. Sie können die Anzahl der Sekunden anpassen, die Database Migration Service auf den Abschluss der Transaktion wartet, bevor sie abgebrochen wird.

    Abgebrochene Transaktionen führen nicht zum Fehlschlagen des Migrationsjobs. Der Migrationsjob kopiert weiterhin Daten, wechselt aber in den Status Wird mit Fehlern ausgeführt. Sie können sich die Details des Migrationsjobs ansehen, um zu prüfen, welche Probleme behoben werden müssen.

  4. Klicken Sie auf Speichern oder Speichern und neu starten.

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:

Einzelne Tabellen verwalten

Bei heterogenen Migrationen von Oracle zu Cloud SQL for PostgreSQL können Sie Statusdetails für bestimmte Tabellen in Ihrem Migrationsjob aufrufen.

Alle Tabellen in einem Job ansehen

So rufen Sie Details zu allen Tabellen in einem Migrationsjob auf:

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. Wählen Sie den Tab Tabellen aus und sehen Sie sich alle Tabellen an, die in Ihrem Job enthalten sind. Sie können die Liste auch mithilfe interaktiver Filter eingrenzen.

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

Dieser Befehl gibt den Status, die Phase und die Fehlerdetails für alle im Migrationsjob enthaltenen Tabellen zurück, getrennt durch Leerzeilen.

SOURCE_OBJECT: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}

SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
  { 'code': 2,
    'details': [
        { '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
          'domain': 'datamigration.googleapis.com',
          'metadata': {
            'errorMessage': '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2',
            'errorScope': 'NON_GLOBAL',
            'objectId': 'Production_MyTable2',
            'projectName': 'PROJECT_ID',
            'resourceName': 'MIGRATION_JOB_ID',
            'severity': 'ERROR'
          },
          'reason': 'DESTINATION_WRITE_ERROR'
        }
      ],
    'message': 'Encountered errors with your migration job table. Check the `details`
                  array for specific information on each issue.'
  }

Details für eine einzelne Tabelle ansehen

So rufen Sie Migrationsdetails für eine einzelne Tabelle auf:

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. Wählen Sie den Tab Tabellen aus und klicken Sie auf die Tabelle, die Sie prüfen möchten. Sie können die Liste auch mithilfe interaktiver Filter eingrenzen.

    Die Seitenleiste mit den Tabellendetails wird geöffnet.

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.
  • SCHEMA_NAME durch den Namen des übergeordneten Schemas, das Ihre Tabelle enthält.
  • TABLE_NAME durch den Namen Ihrer Tabelle.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud database-migration objects lookup \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION \
  --schema=SCHEMA_NAME \
  --table=TABLE_NAME

Windows (PowerShell)

gcloud database-migration objects lookup `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION `
  --schema=SCHEMA_NAME `
  --table=TABLE_NAME

Windows (cmd.exe)

gcloud database-migration objects lookup ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION ^
  --schema=SCHEMA_NAME ^
  --table=TABLE_NAME

Ergebnis

Dieser Befehl gibt den Status, die Phase, die Erstellungszeit und Fehlerdetails für Ihre Tabelle zurück. Die gesamte Antwort ist ein mehrzeiliger, YAML-formatierter String. Beispiel:

createTime: '2025-06-02T10:20:29.792832Z'
error:
  code: 2
  details:
  - '@type': type.googleapis.com/google.rpc.ErrorInfo
    domain: datamigration.googleapis.com
    metadata:
      errorMessage: '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2'
      errorScope: NON_GLOBAL
      objectId: Production_MyTable2
      projectName: PROJECT_ID
      resourceName: MIGRATION_JOB_ID
      severity: ERROR
    reason: DESTINATION_WRITE_ERROR
  message: Encountered errors with your migration job table. Check the `details` array
    for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
  schema: Production
  table: MyTable2
  type: TABLE
state: RUNNING