Migrationsjob zu einer neuen Zielinstanz erstellen

MySQL   |  PostgreSQL   |  PostgreSQL zu AlloyDB

Das Erstellen eines Migrationsjobs umfasst:

• Einstellungen für den Migrationsjob festlegen
• Geben Sie Informationen zum Verbindungsprofil an, das Sie für Ihre Quelldatenbank erstellt haben (Quellverbindungsprofil).
• Einstellungen für die Cloud SQL-Datenbankinstanz für das Ziel definieren und die Instanz erstellen.
• 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

So erstellen Sie einen Migrationsjob zu einer neuen Zielinstanz:

Console

Einstellungen für den Migrationsjob festlegen

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

   Migrationsjobs aufrufen

2. Klicken Sie auf Migrationsjob erstellen.

   Die Seite mit dem Konfigurationsassistenten für den Migrationsjob wird geöffnet. Dieser Assistent enthält mehrere Bereiche, in denen Sie durch die einzelnen Konfigurationsschritte geführt werden.

   Sie können die Erstellung eines Migrationsjobs jederzeit pausieren, indem Sie auf Speichern und beenden klicken. Alle Daten, die Sie bis zu diesem Punkt eingeben, werden in einem Migrationsjob-Entwurf gespeichert. Sie können den Migrationsauftrag im Entwurfsstatus später fertigstellen.

3. Geben Sie auf der Seite Erste Schritte die folgenden Informationen ein:
   1. Name des Migrationsjobs

      Dies ist ein für Menschen lesbarer Name für Ihren Migrationsjob. Dieser Wert wird in der Google Cloud Console angezeigt.

   2. Migrationsjob-ID

      Dies ist eine maschinenlesbare Kennung für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs zu arbeiten, indem Sie die Google Cloud CLI-Befehle oder die API des Database Migration Service verwenden.

   3. Wählen Sie in der Liste Quelldatenbankmodul die Option MySQL aus.

      Das Feld Zieldatenbankmodul wird automatisch ausgefüllt und kann nicht geändert werden.

   4. Wählen Sie die Region aus, in der Sie den Migrationsjob speichern möchten.

      Der Database Migration Service ist ein vollständig regionales Produkt. Das bedeutet, dass alle mit der Migration verbundenen Entitäten (Quell- und Zielverbindungsprofile, Migrationsjobs, Zieldatenbanken) in einer einzigen Region gespeichert werden müssen. Wählen Sie die Region anhand des Standorts der Dienste aus, die Ihre Daten benötigen, z. B. Compute Engine-Instanzen, App Engine-Anwendungen und andere Dienste. Nachdem Sie die Zielregion ausgewählt haben, kann diese Auswahl nicht mehr geändert werden.

      Wichtig:Wenn Sie die Cloud SQL for MySQL Enterprise Plus-Version verwenden möchten, prüfen Sie, ob Ihre Region für diese Version unterstützt wird. Weitere Informationen finden Sie unter Regionsunterstützung für Cloud SQL for MySQL Enterprise Plus.
4. Klicken Sie auf Speichern und fortfahren.

Informationen zum Quellverbindungsprofil angeben

Führen Sie auf der Seite Quelle definieren die folgenden Schritte aus:

1. Wählen Sie im Drop-down-Menü Quellverbindungsprofil das Verbindungsprofil für Ihre Quelldatenbank aus.
2. Klicken Sie im Bereich Konfiguration für vollständigen Dump anpassen auf Konfiguration bearbeiten.
3. Wählen Sie im Bereich Konfiguration für vollständigen Dump bearbeiten im Drop-down-Menü Methode für vollständigen Dump eine der folgenden Optionen aus:
   • Physisch basiert: Wählen Sie diese Option aus, wenn Sie das Percona XtraBackup-Dienstprogramm verwenden möchten, um Ihre eigene Sicherungsdatei bereitzustellen. Dieser Ansatz erfordert zusätzliche Vorbereitungsschritte. Eine vollständige Anleitung zur Verwendung von physischen Sicherungsdateien, die mit Percona XtraBackup generiert wurden, finden Sie unter Datenbanken mit einer physischen Percona XtraBackup-Datei migrieren.
   • Logisch: Wählen Sie diese Option aus, wenn Sie eine logische Sicherungsdatei verwenden möchten, die mit dem Dienstprogramm mysqlshell erstellt wurde. Database Migration Service kann diese Sicherungsdatei automatisch für Sie generieren oder Sie können eine eigene Kopie bereitstellen.
4. Bearbeiten Sie die restlichen Dump-Einstellungen. Führen Sie einen der folgenden Schritte aus:
   • Wenn Sie die physische Sicherungsdatei verwenden, klicken Sie unter Ordner angeben auf Durchsuchen und wählen Sie den Ordner aus, in dem Sie die Full-Dump-Datei hochgeladen haben. Wählen Sie den Ordner aus, der die vollständige Sicherungsdatei enthält, und nicht den Speicher-Bucket selbst.

   • Wenn Sie eine logische Sicherungsdatei verwenden, konfigurieren Sie die Parallelität des Datendumps oder die Dump-Flags.

     Maximieren Sie diesen Abschnitt, um die vollständigen Schritte für die Sicherungsdatei zu sehen.

     Wählen Sie im Bereich Legen Sie fest, wie die Dumpdatei generiert werden soll eine der folgenden Optionen aus:

     1. Ersten Dump automatisch generieren (empfohlen)

        Diese Option wird empfohlen, da der Database Migration Service immer eine erste Datenbank-Dumpdatei generiert, nachdem der Migrationsjob erstellt und gestartet wurde.

        Der Database Migration Service verwendet diese Datei, um die ursprünglichen Objektdefinitionen und Tabellendaten Ihrer Quelldatenbank zu reproduzieren, damit diese Informationen in eine Cloud SQL-Zieldatenbankinstanz migriert werden können.

        Wenn Sie den automatisch generierten Dump verwenden, wählen Sie im Abschnitt Datendumpvorgang konfigurieren den Vorgang aus, den Database Migration Service ausführen soll:

        • Parallelität des Datendumps: Verwenden Sie eine leistungsstarke Parallelitätsoption, die bei der Migration zu MySQL-Versionen 5.7 oder 8 verfügbar ist.
          Wenn Sie die Parallelausführung von Ladevorgängen verwenden, müssen Sie für Ihr Szenario die erforderlichen Berechtigungen für die Quelldatenbank (z. B. LOCK_TABLES) angeben. Weitere Informationen zu den erforderlichen Berechtigungen für Quelldatenbanken finden Sie unter Quelldatenbank konfigurieren.

          Die Geschwindigkeit der Datenparallelität hängt von der Auslastung Ihrer Quelldatenbank ab:

          • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank.
          • Maximal: Bietet die höchste Dumpgeschwindigkeit, kann aber zu einer erhöhten Belastung der Quelldatenbank führen.
          • Minimum: Beansprucht die geringste Menge an Rechenressourcen in der Quelldatenbank, hat aber möglicherweise einen langsameren Dump-Durchsatz.
        • Dump-Flags: Diese Option ist nicht mit Datendump-Parallelität kompatibel. Mit dieser Einstellung können Sie Flags direkt für das Dienstprogramm mysqldump konfigurieren, mit dem die Dumpdatei erstellt wird.

          So fügen Sie ein Flag hinzu:

          1. Klicken Sie auf Flag hinzufügen.

          2. Wählen Sie eine der folgenden Markierungen aus:

             • add-locks: Dieses Flag umgibt jede Tabelle in der Dumpdatei mit LOCK TABLES- und UNLOCK TABLES-Anweisungen. Dies führt zu schnelleren Einfügungen, wenn die Dumpdatei in die Zielinstanz geladen wird.
             • ignore-error: Mit diesem Flag können Sie eine Liste von durch Kommas getrennten Fehlernummern eingeben. Diese Zahlen stehen für die Fehler, die vom mysqldump-Dienstprogramm ignoriert werden.
             • max-allowed-packet: Mit diesem Flag wird die maximale Größe des Buffers für die Kommunikation zwischen dem MySQL-Client und der MySQL-Quelldatenbank festgelegt. Die Standardgröße des Puffers beträgt 24 MB, die maximale Größe 1 GB.
               Wenn Sie in den Tabellen der Quelldatenbank große BLOB-Spalten oder lange Strings verwenden, müssen Sie die Größe des Puffers für dieses Flag erhöhen.
             Weitere Informationen zu diesen Flags finden Sie in der Dokumentation zum Dienstprogramm mysqldump im MySQL 8.0-Referenzhandbuch.
          3. Klicken Sie auf FERTIG.
          4. Wiederholen Sie diese Schritte für jedes Flag, das Sie hinzufügen möchten.

          Wenn Sie ein Flag entfernen möchten, klicken Sie auf das Papierkorbsymbol rechts neben der Zeile, die das Flag enthält.

     2. Eigene bereitstellen

        Diese Option wird nicht empfohlen, da der Database Migration Service standardmäßig im Rahmen des Migrationsjobs einen ersten Dump ausführt.

        Wenn Sie Ihre eigene Dumpdatei verwenden möchten, wählen Sie Eigene Datei angeben aus, klicken Sie auf SUCHEN, wählen Sie die Datei (oder den gesamten Cloud Storage-Ordner, wenn Sie mehrere Dateien verwenden) aus und klicken Sie dann auf AUSWÄHLEN.

        Der Dump muss innerhalb der letzten 24 Stunden generiert worden sein und den Anforderungen an Dumpdateien entsprechen.

