Migrationsjob zu einer neuen Zielinstanz erstellen

MySQL   |  PostgreSQL   |  PostgreSQL zu AlloyDB

Das Erstellen eines Migrationsjobs umfasst:

• Einstellungen für den Migrationsjob festlegen.
• Informationen zum Verbindungsprofil angeben, das Sie für Ihre Quelldatenbank erstellt haben (Quellverbindungsprofil).
• Einstellungen für die Cloud SQL-Zieldatenbankinstanz 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

Hinweis :Wenn Sie bei der Migration zu einer mit Database Migration Service erstellten Cloud SQL-Instanz eine private IP-Verbindung verwenden, können Sie nur die Methode für den Zugriff auf private Dienste (VPC-Peering) verwenden. Wenn Sie Private Service Connect mit Ihrem Zielcluster verwenden möchten, erstellen Sie zuerst die Zielinstanz direkt in Cloud SQL und folgen Sie dann der Anleitung auf der Seite Zu einer vorhandenen Instanz migrieren.

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.

   Zu Migrationsjobs

2. Klicken Sie auf Migrationsjob erstellen.

   Die Seite des Assistenten für die Konfiguration von Migrationsjobs 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 dahin eingeben, werden in einem Migrationsjobentwurf gespeichert. Sie können den Migrationsjobentwurf 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 mithilfe von Google Cloud CLI-Befehlen oder der API des Database Migration Service zu arbeiten.

   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.

      Database Migration Service ist ein vollständig regionales Produkt. Das bedeutet, dass alle Entitäten, die mit Ihrer Migration zusammenhängen (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, muss Ihre Region für diese Version unterstützt werden. 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 Abschnitt 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: Wählen Sie diese Option aus, wenn Sie das Dienstprogramm Percona XtraBackup verwenden möchten, um eine eigene Sicherungsdatei bereitzustellen. Dieser Ansatz erfordert zusätzliche Vorbereitungsschritte. Eine vollständige Anleitung zur Verwendung physischer Sicherungsdateien, die von 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 Einstellungen für den Dump. 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 dann den Ordner aus, in den Sie die vollständige Dump-Datei hochgeladen haben. Wählen Sie den dedizierten 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 logische Sicherungsdatei zu sehen.

     Verwenden Sie im Bereich Legen Sie fest, wie die Dumpdatei generiert werden soll eine der folgenden Optionen:

     1. Ersten Dump automatisch generieren (empfohlen)

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

        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 Bereich Datenbankdump konfigurieren den Vorgangstyp aus, den Database Migration Service ausführen soll:

        • Paralleles Ausgeben von Daten: Verwenden Sie eine leistungsstarke Parallelisierungsoption, die bei der Migration zu MySQL-Version 5.7 oder 8 verfügbar ist.
          Wenn Sie die parallele Ausführung von Ladevorgängen verwenden möchten, müssen Sie die erforderlichen Berechtigungen für die Quelldatenbank für Ihr Szenario angeben, z. B. LOCK_TABLES. Weitere Informationen zu den erforderlichen Berechtigungen für Quelldatenbanken finden Sie unter Quelldatenbank konfigurieren.

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

          • Optimal (empfohlen): Ausgewogene Leistung bei optimaler Auslastung der Quelldatenbank.
          • Maximal: Bietet die höchste Dump-Geschwindigkeit, 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.
        • Dump flags (Dump-Flags): Diese Option schließt Data dump parallelism (Datendump-Parallelität) aus. Mit dieser Einstellung können Sie Flags 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 umschließt jede Tabelle, die in der Dump-Datei enthalten ist, mit LOCK TABLES- und UNLOCK TABLES-Anweisungen. Dadurch werden Einfügungen beschleunigt, 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 legen Sie die maximale Größe des Puffers für die Kommunikation zwischen dem MySQL-Client und der MySQL-Quelldatenbank fest. 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 rechts neben der Zeile, die das Flag enthält, auf das Papierkorbsymbol.

     2. Eigene bereitstellen

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

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

        Prüfen Sie, ob der Dump innerhalb der letzten 24 Stunden generiert wurde und den Dumpanforderungen entspricht.

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 ID für die Cloud SQL-Instanz an oder verwenden Sie die automatisch generierte ID.

      Der Bezeichner sollte 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 an. 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 Database Migration Service 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 Unterstützung der versionsübergreifenden Migration

   4. Wählen Sie die Cloud SQL for MySQL-Version für Ihre 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 eine Instanz für Hochverfügbarkeit konfigurieren, wählen Sie Mehrere Zonen (Hochverfügbarkeit) 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 eine Art erforderlich. Wählen Sie eine der folgenden Optionen aus:
      • Wenn Sie über VPC-Peering oder einen umgekehrten SSH-Tunnel migrieren möchten, wählen Sie Private IP aus.

        • Damit Verbindungen über die private IP-Adresse möglich sind, müssen Sie alle zusätzlichen Netzwerkanforderungen erfüllen.

          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 Zugriff auf private Dienste für Ihr Projekt konfiguriert. Dazu benötigen Sie die IAM-Rolle compute.networkAdmin.
          • In Ihrem Projekt gibt es mindestens ein Nicht-Legacy-VPC-Netzwerk oder ein freigegebene VPC-Netzwerk.
          • Wenn Sie ein freigegebene 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 für das Peering aus. 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 die 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 mithilfe einer IP-Zulassungsliste migrieren möchten, wählen Sie Öffentliche IP-Adresse aus.
        

        Klicken Sie optional unter Öffentliche IP auf das Feld Autorisierte Netzwerke und autorisieren Sie entweder ein Netzwerk oder einen Proxy, um eine Verbindung zur Cloud SQL-Instanz herzustellen. Netzwerke werden nur mit den von Ihnen angegebenen Adressen autorisiert. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Öffentliche IP-Adresse konfigurieren.

      Sie konfigurieren die Konnektivität des Migrationsjobs in einem späteren Schritt. Weitere Informationen zu den 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. MySQL
   Hinweis:Die im Feld Maschinentyp verfügbaren Maschinen hängen von der verwendeten Cloud SQL-Version ab.
3. Für Cloud SQL for MySQL Enterprise Plus: Wählen Sie das Kästchen Datencache aktivieren aus, wenn Sie die Datencachefunktion 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 und Ihrer Zieldatenbank eine lokale Hochgeschwindigkeits-SSD hinzufü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 Solid State Drive (SSD) oder ein Festplattenlaufwerk (HDD) auswählen.
5. Geben Sie die Speicherkapazität (in GB) für die Cloud SQL-Instanz an.

   Die Instanz muss genügend 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 Ihre Zielinstanz.

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

   Klicken Sie auf Optionale Konfigurationen einblenden 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 Ihr Schlüssel nicht angezeigt wird, klicken Sie auf Ressourcennamen des Schlüssels eingeben, um den Ressourcennamen des Schlüssels anzugeben, den Sie verwenden möchten. Beispiel für den Ressourcenname des Schlüssels: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

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

      Wenn Database Migration Service diese Berechtigungen nicht hat, wird eine Meldung angezeigt, in der angegeben wird, dass das Dienstkonto von Database Migration Service den 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 (CMEK) 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-Zielinstanz mit denen der Quelldatenbank übereinstimmen. 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. Database Migration Service erstellt jetzt Ihre Cloud SQL-Zielinstanz. Dieser Vorgang kann einige Minuten dauern.
   Wichtiger Hinweis:

   • Database Migration Service erstellt eine Cloud SQL-Instanz, für die Ihnen die angegebenen Konfigurationen in Rechnung gestellt werden. Wenn der Erstellungsvorgang für den Migrationsjob vor Abschluss 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 wird 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 nicht mehr in der Database Migration Service-Konsole bearbeitet werden. Sie können weiterhin direkt in der Cloud SQL-Konsole auf die Instanz zugreifen, um sie zu ä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 eine Verbindung zur Quelldatenbank herstellt. Derzeit sind folgende Netzwerkverbindungsmethoden verfügbar: IP-Zulassungsliste, umgekehrter SSH-Tunnel und VPC-Peering.

Wenn Sie… verwenden möchten	Vorgehensweise
Die Netzwerkverbindungsmethode „IP-Zulassungsliste“	Sie müssen die ausgehende IP-Adresse Ihrer Zielinstanz angeben. Wenn die von Ihnen erstellte Cloud SQL-Instanz eine Instanz mit Hochverfügbarkeit ist, geben Sie die ausgehenden IP-Adressen für die primäre und die sekundäre Instanz an.
Die Methode für die Netzwerkverbindung über umgekehrte 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 Skript zur Verfügung, das die Schritte zum Einrichten des Tunnels zwischen den Quell- und Zieldatenbanken ausführt. 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 Cloudverbunden ist.
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

Prüfen Sie in diesem letzten Schritt die Zusammenfassung der Einstellungen für den Migrationsjob, die Quelle, das Ziel und die Verbindungsmethode und testen Sie 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 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 Migrationsjobtest finden Sie unter Probleme mit MySQL diagnostizieren.

2. Wenn der Test des Migrationsjobs abgeschlossen ist, klicken Sie 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 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.

   Die Migration wird jetzt durchgeführt. Wenn Sie den Migrationsjob starten, beginnt Database Migration Service mit dem vollständigen Dump und sperrt die Quelldatenbank kurzzeitig. Wenn sich Ihre Quelle in Amazon RDS oder Amazon Aurora befindet, ist für Database Migration Service zusätzlich eine kurze Unterbrechung der Schreibvorgänge (ca. unter einer Minute) zu Beginn der Migration erforderlich. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

   Achtung:Wenn Sie Terraform zum Bereitstellen Ihrer Zieldatenbank verwendet haben, kann es während der Ausführung des Migrationsjobs zu Konfigurationsabweichungen kommen. Versuchen Sie nicht, Terraform-Einstellungen noch einmal anzuwenden, bevor die Migration abgeschlossen ist. Weitere Informationen finden Sie unter Terraform-Konfigurationsabweichung.
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 einem einzigen Vorgang.
   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 die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie 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 durch eine maschinenlesbare Kennung für Ihr Verbindungsprofil.
   • DATABASE_VERSION durch die 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.

     Alle möglichen MySQL-Versionen finden Sie in der Referenz für das --database-version-Flag.

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

     Sie können die Edition mit dem Flag --edition und einem der folgenden Werte ändern:

     • 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 Cloud SQL-Maschinentyps, den Sie verwenden möchten. Maschinentypen werden als Strings angegeben, die der Cloud SQL-Konvention folgen, z. B. db-n1-standard-1, db-perf-optimized-N-2. Eine vollständige Liste der verfügbaren Maschinentypen und ihrer Kennungen für die Verwendung mit der Google Cloud CLI finden Sie in der Cloud SQL for MySQL-Dokumentation unter Maschinentypen.

     Für Instanzen, die mit der Google Cloud CLI erstellt werden, wird standardmäßig die Cloud SQL for MySQL Enterprise Plus-Version verwendet, für die andere Maschinentypen verfügbar sind. Wenn Sie einen Maschinentyp verwenden möchten, der nur in der Cloud SQL for MySQL Enterprise Edition verfügbar ist, geben Sie die Edition mit dem optionalen Flag --edition=enterprise an.

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

     Standardmäßig wird für neue Instanzen, die Sie mit der Google Cloud CLI erstellen, die Cloud SQL for MySQL Enterprise Plus-Version verwendet. Wenn Sie Cloud SQL for MySQL Enterprise Plus verwenden möchten, muss Ihre Region diese Version unterstützen. Regionsunterstützung für Cloud SQL for MySQL Enterprise Plus Mit dem optionalen Flag --edition können Sie die Edition ändern.

   • (Optional) Ersetzen Sie CONNECTION_PROFILE_NAME durch einen für Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.
   • Netzwerkkonfiguration

     Standardmäßig wird neuen Instanzen, die Sie mit der Google Cloud CLI erstellen, eine öffentliche IP-Adresse zugewiesen und sie werden für die Verwendung öffentlicher IP-Verbindungen konfiguriert. Sie können auch andere Verbindungsmethoden verwenden. Weitere Informationen finden Sie unter Verbindungen konfigurieren.

     Wenn Sie öffentliche IP-Verbindungen verwenden möchten, sind keine zusätzlichen Flags erforderlich. Wenn Sie die Verbindung über private IP-Adressen mit VPC-Netzwerk-Peering oder einem Reverse-SSH-Tunnel verwenden möchten, müssen Sie die folgenden zusätzlichen Netzwerkanforderungen für die Aktivierung der Verbindung über private IP-Adressen erfüllen 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 Zugriff auf private Dienste für Ihr Projekt konfiguriert. Dazu benötigen Sie die IAM-Rolle compute.networkAdmin.
     • In Ihrem Projekt gibt es mindestens ein Nicht-Legacy-VPC-Netzwerk oder ein freigegebene VPC-Netzwerk.
     • Wenn Sie ein freigegebene 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 ein, wenn Sie die Konnektivität über private IP-Adressen verwenden möchten (mit VPC-Netzwerk-Peering oder mit einem Reverse-SSH-Tunnel auf einer Compute Engine-VM):

     • --no-enable-ip-v4: (Optional) Weisen Sie Ihrer Zielinstanz keine öffentliche IP-Adresse zu. Ihrer Zielinstanz kann sowohl eine öffentliche als auch eine private IP-Adresse zugewiesen sein. Wenn Sie jedoch private IP-Verbindungen verwenden, ist eine öffentliche IP-Adresse möglicherweise nicht erwünscht.
     • --private-network: Wenn Sie Ihrer Zielinstanz eine private IP-Adresse zuweisen möchten, geben Sie den Namen der Virtual Private Cloud an, der Sie eine private IP-Adresse zuweisen möchten.

   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. Migrationsjob erstellen
   Wenn Sie VPC-Peering oder eine umgekehrte SSH-Tunnelverbindung verwenden, müssen Sie die erforderlichen Flags wie --peer-vpc oder --vm, --vm-ip, --vm-port, --vpc hinzufügen. Weitere Informationen finden Sie unter Verbindung konfigurieren und Google Cloud CLI-Beispiele.
   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 die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie 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 ID für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs mithilfe von Google Cloud CLI-Befehlen oder der API des Database Migration Service zu arbeiten.
   • REGION durch die Regions-ID, in der Sie den Migrationsjob speichern möchten.
   • MIGRATION_JOB_NAME durch einen für Menschen lesbaren Namen für Ihren Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
   • SOURCE_CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennzeichnung 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]