Migrationsjob zu einer vorhandenen Zielinstanz erstellen

MySQL   |  PostgreSQL   |  PostgreSQL zu AlloyDB

Übersicht

Der Database Migration Service verwendet Migrationsjobs, um Daten aus der Quelldatenbankinstanz in die Zieldatenbankinstanz zu migrieren.

Das Erstellen eines Migrationsjobs für eine vorhandene Zielinstanz umfasst Folgendes:

• Einstellungen für den Migrationsjob festlegen
• Quellverbindungsprofil auswählen
• Vorhandene Zieldatenbankinstanz auswählen
• Herabstufen der vorhandenen Instanz, um sie in ein Lesereplikat umzuwandeln
• Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten
• Den Migrationsjob testen, um zu überprüfen, ob die für den Job angegebenen Verbindungsinformationen gültig sind

Bei der Migration zu einer Zielinstanz, die außerhalb von Database Migration Service erstellt wurde, sind bestimmte Einschränkungen zu beachten. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

Der Database Migration Service-Assistent hilft Ihnen beim Erstellen eines Migrationsjobs. Dieser Assistent besteht aus den folgenden Bereichen: Jetzt starten, Quelle definieren, Ziel erstellen, Verbindungsmethode definieren, Migrationsdatenbanken konfigurieren und Migrationsjob testen und erstellen. Informationen zum Ausfüllen der einzelnen Bereiche finden Sie in den folgenden Abschnitten dieser Seite.

Migrationsjob mit der Google Cloud Console erstellen

Sie können die Erstellung eines Migrationsjobs pausieren, indem Sie auf Speichern und beenden klicken. Alle bis zu diesem Zeitpunkt ausgefüllten Daten werden in einem Migrationsjobentwurf gespeichert. Sie können auf diesen Job auf dem Tab Entwürfe zugreifen.

Wenn Sie die Erstellung eines Migrationsjobs abschließen möchten, rufen Sie den Tab auf und klicken Sie auf den Job. Der Erstellungsvorgang wird an der Stelle fortgesetzt, an der er unterbrochen wurde. Der Job bleibt ein Entwurf, bis Sie auf Erstellen oder Erstellen und starten klicken.

Einstellungen für den Migrationsjob festlegen

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

2. Klicken Sie oben auf der Seite auf Migrationsjob erstellen.

3. Geben Sie einen Namen für den Migrationsjob ein. Wählen Sie einen aussagekräftigen Namen, mit dem Sie den Migrationsjob identifizieren können. Der Jobname sollte keine vertraulichen oder personenidentifizierbaren Informationen enthalten.

4. Behalten Sie die automatisch generierte Migrationsjob-ID bei.

5. Wählen Sie das Quelldatenbankmodul aus.

6. Wählen Sie AlloyDB for PostgreSQL als Ziel-Engine aus.

7. Wählen Sie die Zielregion für die Migration aus. Diese Region muss mit der Region übereinstimmen, in der sich Ihre Zieldatenbank befindet. Nachdem Sie die Zielregion ausgewählt haben, kann diese Auswahl nicht mehr geändert werden.

8. Wählen Sie als Migrationsjobtyp Kontinuierlich (Snapshot + laufende Änderungen) aus.

9. Klicken Sie im Bereich Bevor Sie fortfahren, lesen Sie die Voraussetzungen auf Öffnen, um automatisch generierte Anleitungen aufzurufen, die Ihnen bei der Vorbereitung Ihrer Quelldatenbank für die Migration helfen können. Es wird empfohlen, die Voraussetzungen für diesen Schritt abzuschließen. Sie können sie aber auch jederzeit abschließen, bevor Sie den Migrationsjob testen oder starten. Weitere Informationen finden Sie unter Quelle konfigurieren.

10. Klicken Sie auf Speichern und fortfahren.

Informationen zum Quellverbindungsprofil angeben