5. Klicken Sie auf Speichern und fortfahren.

Cloud SQL-Zielinstanz konfigurieren und erstellen

1. Wählen Sie auf der Seite Ziel definieren im Drop-down-Menü Typ der Zielinstanz die Option Neue Instanz aus. Legen Sie alle relevanten Einstellungen fest:
   1. Geben Sie im Feld Zielinstanz-ID eine Kennung für die Cloud SQL-Instanz an oder verwenden Sie die automatisch generierte Kennung.

      Die Kennung darf keine vertraulichen Informationen oder personenidentifizierbaren Informationen enthalten. Die Projekt-ID muss im Instanznamen nicht angegeben werden. Dies erfolgt automatisch, wo es erforderlich ist, beispielsweise in den Logdateien.

   2. Geben Sie im Feld Passwort ein alphanumerisches Passwort für die Cloud SQL-Zielinstanz ein. Dies ist das Passwort für das Administratorkonto root der Instanz.

      Sie können das Passwort entweder manuell eingeben oder auf Generieren klicken, damit der Datenbank-Migrationsdienst automatisch ein Passwort für Sie erstellt.

   3. Wählen Sie im Drop-down-Menü Datenbankversion die Datenbankversion für die Zielinstanz aus.

      Klicken Sie auf Nebenversionen anzeigen, um alle Nebenversionen aufzurufen. Weitere Informationen zur versionenübergreifenden Migration

   4. Wählen Sie die Cloud SQL for MySQL-Version für die Zielinstanz aus. Es gibt zwei Optionen: Cloud SQL for MySQL Enterprise-Version und Cloud SQL for MySQL Enterprise Plus-Version.

      Die Cloud SQL for MySQL-Versionen bieten unterschiedliche Funktionen, verfügbare Maschinentypen und Preise. Lesen Sie die Cloud SQL-Dokumentation, um die für Ihre Anforderungen geeignete Version auszuwählen. Weitere Informationen finden Sie unter Einführung in Cloud SQL for MySQL-Versionen.

   5. Im Menü Region wird dieselbe Region angezeigt, die Sie auf der Seite Erste Schritte ausgewählt haben.

      Wenn Sie Ihre Instanz für Hochverfügbarkeit konfigurieren, wählen Sie Mehrere Zonen (Hochverfügbar) aus. Sie können sowohl die primäre als auch die sekundäre Zone auswählen. Die folgenden Bedingungen gelten, wenn die sekundäre Zone während der Instanzerstellung verwendet wird:

      • Die Zonen verwenden standardmäßig Beliebig für die primäre Zone und Beliebig (abweichend von primär) für die sekundäre Zone.
      • Wenn sowohl die primäre als auch die sekundäre Zone angegeben sind, müssen sie unterschiedliche Zonen sein.
   6. Wählen Sie im Bereich Verbindungen aus, ob Sie eine öffentliche oder eine private IP-Adresse für die Zielinstanz hinzufügen möchten. Sie können Ihre Instanz so konfigurieren, dass sie beide Arten von IP-Adressen hat. Für die Migration ist jedoch mindestens ein Typ erforderlich. Wählen Sie eine der folgenden Optionen aus:
      • Wenn Sie mit VPC-Peering oder einem umgekehrten SSH-Tunnel migrieren möchten, wählen Sie Private IP-Adresse aus.

        • Damit eine Verbindung über eine private IP-Adresse möglich ist, müssen alle zusätzlichen Netzwerkanforderungen erfüllt sein.

          Maximieren Sie diesen Abschnitt, um die vollständigen Anforderungen an private IP-Adressen zu sehen.

          • Die Service Networking API ist aktiviert. Sie können die Service Networking API über die Google Cloud Console aktivieren.
          • Sie haben die IAM-Berechtigung servicenetworking.services.addPeering.
          • Sie haben den Zugriff auf private Dienste für Ihr Projekt konfiguriert. Dazu ist die IAM-Rolle compute.networkAdmin erforderlich.
          • In Ihrem Projekt ist mindestens ein Nicht-Legacy-VPC-Netzwerk oder ein Shared VPC-Netzwerk vorhanden.
          • Wenn Sie ein freigegebenes VPC-Netzwerk verwenden, müssen Sie außerdem Folgendes tun:
            • Aktivieren Sie die Service Networking API für das Hostprojekt.
            • Fügen Sie Ihren Nutzer dem Hostprojekt hinzu.
            • Weisen Sie Ihrem Nutzer im Hostprojekt die IAM-Rolle compute.networkAdmin zu.
        • Wählen Sie das zugehörige VPC-Netzwerk aus, mit dem eine Peering-Verbindung hergestellt werden soll. Wenn Sie eine Verbindung zur Migrationsquelle über VPC-Peering herstellen möchten, wählen Sie die VPC aus, in der sich die Instanz befindet.
        • Wenn für das ausgewählte VPC noch kein Netzwerk für verwaltete Dienste konfiguriert wurde, können Sie entweder einen IP-Bereich auswählen und auf Verbinden klicken oder einen automatisch ausgewählten IP-Bereich verwenden und auf Zuweisen und verbinden klicken.
      • Wenn Sie über das Internet mit einer IP-Zulassungsliste migrieren möchten, wählen Sie Öffentliche IP-Adresse aus.
        

        Optional: Klicken Sie unter Öffentliche IP-Adresse auf das Feld Autorisierte Netzwerke und autorisieren Sie entweder ein Netzwerk oder einen Proxy für die Verbindung zur Cloud SQL-Instanz. Netzwerke werden nur mit den von Ihnen angegebenen Adressen autorisiert. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Öffentliche IP-Adresse konfigurieren.

      Die Konnektivität des Migrationsjobs konfigurieren Sie in einem späteren Schritt. Weitere Informationen zu verfügbaren Netzwerkmethoden finden Sie unter Verbindung konfigurieren.

