Migrationsjobs ansehen und verwalten

Projekt: /database-migration/docs/sqlserver-to-csql-pgsql/_project.yaml Buch: /database-migration/docs/sqlserver-to-csql-pgsql/_book.yaml

In der Google Cloud Console können Sie Aktionen für Migrationsjobs im Bulk ausführen, die 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 haben folgende Möglichkeiten:

Aktion Beschreibung
Starten Starten Sie Migrationsjobs, die nicht den Status Wird ausgeführt oder Wird gestartet haben. Weitere Informationen finden Sie unter Migrationsjob-Status.
Anhalten Einen laufenden Migrationsjob anhalten Die Datenübertragung wird pausiert. Der Status des Migrationsjobs ändert sich zuerst zu Stopping und dann zu Stopped. Sie können einen angehaltenen Migrationsjob fortsetzen, löschen oder priorisieren.

In einigen Fällen müssen die Daten in der Quelldatenbank verbleiben, 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 das dazu führen, dass der Migrationsjob fehlschlägt. Löschen Sie in diesem Fall den Migrationsjob oder starten Sie ihn neu.

Fortsetzen Sie können Migrationsjobs, die während der CDC-Phase angehalten wurden, fortsetzen. Wenn Sie einen Migrationsjob fortsetzen, wird die Replikation von Änderungsereignissen fortgesetzt, die sich angesammelt haben, als der Migrationsjob angehalten wurde.
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 Zieldatenbanktabellen gelöscht, die im Migrationsjob enthalten sind.
  • Wenn Sie den Migrationsjob neu starten, werden von Database Migration Service keine neuen Tabellen repliziert, die Sie in der Quelldatenbank erstellt haben. Sie müssen zuerst die Tabellen dem Conversion-Arbeitsbereich 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 den zugehörigen Zielcluster von AlloyDB for PostgreSQL löschen.
Hochstufen Während der Migration wird die Zieldatenbank in den Lesezugriffsmodus versetzt und vollständig vom Database Migration Service verwaltet. Wenn Sie Ihre Anwendung auf die migrierte Zieldatenbank umstellen möchten, wird die Zieldatenbank durch das Hochstufen des Migrationsjobs in ein eigenständiges Replikat aktualisiert. Weitere Informationen finden Sie unter Migrationen 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 Seite mit den Details aufzurufen. Sie enthält Folgendes:
    • Metadaten des Migrationsjobs, z. B. der Anzeigename, die ID, der Migrationstyp, das Quellverbindungsprofil, die Quelldatenbank-Engine, das Ziel, die Verbindungsmethode, das Datum und die Uhrzeit der Erstellung des Migrationsjobs sowie die Dauer der Ausführung des Migrationsjobs.
    • Status und Unterstatus des Migrationsjobs sowie zusätzliche Informationen. Je nach Status und Unterstatus des Migrationsjobs sind unterschiedliche Aktionen verfügbar.

Migrationsjob starten

Sobald der Migrationsjob vollständig erstellt wurde (d. h., er nicht im Status „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.

    Migrationsjobs aufrufen

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

    Die Seite mit den Details zum Migrationsauftrag 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 ID 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 IDs aufrufen.

  • REGION mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
start MIGRATION_JOB_ID ^
  --region=REGION

Ergebnis

Die Aktion wird asynchron ausgeführt. Daher gibt dieser Befehl eine Vorgangsentität zurück, die einen lang andauernden Vorgang darstellt: 

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID
Um zu prüfen, ob der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

Migrationsjob anhalten

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

Console

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

    Migrationsjobs aufrufen

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

    Die Seite mit den Details zum Migrationsauftrag 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 ID 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 IDs aufrufen.

  • REGION mit der 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 lang andauernden Vorgang 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 angehaltenen Migrationsjob fortsetzen:

Console

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

    Migrationsjobs aufrufen

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

    Die Seite mit den Details zum Migrationsauftrag 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 ID 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 IDs aufrufen.

  • REGION mit der 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 lang andauernden Vorgang 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:

Console

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

    Migrationsjobs aufrufen

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

    Die Seite mit den Details zum Migrationsauftrag wird geöffnet.

  3. Klicken Sie auf Restart (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 ID 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 IDs aufrufen.

  • REGION mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.

  • Optional: Der Database Migration Service migriert standardmäßig alle Datenbanken in der Quelle. Wenn Sie nur bestimmte Datenbanken migrieren möchten, verwenden Sie das Flag --databases-filter und geben Sie die IDs als durch Kommas getrennte Liste an.

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

    Migrationsjobs, die Sie mit --database-filter flag erstellt haben, können Sie 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 lang andauernden Vorgang 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:

Migrationsjob-Entwurf aktualisieren

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

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

    Migrationsjobs aufrufen

  2. Klicken Sie auf dem Tab Entwürfe auf den Anzeigenamen des Migrationsjobs, dessen Erstellung Sie abschließen 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 ‑schemata in der Quelle, die vom Database Migration Service in das Ziel migriert werden. Der 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 daraus:

  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 von Database Migration Service in das Ziel migriert werden.

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

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

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

Maximale Anzahl gleichzeitiger Verbindungen zur Quelldatenbank anpassen

Sie können anpassen, wie viele gleichzeitige Verbindungen der 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 > Einstellungen für das Lesen der Quelle.

  4. Geben Sie in den Abschnitten Maximale Anzahl gleichzeitiger Verbindungen für vollständigen Dump oder Maximale Anzahl gleichzeitiger CDC-Verbindungen im Feld Benutzerdefiniert das maximale Verbindungslimit für die Phasen „Full Dump“ oder „CDC“ ein.

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

Einstellungen für die Zielkonfiguration anpassen

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

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

    Migrationsjobs aufrufen

  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: Mindestwert 2, Maximalwert 256

    Sie können festlegen, wie viele gleichzeitige Verbindungen der Database Migration Service zur Zielinstanz herstellen kann.

    Der Database Migration Service passt die Anzahl der Verbindungen an, um innerhalb des angegebenen Verbindungslimits die beste Leistung zu erzielen. Wenn Sie das maximale Verbindungslimit erhöhen, kann die Migrationsgeschwindigkeit verbessert werden. Dies führt jedoch zu einer zusätzlichen Belastung Ihrer Zieldatenbanken.

    Zeitüberschreitung für Transaktionen

    Standardwert: 30

    Zulässige Werte: Minimum 30, Maximum 300

    Während der Migration können beim Database Migration Service bestimmte Probleme auftreten, die dazu führen, dass die Transaktion abläuft. Sie können die Anzahl der Sekunden anpassen, die der Database Migration Service auf den Abschluss der Transaktion wartet, bevor sie abgebrochen wird.

    Abgebrochene Transaktionen führen nicht dazu, dass der Migrationsjob fehlschlägt. Der Migrationsjob kopiert weiterhin Daten, ändert aber seinen Status in Wird ausgeführt, weist aber Fehler auf. Sie können sich die Details zum Migrationsjob 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 der Database Migration Service alle erforderlichen Quell- und Zielentitäten erreichen kann. In der Google Cloud Console können Sie nur Migrationsjob-Entwürfe testen, die Sie im Migrationsjob-Erstellungsassistenten erstellt haben (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 ID 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 IDs aufrufen.

  • REGION mit der 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 lang andauernden Vorgang 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: