Migrationsjob zu einer neuen Zielinstanz erstellen

Wenn Sie Ihre Zielinstanz mit Database Migration Service erstellen, wird diese Instanz automatisch herabgestuft und als schreibgeschütztes Replikat ausgeführt. Das bedeutet, dass einige Vorgänge eingeschränkt sind. Wenn Sie beispielsweise während der Migration Nutzer in Ihrem neuen Ziel erstellen möchten, verwenden Sie Cloud SQL in der Google Cloud Console. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Nutzer verwalten.

Der Database Migration Service verwendet Migrationsjobs, um Daten aus der Quelldatenbankinstanz in die Zieldatenbankinstanz zu migrieren. Das Erstellen eines Migrationsjobs für eine neue Zielinstanz umfasst Folgendes:

  • Einstellungen für den Migrationsjob festlegen
  • Quellverbindungsprofil auswählen
  • 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

Bevor Sie einen Migrationsjob zu einer neuen Zieldatenbankinstanz erstellen, müssen Sie Folgendes tun:

  1. Prüfen Sie, ob dieser Migrationstyp Ihr Szenario unterstützt. Weitere Informationen finden Sie unter Bekannte Einschränkungen.
  2. Konfigurieren Sie Ihre Quelldatenbank und stellen Sie eine Netzwerkverbindung her. Das Erstellen eines Migrationsjobs ist einer der Schritte im gesamten Migrationsprozess. Wir empfehlen Ihnen, die Schritt-für-Schritt-Anleitung zur Migration zu befolgen und zu diesem Verfahren zurückzukehren, wenn Sie den Schritt „Migrationsjob“ erreicht haben. Weitere Informationen finden Sie unter Zu einer neuen 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 Konfigurationsassistenten für 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 zu diesem Zeitpunkt eingegeben haben, werden in einem Migrationsjobentwurf gespeichert. Sie können den Migrationsjobentwurf später fertigstellen.

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

      Dies ist ein menschenlesbarer 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 über Google Cloud CLI-Befehle oder die 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 basierend auf dem Standort 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.

  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 von physischen 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 mysqldump-Dienstprogramm 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 den Ordner aus, in den Sie die vollständige Dump-Datei hochgeladen haben. Achten Sie darauf, dass Sie den dedizierten Ordner auswählen, der die Vollsicherungsdatei enthält, und nicht den Speicher-Bucket selbst.

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

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

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

      1. Anfänglichen 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 Abschnitt Datendumpvorgang konfigurieren den Vorgangstyp aus, den Database Migration Service ausführen soll:

        • Parallelität beim Datenexport: Verwenden Sie eine leistungsstarke Parallelitätsoption, die bei der Migration zu MySQL-Versionen 5.7 oder 8 verfügbar ist.

          Die Geschwindigkeit der Datenparallelität hängt von der Last ab, die auf Ihre Quelldatenbank ausgeübt wird:

          • 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.
        • Dump-Flags: Diese Option schließt sich mit Datendump-Parallelität gegenseitig aus. Mit dieser Einstellung können Sie Flags für das Dienstprogramm mysqldump konfigurieren, das zum Erstellen der Dumpdatei verwendet wird.

          So fügen Sie ein Flag hinzu:

          1. Klicken Sie auf Flag hinzufügen.

          2. Wählen Sie eines der folgenden Flags aus:

            • add-locks: Dieses Flag umschließt jede Tabelle, die in der Dumpdatei enthalten ist, mit LOCK TABLES- und UNLOCK TABLES-Anweisungen. Dadurch werden Einfügungen beschleunigt, wenn die Dump-Datei in die Zielinstanz geladen wird.
            • ignore-error: Verwenden Sie dieses Flag, um eine Liste mit kommagetrennten Fehlernummern einzugeben. Diese Zahlen stehen für die Fehler, die vom mysqldump-Tool 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.
          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 mit dem Flag auf das Papierkorbsymbol.

      2. Eigene bereitstellen

        Diese Option ist nicht empfehlenswert, da Database Migration Service standardmäßig einen ersten Dump als Teil 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.

        Der Dump muss innerhalb der letzten 24 Stunden generiert worden sein und den Dump-Anforderungen 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.

      Der Bezeichner sollte keine vertraulichen Informationen oder personenidentifizierbare 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 Database Migration Service automatisch ein Passwort erstellt.

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

      Klicken Sie auf Nebenversionen einblenden, 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.

      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ü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 Erstellung einer Instanz verwendet wird:

      • Die Zonen verwenden standardmäßig Beliebig für die primäre Zone und Beliebig (außer primäre Zone) 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 die Migration über VPC-Peering oder einen umgekehrten SSH-Tunnel durchführen möchten, wählen Sie Private IP-Adresse aus.

        • Wenn Sie Verbindungen über die private IP-Adresse aktivieren möchten, müssen Sie alle zusätzlichen Netzwerkanforderungen erfüllen.

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

          • 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. Dafür benötigen Sie die IAM-Rolle compute.networkAdmin.
          • In Ihrem Projekt ist mindestens ein nicht-Legacy-VPC-Netzwerk oder ein freigegebene VPC-Netzwerk vorhanden.
          • Wenn Sie ein gemeinsam genutztes 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 die Migration über das Internet mithilfe einer IP-Zulassungsliste durchführen möchten, wählen Sie Öffentliche IP-Adresse aus.

        Klicken Sie optional unter Öffentliche IP-Adresse 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.

      Die Konnektivität des Migrationsjobs konfigurieren Sie in einem späteren Schritt. Weitere Informationen zu verfügbaren Netzwerkmöglichkeiten finden Sie unter Verbindungen 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
  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. Durch diese Funktion können zusätzliche Kosten für Cloud SQL entstehen. 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-Laufwerk (SSD) oder ein Festplattenlaufwerk (HDD) auswählen.
  5. Geben Sie die Speicherkapazität (in GB) für die Cloud SQL-Instanz an.

    Achten Sie darauf, dass die Instanz genügend Speicherplatz für die Daten aus Ihrer Quelldatenbank hat. 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 Ihre Verschlüsselung verwalten möchten, können Sie einen kundenverwalteten Verschlüsselungsschlüssel (CMEK) verwenden. Anleitung:

      1. Wählen Sie das Kästchen Kundenverwalteten Verschlüsselungsschlüssel (CMEK) verwenden aus.
      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 Ressourcenname des Schlüssels eingeben, um den Ressourcennamen des Schlüssels anzugeben, den Sie verwenden möchten. Beispiel für einen Schlüsselressourcennamen: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

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

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. Zu den aktuellen Netzwerkverbindungsmethoden für die Migration zu einer neuen Instanz gehören IP-Zulassungsliste, umgekehrter SSH-Tunnel, VPC-Peering und spezielles VPC-Peering nur für Cloud SQL for MySQL-Quellen.