2. Wählen Sie den Maschinentyp für die Cloud SQL-Instanz aus. Die Laufwerkgröße muss größer oder gleich der Quelldatenbankgröße sein. Weitere Informationen zu MySQL-Maschinentypen
   Hinweis:Welche Maschinen in der Auswahl Maschinentyp verfügbar sind, hängt von der verwendeten Cloud SQL-Version ab.
3. Cloud SQL for MySQL Enterprise Plus-Version: Aktivieren Sie das Kästchen Datencache aktivieren, wenn Sie die Datencache-Funktion in Ihrer Zieldatenbank verwenden möchten.

   Der Datencache ist eine optionale Funktion, die für Cloud SQL for MySQL Enterprise Plus-Instanzen verfügbar ist. Dabei wird Ihrer Zieldatenbank ein lokales Solid State Drive mit hoher Geschwindigkeit hinzugefügt. Diese Funktion kann zusätzliche Kosten für Cloud SQL verursachen. Weitere Informationen zum Datencache finden Sie in der Cloud SQL-Dokumentation unter Datencache – Übersicht.

4. Geben Sie den Speichertyp für die Cloud SQL-Instanz an. Sie können entweder ein SSD (Solid State Drive) oder eine Festplatte (HDD) auswählen.
5. Geben Sie die Speicherkapazität (in GB) für die Cloud SQL-Instanz an.

   Die Instanz muss ausreichend Speicherplatz für die Daten aus Ihrer Quelldatenbank haben. Sie können diese Kapazität jederzeit erhöhen, aber nicht verringern.