1. Wenn Sie ein Verbindungsprofil erstellt haben, wählen Sie es aus der Liste der vorhandenen Verbindungsprofile aus.

   Wenn Sie noch kein Verbindungsprofil erstellt haben, klicken Sie unten in der Drop-down-Liste auf Verbindungsprofil erstellen und führen Sie die Schritte unter Quellverbindungsprofil erstellen aus.

   Es wird empfohlen, ein eigenes Verbindungsprofil für die AlloyDB-Migration zu erstellen.

2. Klicken Sie im Abschnitt Datendump-Konfigurationen anpassen auf Datendump-Konfigurationen einblenden.

   Die Geschwindigkeit der Parallelität des Datendumps hängt von der Last Ihrer Quelldatenbank ab. Sie können die folgenden Einstellungen verwenden:

   • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank.
   • Maximum: Bietet die höchsten Dump-Geschwindigkeiten, kann aber zu einer erhöhten Belastung der Quelldatenbank führen.
   • Minimum: Beansprucht die geringste Menge an Rechenressourcen in der Quelldatenbank, kann aber einen langsameren Dump-Durchsatz haben.

   Wenn Sie angepasste Einstellungen für die Parallelität des Datendumps verwenden möchten, müssen Sie die Parameter max_replication_slots, max_wal_senders und max_worker_processes in Ihrer Quelldatenbank erhöhen. Sie können Ihre Konfiguration prüfen, indem Sie am Ende der Erstellung des Migrationsjobs den Migrationsjobtest ausführen.

3. Klicken Sie auf Speichern und fortfahren.

Wenn Ihre Quelldatenbank eine Cloud SQL-Instanz ist und nur die öffentliche IP-Adresse aktiviert ist, müssen Sie die private IP-Adresse aktivieren, bevor Sie mit dem nächsten Abschnitt fortfahren. Denken Sie daran, das Verbindungsprofil mit der privaten IP-Adresse zu aktualisieren.

Zielinstanz auswählen

Für Cloud SQL-Quellen: Wenn Sie von einer Cloud SQL-Instanz, die eine private IP-Verbindung verwendet, zu einer Cloud SQL-Instanz migrieren, die einen IP-Bereich mit einer Adresse außerhalb von RFC 1918 verwendet, fügen Sie den Bereich außerhalb von RFC 1918 der Netzwerkkonfiguration Ihrer Cloud SQL-Quellinstanz hinzu. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Autorisierte Netzwerke konfigurieren.

1. Wählen Sie im Menü Typ des Zielclusters die Option Vorhandener Cluster aus.
2. Wählen Sie im Bereich Zielcluster auswählen den Zielcluster aus.
3. Prüfen Sie die Informationen zu Ihrem Cluster und klicken Sie auf Auswählen und fortfahren.
4. Für die Migration zu einer vorhandenen Zieldatenbank stuft Database Migration Service die Zielinstanz herab und konvertiert sie in ein Replikat. Geben Sie im Bestätigungsfenster die Kennung der Zielinstanz ein, um zu bestätigen, dass die Herabstufung sicher durchgeführt werden kann.
5. Klicken Sie auf Bestätigen und fortfahren.

Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten

Hinweis: Wenn Ihre Quelle Cloud SQL for PostgreSQL ist, sind die Verbindungsoptionen je nachdem, ob sich Ihre Cloud SQL-Quellinstanz in der alten oder der neuen Netzwerkarchitektur befindet, auf VPC-Peering und TCP-Proxy über eine in der Cloud gehostete VM beschränkt.