Wenn Sie Folgendes verwenden möchten…Vorgehensweise
Die Methode zur Netzwerkverbindung über die 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 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 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 Cloudverbunden ist.
Die VPC-Peering-Netzwerkverbindungsmethode, Sie müssen das VPC-Netzwerk auswählen, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, um eine Verbindung zu diesem Netzwerk herzustellen.

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

Datenbanken für Migration konfigurieren

Sie können alle Datenbanken von der Quellinstanz migrieren oder nur bestimmte Datenbanken auswählen. Die Zielinstanz darf keine Datenbanken enthalten, die denselben Namen wie die Datenbanken haben, die Sie für die Migration auswählen. Wenn Database Migration Service auf einen Datenbanknamenskonflikt stößt, wird die betreffende Datenbank vor der Migration in der Zieldatenbank gelöscht.

  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 Datenbankerkennung auftritt, klicken Sie auf Aktualisieren. Wenn die Datenbankermittlung 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, erstellen und ausführen

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 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 bei 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 ausgefü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, erfordert der Database Migration Service zusätzlich eine kurze (ca. eine Minute) Unterbrechung der Schreibvorgänge zu Beginn der Migration. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

  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 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.
    • 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 zum --database-version-Flag.

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

      Sie können Ihre Version 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
    • Ersetzen Sie TIER durch den Namen des Cloud SQL-Maschinentyps, den Sie verwenden möchten. Maschinentypen werden als Strings angegeben, die der Cloud SQL-Konvention entsprechen, 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.

      Instanzen, die mit der Google Cloud CLI erstellt werden, verwenden standardmäßig die Cloud SQL for MySQL Enterprise Plus-Version, 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.

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

      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, 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) CONNECTION_PROFILE_NAME durch einen menschenlesbaren 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 andere Verbindungsmethoden verwenden. Weitere Informationen finden Sie unter Verbindung konfigurieren.

      Sie müssen keine zusätzlichen Flags verwenden, wenn Sie eine Verbindung über eine öffentliche IP-Adresse herstellen möchten. 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 für die Aktivierung der privaten IP-Verbindung erfüllen und zusätzliche Flags in Ihren Befehl einfügen.

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

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

      • --no-enable-ip-v4: (Optional) Damit Ihrer Zielinstanz keine öffentliche IP-Adresse zugewiesen wird. Ihrer Zielinstanz kann sowohl eine öffentliche als auch eine private IP-Adresse zugewiesen sein. Wenn Sie jedoch eine private IP-Verbindung 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

    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)

    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)

    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 Reverse-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 Konnektivität 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 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:

    • 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 Regionskennung, 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 mit einer maschinenlesbaren 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

    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)

    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)

    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]