6. Optional: Konfigurieren Sie Optionen für die Datenverschlüsselung oder Ressourcenlabels für die Zielinstanz.

   Maximieren Sie diesen Bereich, um die optionalen Schritte zu sehen.

   Klicken Sie auf Optionale Konfigurationen anzeigen und gehen Sie dann so vor:

   1. Geben Sie an, ob Sie die Verschlüsselung der Daten verwalten möchten, die von der Quelle zum Ziel migriert werden. Standardmäßig werden Ihre Daten mit einem von Google Cloudverwalteten Schlüssel verschlüsselt. Wenn Sie die Verschlüsselung selbst verwalten möchten, können Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel (CMEK) verwenden. Anleitung:

      1. Klicken Sie das Kästchen Vom Kunden verwalteten Verschlüsselungsschlüssel (CMEK) verwenden an.
      2. Wählen Sie im Menü Vom Kunden verwalteten Schlüssel auswählen Ihren CMEK aus.

      Wenn Sie den Schlüssel nicht sehen, klicken Sie auf Ressourcennamen des Schlüssels eingeben, um den Ressourcennamen des Schlüssels anzugeben, den Sie verwenden möchten. Beispiel für einen Ressourcennamen des Schlüssels: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

      Beim Erstellen des Migrationsjobs prüft der Database Migration Service, ob der CMEK vorhanden ist und ob der Database Migration Service Berechtigungen zur Verwendung des Schlüssels hat.

      Wenn der Database Migration Service diese Berechtigungen nicht hat, werden Informationen angezeigt, dass das Dienstkonto des Database Migration Service die CMEK nicht verwenden kann. Klicken Sie auf Erteilen, um dem Database Migration Service die Berechtigung zur Verwendung des Schlüssels zu erteilen.

      Weitere Informationen zum Erstellen eines CMEK finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.

   2. Fügen Sie alle erforderlichen Flags hinzu, die auf den Datenbankserver angewendet werden sollen. Achten Sie nach Möglichkeit darauf, dass die Datenbank-Flags in der erstellten Cloud SQL-Ziel-Instanz mit denen in der Quelldatenbank übereinstimmen. Weitere Informationen zu unterstützten Datenbank-Flags für MySQL
   3. Fügen Sie alle Labels hinzu, die für die Cloud SQL-Instanz spezifisch sind.

      Mit Labels können Instanzen organisiert werden. Sie können Labels beispielsweise nach Kostenstelle oder Umgebung organisieren. Labels sind auch auf Ihrer Rechnung aufgeführt, sodass Sie nachvollziehen können, wie sich die Kosten auf Ihre Labels verteilen.