1. Wählen Sie im Drop-down-Menü Verbindungsmethode eine Netzwerkverbindungsmethode aus. Mit dieser Methode wird definiert, wie der neu erstellte AlloyDB-Cluster eine Verbindung zur Quelldatenbank herstellt. Zu den aktuellen Methoden für die Netzwerkverbindung gehören IP-Zulassungsliste, VPC-Peering, Private Service Connect-Schnittstellen, umgekehrter SSH-Tunnel und TCP-Proxy über eine in der Cloud gehostete VM.
2. Wenn Sie die Netzwerkverbindungsmethode „IP-Zulassungsliste“ auswählen, müssen Sie die ausgehende IP-Adresse Ihrer Zielinstanz angeben. Kopieren Sie die ausgehenden IP-Adressen für die primäre und die sekundäre Instanz und konfigurieren Sie damit die Netzwerkfirewall für Ihren Quelldatenbankserver sowie die Datei pg_hba.conf, sodass die Quelle Verbindungen von diesen Adressen akzeptieren kann.

3. Wenn Sie die Netzwerkverbindungsmethode „Umgekehrter SSH-Tunnel“ auswählen, wählen Sie die Compute Engine-VM-Instanz aus, auf der der Tunnel gehostet werden soll.

   Nachdem Sie die Instanz angegeben haben, stellt Google ein Script bereit, mit dem die Schritte zum Einrichten des Tunnels zwischen der Quell- und der Zieldatenbank ausgeführt werden. Sie müssen das Skript in der Google Cloud CLI ausführen.

   Führen Sie die Befehle auf einem Computer aus, der sowohl mit der Quelldatenbank als auch mit Google Cloud verbunden ist.

4. Wenn Sie eine der Methoden für private IP-Verbindungen verwenden, wählen Sie VPC-Peering oder PSC-Schnittstelle aus.
5. Wenn Sie die VPC-Peering-Netzwerkverbindungsmethode auswählen, wählen Sie das VPC-Netzwerk aus, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, um eine Verbindung zu diesem Netzwerk herzustellen.

6. Wenn Sie die Verbindungsmethode „TCP-Proxy über in der Cloud gehostete VM“ auswählen, geben Sie die erforderlichen Details für die neue Compute Engine-VM-Instanz ein, die den TCP-Proxy hosten soll.

   Nachdem Sie die Details angegeben haben, stellt die Google Cloud Konsole ein Skript bereit, mit dem Sie den Proxy zwischen der Quell- und der Zieldatenbank einrichten können. Sie müssen das Skript auf einem Computer mit einer aktualisierten Google Cloud CLI ausführen.

   Nach dem Ausführen des Skripts wird die private IP-Adresse der neu erstellten VM ausgegeben. Geben Sie die IP-Adresse ein und klicken Sie auf Konfigurieren und fortfahren.

7. Nachdem Sie die Methode für die Netzwerkverbindung ausgewählt und alle zusätzlichen Informationen für die Methode angegeben haben, klicken Sie auf KONFIGURIEREN UND FORTFAHREN.

Datenbanken für Migration konfigurieren

Sie können die Datenbanken auswählen, die Sie migrieren möchten.

1. Wählen Sie in der Liste Zu migrierende Datenbanken eine der folgenden Optionen aus:
   • Alle Datenbanken: Es werden alle Datenbanken ausgewählt, die in der Quelle vorhanden sind.
   • Bestimmte Datenbanken: Sie können bestimmte Datenbanken aus allen Datenbanken auswählen, die in der Quelle vorhanden sind.

2. Wenn Sie bestimmte Datenbanken migrieren möchten, können Sie die angezeigte Liste filtern und die Datenbanken auswählen, die Database Migration Service zu Ihrem Ziel migrieren soll.

   Wenn die Liste nicht angezeigt wird und ein Fehler bei der Datenbankermittlung angezeigt wird, klicken Sie auf Neu laden. Wenn die Datenbankerkennung fehlschlägt, werden alle Datenbanken migriert. Sie können mit dem Erstellen eines Migrationsjobs fortfahren und Verbindungsfehler später beheben.

3. Klicken Sie auf Speichern und fortfahren.

Migrationsjob testen und erstellen

In diesem letzten Schritt prüfen Sie die Zusammenfassung der Einstellungen für den Migrationsjob, die Quelle, das Ziel und die Verbindungsmethode und testen dann die Gültigkeit der Einrichtung des Migrationsjobs. Wenn Probleme auftreten, können Sie die Einstellungen des Migrationsjobs ändern. Nicht alle Einstellungen können bearbeitet werden.

1. Klicken Sie auf JOB TESTEN, um Folgendes zu prüfen:

   • Die Quelldatenbank wurde gemäß den Voraussetzungen richtig konfiguriert.
   • Die Quell- und Zielinstanzen können miteinander kommunizieren.
   • Alle erforderlichen Aktualisierungen privater IP-Adressen am Ziel wurden vorgenommen.
   • Der Migrationsjob ist gültig und die Quell- und Zielversionen sind kompatibel.

   Wenn der Test fehlschlägt, können Sie das Problem an der entsprechenden Stelle des Ablaufs beheben und zum erneuten Test zurückkehren.

   Weitere Informationen zu den Gründen, warum der Test fehlschlagen kann, und zur Fehlerbehebung bei Problemen im Zusammenhang mit dem Fehlschlagen des Tests finden Sie unter Probleme für AlloyDB diagnostizieren.

   Der Migrationsjob kann auch dann erstellt werden, wenn der Test fehlschlägt. Nach dem Start des Jobs kann er jedoch irgendwann während der Ausführung fehlschlagen.

2. Klicken Sie auf JOB ERSTELLEN UND STARTEN, um den Migrationsjob zu erstellen und sofort zu starten, oder klicken Sie auf JOB ERSTELLEN, um den Migrationsjob zu erstellen, ohne ihn sofort zu starten.

   Wenn der Job nicht zum Zeitpunkt der Erstellung gestartet wird, kann er auf der Seite Migrationsjobs durch Klicken auf STARTEN gestartet werden.

   Unabhängig davon, wann der Migrationsjob beginnt, wird Ihrer Organisation die Zielinstanz in Rechnung gestellt.

   Wenn Sie den Migrationsjob starten, beginnt Database Migration Service mit dem vollständigen Dump und sperrt die Quelldatenbank kurz. Wenn sich Ihre Quelle in Amazon RDS oder Amazon Aurora befindet, erfordert der Database Migration Service zusätzlich eine kurze Unterbrechung der Schreibvorgänge (etwa unter einer Minute) zu Beginn der Migration. Weitere Informationen finden Sie unter Überlegungen zur Parallelität von Daten-Dumps.

3. Der Migrationsjob wird der Liste der Migrationsjobs hinzugefügt und kann direkt aufgerufen werden.

4. Fahren Sie mit Migrationsjob prüfen fort.

Migrationsjob mit der Google Cloud CLI erstellen

Wenn Sie mit der Google Cloud CLI zu einer vorhandenen Instanz migrieren, müssen Sie das Verbindungsprofil für die Zielinstanz manuell erstellen. Dies ist nicht erforderlich, wenn Sie die Google Cloud Console verwenden, da Database Migration Service das Erstellen und Entfernen des Zielverbindungsprofils für Sie übernimmt.

Hinweis

Bevor Sie mit der gcloud CLI einen Migrationsjob zu einer vorhandenen Zieldatenbankinstanz erstellen, müssen Sie Folgendes tun:

• Erstellen Sie die Zieldatenbankinstanz.
• Bereiten Sie Ihre Quelldatenbankinstanz vor. Siehe:
  • Quelle konfigurieren
  • Quellverbindungsprofil erstellen (Die Kennung des Quellverbindungsprofils ist erforderlich, um einen Migrationsjob zu erstellen.)
  • Konnektivität konfigurieren

Zielverbindungsprofil erstellen

Erstellen Sie das Zielverbindungsprofil für Ihre vorhandene Zielinstanz, indem Sie den Befehl gcloud database-migration connection-profiles create ausführen:

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:

• CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennung für Ihr Verbindungsprofil.
• Ersetzen Sie REGION durch die Kennung der Region, in der Sie das Verbindungsprofil speichern möchten.
• DESTINATION_INSTANCE_ID durch die Instanz-ID Ihrer Zielinstanz.
• Optional: CONNECTION_PROFILE_NAME mit einem menschenlesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird 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 connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --alloydb-cluster=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_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 connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --alloydb-cluster=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_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 connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --alloydb-cluster=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

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

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Migrationsjob erstellen

Hinweis: Die folgenden Beispiele stellen ein Migrationsszenario dar, bei dem Sie die private IP-Verbindung zwischen der Quell- und der Zieldatenbank verwenden. Wenn Sie einen anderen Verbindungstyp verwenden, z. B. VPC-Peering oder einen umgekehrten SSH-Tunnel, müssen Sie die erforderlichen Flags wie --peer-vpc oder --vm, --vm-ip, --vm-port, --vpc hinzufügen. Weitere Informationen finden Sie unter Konnektivität konfigurieren und Beispiele für die Google Cloud CLI.

Hinweis :Für Migrationen zu AlloyDB wird nur der kontinuierliche Migrationstyp unterstützt.

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. 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 eine maschinenlesbare Kennung für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs mithilfe von Google Cloud CLI-Befehlen oder der API von Database Migration Service zu arbeiten.
• REGION durch die Regions-ID, in der Sie den Migrationsjob 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.

• Optional: 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 Kennungen als durch Kommas getrennte Liste an.

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

  Sie können Migrationsjobs, die Sie mit dem Flag --databases-filter erstellt haben, später mit dem Befehl gcloud database-migration migration-jobs update bearbeiten.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --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 `
  --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 ^
  --type=CONTINUOUS ^

Sie sollten eine Antwort ähnlich der folgenden erhalten:

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

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

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

Zieldatenbank herabstufen

Database Migration Service erfordert, dass die Zieldatenbankinstanz während der Migration als Lesereplikat fungiert. Bevor Sie den Migrationsjob starten, führen Sie den Befehl gcloud database-migration migration-jobs demote-destination aus, um die Zieldatenbankinstanz herabzustufen.

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

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

Migrationsjobs verwalten

Ihr Migrationsjob ist jetzt konfiguriert und mit Ihrer Zieldatenbankinstanz verbunden. Sie können sie mit den folgenden Vorgängen verwalten:

1. Optional: Migrationsjob prüfen
   Wir empfehlen, den Migrationsjob zuerst mit dem Befehl gcloud database-migration migration-jobs verify zu prüfen.

   Weitere Informationen finden Sie im folgenden Abschnitt:

   gcloud database-migration migration-jobs verify

   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.

2. Optional: Informationen zu den für die Migration ausgewählten Datenbanken abrufen.
   Wenn Sie bestimmte Datenbanken migrieren, muss Database Migration Service die Details zu den Datenbanken abrufen, die Sie für den Migrationsjob mit dem Flag --database-filter ausgewählt haben.

   Bevor Sie den Migrationsjob starten, führen Sie den Befehl gcloud database-migration migration-jobs fetch-source-objects aus.

   Weitere Informationen finden Sie im folgenden Abschnitt:

   gcloud database-migration migration-jobs fetch-source-objects

   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 \
   fetch-source-objects 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 `
   fetch-source-objects 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 ^
   fetch-source-objects 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': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

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

3. Migrationsjob starten.
   Starten Sie den Migrationsjob mit dem Befehl gcloud database-migration migration-jobs start.

   Weitere Informationen finden Sie im folgenden Abschnitt:

   gcloud database-migration migration-jobs start

   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 hochstufen

Sobald die Migration die CDC-Phase (Change Data Capture) erreicht, können Sie die Zieldatenbankinstanz von einem Lesereplikat zu einer eigenständigen Instanz hochstufen. Zum Abrufen der aktuellen Richtlinie führen Sie den Befehl gcloud database-migration migration-jobs promote aus:

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 \
promote 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 `
promote 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 ^
promote 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.