7. Klicken Sie auf Ziel erstellen und fortfahren. Der Database Migration Service erstellt jetzt Ihre Cloud SQL-Zielinstanz. Dieser Vorgang kann einige Minuten dauern.
   Wichtige Information:

   • Der Database Migration Service erstellt eine Cloud SQL-Instanz, für die Ihnen die Kosten gemäß der angegebenen Konfiguration in Rechnung gestellt werden. Wenn der Erstellungsvorgang für den Migrationsjob vorzeitig beendet wird, verwenden Sie die Schaltfläche Abbrechen, um die Cloud SQL-Instanz zu bereinigen. Wenn der Browser oder Tab geschlossen wird, auf Speichern und beenden geklickt oder der Bildschirm verlassen wird, wird die Cloud SQL-Instanz nicht bereinigt und muss manuell auf der Seite „Cloud SQL-Instanzen“ gelöscht werden.
   • Nachdem die Zielinstanz erstellt wurde, können die Cloud SQL-Instanzeinstellungen in der Console des Datenbank-Migrationsdienstes nicht mehr bearbeitet werden. Sie können weiterhin direkt in der Cloud SQL-Konsole auf die Instanz zugreifen und sie ändern.

Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten

Wählen Sie im Drop-down-Menü Verbindungsmethode eine Netzwerkverbindungsmethode aus. Diese Methode definiert, wie die neu erstellte Cloud SQL-Instanz mit der Quelldatenbank verbunden wird. Zu den aktuellen Netzwerkverbindungsmethoden gehören IP-Zulassungsliste, umgekehrter SSH-Tunnel und VPC-Peering.

Sie möchten…	Gehen Sie dann so vor:
Die Netzwerkverbindungsmethode „IP-Zulassungsliste“	Sie müssen die ausgehende IP-Adresse der Zielinstanz angeben. Wenn die von Ihnen erstellte Cloud SQL-Instanz eine Hochverfügbarkeits-Instanz ist, geben Sie die ausgehenden IP-Adressen sowohl für die primäre als auch für die sekundäre Instanz an.
Die Netzwerkverbindungsmethode „Umgekehrter SSH-Tunnel“	Sie müssen die Compute Engine-VM-Instanz auswählen, auf der der Tunnel gehostet wird. Nachdem Sie die Instanz angegeben haben, stellt Google ein Script zur Verfügung, das die Schritte zum Einrichten des Tunnels zwischen der Quell- und der Zieldatenbank ausführt. Sie müssen das Script in der Google Cloud CLI ausführen. Führen Sie die Befehle auf einem Computer aus, der sowohl eine Verbindung zur Quelldatenbank als auch zu Google Cloudhat.
Die Netzwerkverbindungsmethode „VPC-Peering“	Sie müssen das VPC-Netzwerk auswählen, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, damit eine Verbindung mit diesem Netzwerk hergestellt wird.

Nachdem Sie die Netzwerkverbindung ausgewählt und konfiguriert haben, klicken Sie auf Konfigurieren und fortfahren.

Migrationsjob testen, erstellen und ausführen

In diesem letzten Schritt sehen Sie sich die Zusammenfassung der Einstellungen, der Quelle, des Ziels und der Verbindungsmethode des Migrationsjobs an und testen dann die Gültigkeit der Konfiguration des Migrationsjobs. Falls Probleme auftreten, können Sie die Einstellungen des Migrationsjobs ändern. Nicht alle Einstellungen können bearbeitet werden.

1. Klicken Sie auf der Seite Migrationsjob testen und erstellen auf Job testen.

   Wenn der Test fehlschlägt, können Sie das Problem an der entsprechenden Stelle des Ablaufs beheben und zum erneuten Test zurückkehren. Informationen zur Fehlerbehebung bei einem fehlgeschlagenen Test eines Migrationsjobs finden Sie unter Probleme für MySQL diagnostizieren.

2. Klicken Sie nach Abschluss des Tests auf Job erstellen und starten, um den Migrationsjob zu erstellen und sofort zu starten, oder auf Job erstellen, um den Migrationsjob zu erstellen, ohne ihn sofort zu starten.

   Wenn der Job nicht direkt nach dem Erstellen gestartet wird, können Sie ihn auf der Seite Migrationsjobs durch Klicken auf STARTEN starten. Unabhängig davon, wann der Migrationsjob gestartet wird, wird Ihrer Organisation die Existenz der Zielinstanz in Rechnung gestellt.

   Die Migration ist jetzt in Bearbeitung. 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 zu Beginn der Migration zusätzlich eine kurze Unterbrechung der Schreibvorgänge (ungefähr unter einer Minute). Weitere Informationen finden Sie unter Bekannte Einschränkungen.

   Achtung:Wenn Sie Ihre Zieldatenbank mit Terraform bereitgestellt haben, kann es während der Ausführung des Migrationsjobs zu Konfigurationsabweichungen kommen. Versuchen Sie nicht, die Terraform-Einstellungen noch einmal anzuwenden, bevor die Migration abgeschlossen ist. Weitere Informationen finden Sie unter Abweichungen bei Terraform-Konfigurationen.
3. Fahren Sie mit Migrationsjob prüfen fort.

gcloud

1. Zielverbindungsprofil erstellen.
   Wenn Sie mit der Google Cloud CLI zu einer neuen Zielinstanz migrieren, erstellen Sie die Zielinstanz und das Verbindungsprofil in einer einzigen Aktion.
   Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

   gcloud database-migration connection-profiles create cloudsql

   In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass einige Befehle einige Zeit in Anspruch nehmen können. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall 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:

   • CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung für Ihr Verbindungsprofil.
   • DATABASE_VERSION mit der MySQL-Version, die Sie in der Zielinstanz verwenden möchten. Datenbankversionen werden als Strings angegeben, die sowohl die Haupt- als auch die Nebenversion enthalten. Beispiele: MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36.

     Informationen zu allen möglichen MySQL-Versionen finden Sie in der Referenz zum Flag „--database-version“.

   • Optional: EDITION Standardmäßig verwenden neue Instanzen, die Sie mit der Google Cloud CLI erstellen, Cloud SQL for MySQL Enterprise Plus. Wenn Sie die Cloud SQL for MySQL Enterprise Plus-Version verwenden möchten, prüfen Sie, ob Ihre Region für diese Version unterstützt wird. Weitere Informationen finden Sie unter Regionsunterstützung für Cloud SQL for MySQL Enterprise Plus.

     Sie können die Version ändern, indem Sie das Flag --edition mit einem der folgenden Werte verwenden:

     • enterprise-plus für die Cloud SQL for MySQL Enterprise Plus-Version
     • enterprise für die Cloud SQL for MySQL Enterprise-Version
   • TIER durch den Namen des zu verwendenden Cloud SQL-Maschinentyps. Maschinentypen werden als Strings angegeben, die der Cloud SQL-Konvention folgen, z. B. db-n1-standard-1 oder db-perf-optimized-N-2. Eine vollständige Liste der verfügbaren Maschinentypen und ihrer IDs für die Verwendung mit der Google Cloud CLI finden Sie unter Maschinentypen in der Cloud SQL for MySQL-Dokumentation.

     Für mit der Google Cloud CLI erstellte Instanzen wird standardmäßig die Cloud SQL for MySQL Enterprise Plus-Version verwendet, für die verschiedene Maschinentypen verfügbar sind. Wenn Sie einen Maschinentyp verwenden möchten, der nur in der Cloud SQL for MySQL Enterprise-Version verfügbar ist, verwenden Sie das optionale Flag --edition=enterprise, um die Version anzugeben.

   • REGION durch die Kennung der Region ersetzen, in der Sie das Verbindungsprofil speichern möchten.

     Für neue Instanzen, die Sie mit der Google Cloud CLI erstellen, wird standardmäßig Cloud SQL für MySQL Enterprise Plus verwendet. Wenn Sie die Cloud SQL for MySQL Enterprise Plus-Version verwenden möchten, prüfen Sie, ob Ihre Region für diese Version unterstützt wird. Weitere Informationen finden Sie unter Regionsunterstützung für Cloud SQL for MySQL Enterprise Plus. Sie können die Version mit dem optionalen Flag --edition ändern.

   • Optional: CONNECTION_PROFILE_NAME mit einem von Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.
   • Netzwerkkonfiguration

     Neuen Instanzen, die Sie mit der Google Cloud CLI erstellen, wird standardmäßig eine öffentliche IP-Adresse zugewiesen und sie sind für die Verwendung einer öffentlichen IP-Verbindung konfiguriert. Sie können auch andere Verbindungsmethoden verwenden. Weitere Informationen finden Sie unter Verbindung konfigurieren.

     Wenn Sie eine öffentliche IP-Verbindung verwenden möchten, sind keine zusätzlichen Flags erforderlich. Wenn Sie eine private IP‑Verbindung mit VPC-Netzwerk-Peering oder einem Reverse-SSH-Tunnel verwenden möchten, müssen Sie die folgenden zusätzlichen Netzwerkanforderungen erfüllen, um die private IP‑Verbindung zu aktivieren, und zusätzliche Flags in Ihren Befehl aufnehmen.

     Maximieren Sie diesen Abschnitt, um die vollständigen Anforderungen an private IP-Adressen zu sehen.

     • Die Service Networking API ist aktiviert. Sie können die Service Networking API über die Google Cloud Console aktivieren.
     • Sie haben die IAM-Berechtigung servicenetworking.services.addPeering.
     • Sie haben den Zugriff auf private Dienste für Ihr Projekt konfiguriert. Dazu ist die IAM-Rolle compute.networkAdmin erforderlich.
     • In Ihrem Projekt gibt es mindestens ein Nicht-Legacy-VPC-Netzwerk oder ein Shared VPC-Netzwerk.
     • Wenn Sie ein freigegebenes VPC-Netzwerk verwenden, müssen Sie außerdem Folgendes tun:
       • Aktivieren Sie die Service Networking API für das Hostprojekt.
       • Fügen Sie Ihren Nutzer dem Hostprojekt hinzu.
       • Weisen Sie Ihrem Nutzer im Hostprojekt die IAM-Rolle compute.networkAdmin zu.

     Fügen Sie die folgenden zusätzlichen Flags hinzu, wenn Sie eine private IP‑Konnektivität verwenden möchten (mit VPC-Netzwerk-Peering oder mit einem umgekehrten SSH-Tunnel auf einer Compute Engine-VM):

     • --no-enable-ip-v4: (Optional) Wenn Sie der Zielinstanz keine öffentliche IP-Adresse zuweisen möchten. Sie können Ihrer Zielinstanz sowohl eine öffentliche als auch eine private IP-Adresse zuweisen. Wenn Sie jedoch eine private IP-Verbindung verwenden, ist eine öffentliche IP-Adresse möglicherweise nicht erforderlich.
     • --private-network: Wenn Sie Ihrer Zielinstanz eine private IP-Adresse zuweisen möchten, geben Sie den Namen der Virtual Private Cloud an, der eine private IP-Adresse zugewiesen werden soll.

   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 mysql CONNECTION_PROFILE_ID \
     --no-async \
     --region=REGION \
     --database-version=DATABASE_VERSION \
     --tier=TIER \
     --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 mysql CONNECTION_PROFILE_ID `
     --no-async `
     --region=REGION `
     --database-version=DATABASE_VERSION `
     --tier=TIER `
     --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 mysql CONNECTION_PROFILE_ID ^
     --no-async ^
     --region=REGION ^
     --database-version=DATABASE_VERSION ^
     --tier=TIER ^
     --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]
   

2. Erstellen Sie den Migrationsjob.
   Wenn Sie VPC-Peering oder eine Reverse-SSH-Tunnel-Konnektivität verwenden, fügen Sie die erforderlichen Flags hinzu, z. B. --peer-vpc, --vm, --vm-ip, --vm-port oder --vpc. Weitere Informationen finden Sie unter Verbindung konfigurieren und Beispiele für die Google Cloud CLI.
   Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

   gcloud database-migration migration-jobs create

   In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass einige Befehle einige Zeit in Anspruch nehmen können. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall 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 zu arbeiten, indem Sie die Google Cloud CLI-Befehle oder die API des Database Migration Service verwenden.
   • REGION durch die Regionskennung ersetzen, in der Sie den Migrationsjob speichern möchten.
   • MIGRATION_JOB_NAME durch einen für Menschen lesbaren Namen für den Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
   • SOURCE_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Quellverbindungsprofils.
   • DESTINATION_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Zielverbindungsprofils.

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

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

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

   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]