Datenbanken mit einer physischen Percona XtraBackup-Datei migrieren

Sie können Ihre MySQL-Datenbanken mithilfe physischer Datenbank-Sicherungsdateien, die mit dem Dienstprogramm Percona XtraBackup for MySQL erstellt wurden, zu Cloud SQL migrieren. Die Migration mit physischen Sicherungsdateien bietet höhere Geschwindigkeiten bei der Datenwiederherstellung im Vergleich zu Migrationen, die logische Sicherungsdateien verwenden. Dies macht sie zu einer guten Wahl, wenn Sie große Datenbanken mit mehreren Terabytes an Daten verschieben möchten.

Dieser Migrationsablauf umfasst die folgenden Aufgaben:

  1. Sichern der MySQL-Quellinstanz und Vorbereiten der physischen Sicherungsdateien mit dem Dienstprogramm Percona XtraBackup for MySQL.

  2. Hochladen der Sicherungsdateien in einen Cloud Storage-Bucket.

  3. Erstellen und Ausführen des Migrationsjobs in Database Migration Service.

    Je nach Szenario können Sie die Zielinstanz selbst erstellen oder den Database Migration Service damit beauftragen, die Zielinstanz im Rahmen der Erstellung des Migrationsjobs zu erstellen. Weitere Informationen finden Sie im Schritt Migrationsjob konfigurieren und ausführen.

  4. Hochstufen des Migrationsjobs, nachdem die Daten vollständig migriert wurden.

Offline-Migrationen

In diesem Leitfaden werden Migrationsszenarien für Umgebungen beschrieben, in denen Sie eine Netzwerkverbindung zwischen den Quell- und Zieldatenbankinstanzen herstellen können.

Es ist möglich, eine Testmigration durchzuführen, bei der der Database Migration Service keine Verbindung zu Ihrer Quellinstanz herstellt. Stattdessen liest der Database Migration Service nur die Sicherungsdateien, die Sie in den Cloud Storage-Bucket hochladen, und repliziert deren Inhalt an das Cloud SQL for MySQL-Ziel. Ein Migrationsablauf, der keine Netzwerkverbindung verwendet, wird für Produktionsmigrationen nicht empfohlen, da der Database Migration Service die Datenüberprüfung nicht vollständig durchführen kann.

Wenn Sie versuchen möchten, einen Offline-Migrationsjob auszuführen, passen Sie die Verfahren so an:

Beschränkungen

In diesem Abschnitt werden die Einschränkungen für Migrationen mit physischen Percona XtraBackup-Dateien aufgeführt:

  • Die Migration zu MySQL 5.6 oder 8.4 mit einer physischen Sicherungsdatei wird nicht unterstützt. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

  • Versionsübergreifende Überlegungen:

    • Sie können nur innerhalb derselben Hauptversion der Datenbank migrieren, z. B. von MySQL 8.0.30 auf MySQL 8.0.35 oder von MySQL 5.7.0 auf MySQL 5.7.1.

    • Sie können nicht von MySQL 5.7 auf MySQL 8.0 migrieren.

    • Die Migration zu früheren Haupt- oder Nebenversionen der Datenbank wird nicht unterstützt. Sie können beispielsweise nicht von MySQL 8.0 auf 5.7 oder von MySQL 8.0.36 auf 8.0.16 migrieren.

  • Sie müssen Percona XtraBackup verwenden, um Ihre Daten im Cloud Storage-Bucket zu sichern. Andere Sicherungstools werden nicht unterstützt.

  • Die Datenbankmigration von einer physischen Percona XtraBackup-Datei wird nur für lokale oder selbstverwaltete VM-MySQL-Datenbanken unterstützt. Die Migration von Amazon Aurora- oder MySQL unter Amazon RDS-Datenbanken wird nicht unterstützt.

  • Sie können nur von einer vollständigen Sicherung migrieren. Andere Sicherungstypen wie inkrementelle oder teilweise Sicherungen werden nicht unterstützt.

  • Die Datenbankmigration umfasst keine Datenbanknutzer oder ‑berechtigungen.

  • Sie müssen das Binärlogformat auf ROW festlegen. Wenn Sie das Binärprotokoll in einem anderen Format wie STATEMENT oder MIXED konfigurieren, schlägt die Replikation möglicherweise fehl.

  • Datenbanken mit Tabellen, die größer als 5 TB sind, werden nicht unterstützt.

  • In Cloud Storage ist die Größe einer Datei, die Sie in einen Bucket hochladen können, auf 5 TB begrenzt. Wenn die physische Percona XtraBackup-Datei 5 TB überschreitet, müssen Sie die Sicherungsdatei in kleinere Dateien aufteilen.

  • Achten Sie darauf, die Sicherungsdateien in einen dedizierten Cloud Storage-Ordner hochzuladen, der keine anderen Dateien enthält.

  • Sie müssen den Parameter innodb_data_file_path nur mit einer Datendatei konfigurieren, die den Standarddateinamen für Daten ibdata1 verwendet. Wenn Ihre Datenbank mit zwei Datendateien konfiguriert ist oder eine Datendatei mit einem anderen Namen hat, können Sie die Datenbank nicht mit einer physischen Percona XtraBackup-Datei migrieren. Eine mit innodb_data_file_path=ibdata01:50M:autoextend konfigurierte Datenbank wird beispielsweise nicht für die Migration unterstützt.

  • Der Parameter innodb_page_size in Ihrer Quellinstanz muss mit dem Standardwert 16384 konfiguriert sein.

  • Sie können keine Plugins aus Ihrer externen Datenbank migrieren.

Kosten

Für homogene Migrationen zu Cloud SQL wird der Database Migration Service kostenlos angeboten. Die Preise für Cloud SQL und Cloud Storage gelten jedoch für Netzwerkkosten sowie für Cloud SQL- und Cloud Storage-Entitäten, die zu Migrationszwecken erstellt wurden.

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

  • Cloud Storage
  • Cloud SQL

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Hinweis

  1. Überlegen Sie, in welcher Region Sie die Zieldatenbank erstellen 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, Speicher-Buckets) in einer einzigen Region gespeichert werden müssen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Enable the Database Migration Service, Compute Engine, and Cloud SQL Admin APIs.

    Enable the APIs

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen homogener MySQL-Migrationen mithilfe physischer Sicherungsdateien benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Ausführen homogener MySQL-Migrationen mithilfe physischer Sicherungsdateien erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um homogene MySQL-Migrationen mithilfe physischer Sicherungsdateien durchzuführen:

  • Nutzerkonto, mit dem die Migration durchgeführt wird:
    • datamigration.*
    • resourcemanager.projects.get
    • resourcemanager.projects.list
    • cloudsql.instances.create
    • cloudsql.instances.get
    • cloudsql.instances.list
    • compute.machineTypes.list
    • compute.machineTypes.get
    • compute.projects.get
    • storage.buckets.create
    • storage.buckets.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Schritt 1: Anforderungen an die Netzwerkverbindung berücksichtigen

Es gibt verschiedene Netzwerkmethoden, mit denen Sie die Verbindung zwischen der Quelle und den Cloud SQL-Zielinstanzen konfigurieren können. Je nach verwendeter Methode sind während der Migration möglicherweise zusätzliche Schritte erforderlich.

Überlegen Sie, welche Verbindungsmethode für Ihr Szenario geeignet ist, bevor Sie mit den nächsten Schritten fortfahren. Ihre Wahl kann sich auf die erforderlichen Einstellungen auswirken. Weitere Informationen finden Sie unter Verbindung konfigurieren.

Schritt 2: Quelldaten vorbereiten

Führen Sie folgende Schritte aus, um die Daten für die Migration vorzubereiten:

  1. Installieren Sie die richtige Version des Percona XtraBackup-Dienstprogramms auf Ihrer Quellinstanz. Sie müssen eine Version von Percona XtraBackup verwenden, die der Version Ihrer Quellinstanz entspricht oder höher ist. Weitere Informationen finden Sie in der Percona XtraBackup-Dokumentation unter Vergleich der Serverversion und der Sicherungsversion.
  2. Exportieren und vorbereiten Sie die physische Sicherungsdatei Ihrer Quellinstanz mit Percona XtraBackup. Vollständige Informationen zur Verwendung von Percona XtraBackup finden Sie in der Dokumentation des Tools. Sie können den folgenden Abschnitt auch maximieren, um sich ein Beispiel für empfohlene Schritte anzusehen.

    Empfohlene Schritte zum Erstellen und Vorbereiten physischer Sicherungsdateien mit Percona XtraBackup

    Bevor Sie einen der unten aufgeführten Befehle verwenden, nehmen Sie die folgenden Ersetzungen vor:

    • TARGET_DIR durch den Pfad, unter dem Sie die Ausgabesicherungsdatei speichern möchten.
    • USERNAME mit einem Nutzer, der die Berechtigung BACKUP_ADMIN für die Quellinstanz hat.
    • PASSWORD durch das Passwort für das USERNAME-Konto.
    1. Führen Sie eine vollständige physische Sicherung Ihrer Quellinstanz durch. Führen Sie dazu diesen Befehl aus: 
        xtrabackup --backup \
    --target-dir=TARGET_DIR \
    --user=USERNAME \
    --password=PASSWORD
    2. Wenn die Sicherungsdatei fertig ist, verwenden Sie den Befehl --prepare, um die Dateikonsistenz zu prüfen. Führen Sie dazu diesen Befehl aus: 
        xtrabackup --prepare --target-dir=TARGET_DIR
  3. Erstellen Sie den Bucket zum Speichern der Sicherungsdateien. Achten Sie darauf, dieselbe Region zu verwenden, in der Sie Ihre Cloud SQL for MySQL-Zielinstanz erstellen 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, Speicher-Buckets für Sicherungsdateien) in einer einzigen Region gespeichert werden müssen.

  4. Laden Sie die Sicherungsdateien in den Cloud Storage-Bucket hoch. Achten Sie darauf, die Sicherungsdateien in einen dedizierten Cloud Storage-Ordner hochzuladen, der keine anderen Dateien enthält. Weitere Informationen finden Sie in der Cloud Storage-Dokumentation unter Objekte aus einem Dateisystem hochladen.
  5. Erstellen Sie das Quellverbindungsprofil für die Quelldatenbankinstanz.

    Console

    So erstellen Sie ein Quellverbindungsprofil:

    1. Rufen Sie in der Google Cloud Console die Seite Verbindungsprofile auf.
    2. Klicken Sie auf Profil erstellen.
    3. Wählen Sie auf der Seite Verbindungsprofil erstellen im Drop-down-Menü Datenbankmodul die Option MySQL aus.
    4. Geben Sie im Feld Name des Verbindungsprofils einen visuell lesbaren Namen für das Verbindungsprofil ein. Dieser Wert wird in der Liste der Verbindungsprofile angezeigt.
    5. Behalten Sie die automatisch generierte Verbindungsprofil-ID bei.
    6. Geben Sie einen Hostnamen oder eine IP-Adresse ein.

      • Wenn die Quelldatenbank in Google Cloudgehostet wird oder ein umgekehrter SSH-Tunnel verwendet wird, um die Zieldatenbank mit der Quelldatenbank zu verbinden, geben Sie die private (interne) IP-Adresse für die Quelldatenbank an. Auf diese Adresse kann das Cloud SQL-Ziel zugreifen. Weitere Informationen finden Sie unter Verbindung mithilfe von VPC-Peering konfigurieren.

        Geben Sie für andere Verbindungsmethoden wie die IP-Zulassungsliste die öffentliche IP-Adresse an.

    7. Geben Sie den Port ein, der für den Zugriff auf den Host verwendet wird. Der Standardport von MySQL ist 3306.
    8. Geben Sie einen Nutzernamen und ein Passwort für die Zieldatenbank ein. Das Nutzerkonto muss die erforderlichen Berechtigungen für den Zugriff auf Ihre Daten haben. Weitere Informationen finden Sie unter Quelldatenbank konfigurieren.
    9. Wählen Sie auf der Seite im Abschnitt Region des Verbindungsprofils die Region aus, in der Sie das Verbindungsprofil speichern möchten.

    10. Optional: Wenn die Verbindung über ein öffentliches Netzwerk (mithilfe von IP-Zulassungslisten) hergestellt wird, empfehlen wir die Verwendung einer SSL/TLS-Verschlüsselung für die Verbindung zwischen den Quell- und Zieldatenbanken.

      Es gibt drei Optionen für die SSL/TLS-Konfiguration, die Sie im Bereich Verbindung sichern auf der Seite auswählen können:

      1. Keine: Die Cloud SQL-Zielinstanz stellt ohne Verschlüsselung eine Verbindung zur Quelldatenbank her.

      2. Authentifizierung nur für Server: Wenn die Cloud SQL-Zielinstanz eine Verbindung zur Quelldatenbank herstellt, authentifiziert die Instanz die Quelle und stellt so sicher, dass die Instanz eine sichere Verbindung zum richtigen Host herstellt. Dadurch werden Person-in-the-Middle-Angriffe verhindert. Bei der Nur-Serverauthentifizierung wird die Instanz nicht von der Quelle authentifiziert.

        Wenn Sie nur die Serverauthentifizierung verwenden möchten, geben Sie das x509 PEM-codierte Zertifikat der Zertifizierungsstelle an, die das Zertifikat des externen Servers signiert hat.

      3. Server-Client-Authentifizierung: Wenn die Zielinstanz eine Verbindung zur Quelle herstellt, authentifiziert die Instanz die Quelle und die Quelle authentifiziert die Instanz.

        Die Server-Client-Authentifizierung bietet die höchste Sicherheit. Wenn Sie jedoch das Clientzertifikat und den privaten Schlüssel beim Erstellen der Cloud SQL-Ziellininstanz nicht angeben möchten, können Sie auch nur die Serverauthentifizierung verwenden.

        Wenn Sie die Server-Client-Authentifizierung verwenden möchten, müssen Sie beim Erstellen des Zielverbindungsprofils Folgendes angeben:

        • Das Zertifikat der CA, die das Zertifikat des Quelldatenbankservers signiert hat (das CA-Zertifikat)
        • Das Zertifikat, das von der Instanz für die Authentifizierung beim Quelldatenbankserver verwendet wird (das Clientzertifikat).
        • Der mit dem Clientzertifikat verknüpfte private Schlüssel (Clientschlüssel).
    11. Klicken Sie auf Erstellen. Ihr Verbindungsprofil wurde erstellt.

    gcloud

    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.
    • REGION durch die Kennung der Region ersetzen, in der Sie das Verbindungsprofil speichern möchten.
    • HOST_IP_ADDRESS mit der IP-Adresse, unter der der Database Migration Service Ihre Quelldatenbankinstanz erreichen kann. Dieser Wert kann je nach Verbindungsmethode variieren, die Sie für die Migration verwenden.
    • PORT_NUMBER durch die Portnummer ersetzen, unter der Ihre Quelldatenbank eingehende Verbindungen akzeptiert. Der Standard-MySQL-Port ist 3306.
    • USERNAME mit dem Namen des Datenbanknutzerkontos, mit dem der Database Migration Service eine Verbindung zu Ihrer Quelldatenbankinstanz herstellen soll.
    • PASSWORD durch das Passwort für das Datenbanknutzerkonto.
    • Optional: CONNECTION_PROFILE_NAME mit einem von Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --host=HOST_IP_ADDRESS \
  --port=PORT_NUMBER \
  --username=USERNAME \
  --password=PASSWORD \
  --display-name=CONNECTION_PROFILE_NAME

    Windows (PowerShell)

    gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --host=HOST_IP_ADDRESS `
  --port=PORT_NUMBER `
  --username=USERNAME `
  --password=PASSWORD `
  --display-name=CONNECTION_PROFILE_NAME

    Windows (cmd.exe)

    gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --host=HOST_IP_ADDRESS ^
  --port=PORT_NUMBER ^
  --username=USERNAME ^
  --password=PASSWORD ^
  --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]

Schritt 3: Migrationsjob konfigurieren und ausführen

Wenn Sie mit Percona XtraBackup migrieren, können Sie die Cloud SQL-Zielinstanz selbst erstellen oder vom Database Migration Service erstellen lassen. Weitere Informationen finden Sie unter Migrationsjobs erstellen.

Für jeden dieser Ansätze müssen Sie etwas unterschiedliche Verfahren ausführen. Wählen Sie im Drop-down-Menü die für Ihr Szenario relevanten Verfahren aus:

  • Wenn der Database Migration Service die Zieldatenbank für Sie erstellen soll, wählen Sie Zu einer neuen Zielinstanz migrieren aus.
  • Wenn Sie zu einer Zieldatenbank migrieren möchten, die außerhalb des Database Migration Service erstellt wurde, wählen Sie Zu einer vorhandenen Zielinstanz migrieren aus.

  • Bei der Migration zu einer neuen Zielinstanz erstellt der Database Migration Service die Cloud SQL for MySQL-Ziel-Instanz für Sie während des Erstellungsvorgangs des Migrationsjobs.

    Schritt 3a: Migrationsjob zu einer neuen Zielinstanz erstellen

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

    4. Klicken Sie auf Speichern und fortfahren.

    Informationen zum Quellverbindungsprofil angeben

    1. 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 Volldump bearbeiten im Drop-down-Menü Volldumpmethode die Option Physisch basiert aus.
      4. Klicken Sie unter Ordner angeben auf Durchsuchen und wählen Sie den Ordner aus, in den Sie die Full-Dump-Datei hochgeladen haben (Schritt 3 im Abschnitt Quelldaten vorbereiten).
      5. Klicken Sie auf Speichern.
    2. 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 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 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.
          • 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 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. Weitere Informationen zu MySQL-Maschinentypen
    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 einzugeben, 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.

      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.

    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 erstellen

    Prüfen Sie auf der Seite Migrationsjob testen und erstellen die Einstellungen für den Migrationsjob. In diesem Fall schlägt der Test des Migrationsjobs fehl, da das Dienstkonto, das mit der Cloud SQL-Zielinstanz verknüpft ist, nicht die erforderlichen Berechtigungen hat.

    Führen Sie vor dem Testen des Jobs einen der folgenden Schritte aus, um die Jobkonfiguration zu validieren:

    • Wenn Sie den Migrationsjob mit der Google Cloud Console testen möchten, nachdem Sie die Berechtigungen dem Dienstkonto der Zielinstanz zugewiesen haben, klicken Sie auf Speichern und schließen. Dadurch wird der Migrationsjob als Entwurf gespeichert. Sie können später zu diesem Bildschirm zurückkehren, den Migrationsjob testen und ausführen.
    • Wenn Sie den Migrationsjob mit der Google Cloud CLI testen möchten, nachdem Sie die Berechtigungen dem Dienstkonto der Zielinstanz zugewiesen haben, klicken Sie auf Erstellen. Mit der Google Cloud CLI können Sie einen Migrationsjob testen, der erstellt, aber noch nicht gestartet wurde.

    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 den Befehl aufnehmen.

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

        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

      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. Führen Sie die Netzwerkkonfiguration durch.

      Je nachdem, welche Netzwerkverbindung Sie verwenden möchten, sind möglicherweise zusätzliche Schritte erforderlich, bevor Sie den Migrationsjob erstellen können.

    3. Erstellen Sie den Migrationsjob.
      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.
      • MIGRATION_JOB_TYPE durch den Typ des Migrationsjobs. Es sind zwei Werte zulässig: ONE_TIME oder CONTINUOUS. Weitere Informationen finden Sie unter Migrationstypen.
      • PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES mit dem Pfad zu Ihren physischen Sicherungsdateien, die in einem Ordner in einem Cloud Storage-Bucket gespeichert sind. Verwenden Sie das folgende Format: gs://<bucket_name>/<path_to_backup_file_folder>.
      • Netzwerkkonfiguration

        Wenn Sie eine private IP‑Verbindung mit VPC-Netzwerk-Peering oder einem Reverse-SSH-Tunnel verwenden, fügen Sie dem Befehl die folgenden Flags hinzu:

        Private IP-Konnektivität mit VPC-Netzwerk-Peering
        Verwenden Sie das Flag --peer-vpc, um den Namen des Netzwerks anzugeben, mit dem Sie eine Peering-Verbindung herstellen möchten.
        Umgekehrter SSH-Tunnel auf einer Compute Engine-VM
        Verwenden Sie die folgenden Flags, um Netzwerkdetails für die Compute Engine anzugeben: --vm-ip, --vm-port, --vpc. Sie können auch das optionale Flag --vm verwenden, um den Namen der VM anzugeben.

        Weitere Nutzungsbeispiele finden Sie unter Beispiele für die Google Cloud CLI.

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      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]

    Schritt 3b Erforderliche Berechtigungen für das Dienstkonto der Cloud SQL-Instanz gewähren

    Wenn Sie den Migrationsjob zu einer neuen Instanz erstellen, erstellt der Database Migration Service auch die Cloud SQL-Zielinstanz für Sie. Bevor Sie die Migration ausführen können, müssen Sie dem Dienstkonto der Instanz Cloud Storage-Berechtigungen zuweisen.

    So gewähren Sie dem Dienstkonto, das mit der Zielinstanz verknüpft ist, die Cloud Storage-Berechtigungen:

    1. Suchen Sie nach der E‑Mail-Adresse des Dienstkontos für die Cloud SQL-Instanz auf der Detailseite der Cloud SQL-Instanz. Diese Adresse hat das folgende Format: <project-identifier>@gcp-sa-cloud-sql.iam.gserviceaccount.com. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Instanzinformationen aufrufen.
    2. Fügen Sie dem Dienstkonto die IAM-Rolle Storage Object Viewer (roles/storage.objectViewer) hinzu. Informationen zum Verwalten des Zugriffs mit Identity and Access Management finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten in der IAM-Dokumentation.

    Schritt 3c (Optional) Migrationsjob testen

    Bevor Sie den Migrationsjob ausführen, können Sie einen Testvorgang ausführen, um zu prüfen, ob der Database Migration Service alle erforderlichen Quell- und Zielentitäten erreichen kann. Mit der gcloud CLI können Sie Migrationsjobs testen, die erstellt, aber noch nicht gestartet wurden.

    Console

    In der Google Cloud Console können Sie nur Migrationsjobs im Entwurfsstatus testen, die Sie im Migrations-Assistenten erstellt haben. Wenn Sie den Job nicht als Entwurf gespeichert, sondern vollständig im Assistenten erstellt haben, können Sie den Test nur mit der Google Cloud CLI ausführen.

    So testen Sie einen Migrationsjob im Entwurf:

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

      Migrationsjobs aufrufen

    2. Klicken Sie auf dem Tab Entwürfe auf den Anzeigenamen des Migrationsjobs, dessen Erstellung Sie abschließen möchten.

      Der Assistent zum Erstellen von Migrationsjobs wird geöffnet.

    3. Klicken Sie auf der Seite Migrationsjob testen und erstellen auf Job testen. Der Database Migration Service prüft jetzt, ob Ihre Zielinstanz alle erforderlichen Berechtigungen hat und eine Verbindung zur Quelldatenbank herstellen kann.
    4. Klicken Sie nach Abschluss des Tests auf Erstellen.

      Der Migrationsjob ist jetzt erstellt und kann gestartet werden.

    gcloud

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch die ID Ihres Migrationsjobs.

      Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre IDs aufrufen.

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

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

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

    Ergebnis

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

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: verify
name: OPERATION_ID

    Sie können das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen, um festzustellen, ob der Vorgang erfolgreich war:

    Schritt 3d Migrationsjob starten

    Wenn der Migrationsjob vollständig erstellt wurde (d. h., er nicht im Status „Entwurf“ gespeichert ist), können Sie ihn jederzeit starten, um mit der Migration von Daten zu beginnen.

    So starten Sie einen Migrationsjob:

    Console

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

      Migrationsjobs aufrufen

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

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

    3. Klicken Sie auf Start.
    4. Klicken Sie im Dialogfeld auf Starten.

    gcloud

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • MIGRATION_JOB_ID durch die ID Ihres Migrationsjobs.

      Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre IDs aufrufen.

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

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

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

    Windows (PowerShell)

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

    Windows (cmd.exe)

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

    Ergebnis

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

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

    Sie können das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen, um festzustellen, ob der Vorgang erfolgreich war:


  • Wenn Sie zu einer vorhandenen Zielinstanz migrieren möchten, müssen Sie diese zuerst erstellen und konfigurieren.

    Schritt 3a Zielinstanz vorbereiten

    So konfigurieren Sie die Cloud SQL-Zielinstanz:

    1. Erstellen Sie die Cloud SQL for MySQL-Zielninstanz. Achten Sie darauf, dass Sie genügend Rechen- und Arbeitsspeicherressourcen für Ihre Migrationsanforderungen verwenden. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Instanz erstellen.

      Je nachdem, welche Verbindungsmethode Sie für die Migration verwenden möchten, müssen Sie Ihrer Zielinstanz möglicherweise eine öffentliche oder private IP-Adresse hinzufügen. Weitere Informationen zu Verbindungsmethoden finden Sie unter Konnektivität konfigurieren.

    2. Gewähren Sie dem Dienstkonto, das mit der Zielinstanz verknüpft ist, die Cloud Storage-Berechtigungen. Dieses Konto wird nach dem Erstellen der Zielinstanz erstellt.
      1. Suchen Sie nach der E‑Mail-Adresse des Dienstkontos für die Cloud SQL-Instanz auf der Detailseite der Cloud SQL-Instanz. Diese Adresse hat das folgende Format: <project-identifier>@gcp-sa-cloud-sql.iam.gserviceaccount.com. Weitere Informationen finden Sie in der Cloud SQL-Dokumentation unter Instanzinformationen aufrufen.
      2. Fügen Sie dem Dienstkonto die IAM-Rolle Storage Object Viewer (roles/storage.objectViewer) hinzu. Informationen zum Verwalten des Zugriffs mit Identity and Access Management finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten in der IAM-Dokumentation.
    3. Erstellen Sie ein Zielverbindungsprofil für Ihre Cloud SQL-Instanz.

      Console

      Sie müssen das Zielverbindungsprofil nicht erstellen. Wenn Sie einen Migrationsjob in der Google Cloud Console erstellen, verwenden Sie die Zielinstanz-ID. Der Database Migration Service verwaltet das Verbindungsprofil für Sie.

      Fahren Sie mit dem Abschnitt Migrationsjob erstellen und ausführen fort.

      gcloud

      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.
      • REGION durch die Kennung der Region ersetzen, in der Sie das Verbindungsprofil speichern möchten.
      • DESTINATION_INSTANCE_ID durch die Instanz-ID der Zielinstanz.
      • Optional: CONNECTION_PROFILE_NAME mit einem von Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.

      Führen Sie folgenden Befehl aus:

      Linux, macOS oder Cloud Shell

      gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

      Windows (PowerShell)

      gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

      Windows (cmd.exe)

      gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

      Sie sollten eine Antwort ähnlich der folgenden erhalten:

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

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

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

    Schritt 3b Migrationsjob erstellen und ausführen

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

    4. Klicken Sie auf Speichern und fortfahren.

    Informationen zum Quellverbindungsprofil angeben

    1. 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 Volldump bearbeiten im Drop-down-Menü Methode für Volldump die Option Physisch basiert aus.
      4. Klicken Sie unter Ordner angeben auf Durchsuchen und wählen Sie den Ordner aus, in den Sie die Full-Dump-Datei hochgeladen haben (Schritt 4 im Abschnitt Quelldaten vorbereiten).
      5. Klicken Sie auf Speichern.
    2. Klicken Sie auf Speichern und fortfahren.

    Cloud SQL-Zielinstanz auswählen

    1. Wählen Sie im Menü Typ der Zielinstanz die Option Vorhandene Instanz aus.
    2. Wählen Sie im Abschnitt Zielinstanz auswählen die Zielinstanz aus.
    3. Prüfen Sie die Informationen im Abschnitt Instanzdetails und klicken Sie auf Auswählen und fortfahren.
    4. Wenn Sie zu einer vorhandenen Zieldatenbank migrieren, stuft der Database Migration Service die Zielinstanz herab und konvertiert sie in ein Replikat. Geben Sie im Bestätigungsfenster die ID der Zielinstanz ein, um zu bestätigen, dass die Deaktivierung sicher durchgeführt werden kann.
    5. Klicken Sie auf Bestätigen und fortfahren.

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

      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.

    gcloud

    So konfigurieren und führen Sie die Migration aus:

    1. Erstellen Sie den Migrationsjob.
      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.
      • MIGRATION_JOB_TYPE durch den Typ des Migrationsjobs. Es sind zwei Werte zulässig: ONE_TIME oder CONTINUOUS. Weitere Informationen finden Sie unter Migrationstypen.
      • PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES mit dem Pfad zu Ihren physischen Sicherungsdateien, die in einem Ordner in einem Cloud Storage-Bucket gespeichert sind. Verwenden Sie das folgende Format: gs://<bucket_name>/<path_to_backup_file_folder>.
      • Netzwerkkonfiguration

        Wenn Sie eine private IP‑Verbindung mit VPC-Netzwerk-Peering oder einem Reverse-SSH-Tunnel verwenden, fügen Sie dem Befehl die folgenden Flags hinzu:

        Private IP-Konnektivität mit VPC-Netzwerk-Peering
        Verwenden Sie das Flag --peer-vpc, um den Namen des Netzwerks anzugeben, mit dem Sie eine Peering-Verbindung herstellen möchten.
        Umgekehrter SSH-Tunnel auf einer Compute Engine-VM
        Verwenden Sie die folgenden Flags, um Netzwerkdetails für die Compute Engine anzugeben: --vm-ip, --vm-port, --vpc. Sie können auch das optionale Flag --vm verwenden, um den Namen der VM anzugeben.

        Weitere Nutzungsbeispiele finden Sie unter Beispiele für die Google Cloud CLI.

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      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]

    2. Stellen Sie die Cloud SQL-Zielninstanz zurück.
      Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

      gcloud database-migration migration-jobs demote-destination

      Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

      • MIGRATION_JOB_ID durch die ID Ihres Migrationsjobs.

        Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre IDs aufrufen.

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

      Führen Sie folgenden Befehl aus:

      Linux, macOS oder Cloud Shell

      gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

      Windows (PowerShell)

      gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

      Windows (cmd.exe)

      gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

      Ergebnis

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

      done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

      Sie können das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen, um festzustellen, ob der Vorgang erfolgreich war:

    3. Optional: Migrationsjob testen
      Sie können prüfen, ob der Database Migration Service alle erforderlichen Quell- und Zielentitäten erreichen kann. Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

      gcloud database-migration migration-jobs verify

      Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

      • MIGRATION_JOB_ID durch die ID Ihres Migrationsjobs.

        Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre IDs aufrufen.

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

      Führen Sie folgenden Befehl aus:

      Linux, macOS oder Cloud Shell

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

      Windows (PowerShell)

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

      Windows (cmd.exe)

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

      Ergebnis

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

      done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: verify
name: OPERATION_ID

      Sie können das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen, um festzustellen, ob der Vorgang erfolgreich war:

    4. Starten Sie den Migrationsjob.
      Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

      gcloud database-migration migration-jobs start

      Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

      • MIGRATION_JOB_ID durch die ID Ihres Migrationsjobs.

        Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration migration-jobs list alle Migrationsjobs in einer bestimmten Region auflisten und ihre IDs aufrufen.

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

      Führen Sie folgenden Befehl aus:

      Linux, macOS oder Cloud Shell

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

      Windows (PowerShell)

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

      Windows (cmd.exe)

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

      Ergebnis

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

      done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

      Sie können das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen, um festzustellen, ob der Vorgang erfolgreich war:

      Wenn Sie den Migrationsjob starten, wird die Ziel-Cloud SQL-Instanz in den Lesemodus versetzt und vollständig vom Database Migration Service verwaltet. Sie können sie zu einer eigenständigen Instanz hochstufen, wenn Ihre Daten vollständig migriert wurden.

      Hinweis: Mit den Observability-Funktionen des Database Migration Service können Sie den Migrationsfortschritt und den Zustand der Zielinstanz im Blick behalten. Weitere Informationen finden Sie unter [Messwerte für Migrationsjobs](/database-migration/docs/mysql/migration-job-metrics).

Schritt 4: (Optional) Migration beenden

Sie können den Migrationsjob jederzeit anhalten und löschen, wenn Sie die Datenmigration abbrechen möchten. Sie können den Migrationsjob in der Google Cloud Console oder mit der Google Cloud CLI verwalten.

Schritt 5: Migration abschließen

Wenn der Migrationsjob erfolgreich abgeschlossen wurde, können Sie ihn mit einem der folgenden Schritte finalisieren:

  • Einmalige Migrationen: Der Status des Migrationsjobs ändert sich zu Abgeschlossen. Es sind keine weiteren Maßnahmen erforderlich. Sie können die Ressourcen für den Migrationsjob und das Verbindungsprofil bereinigen.

  • Bei kontinuierlichen Migrationen: Stellen Sie den Migrationsjob in den aktiven Status. Die Anwendung wird dann auf die neue Datenbankinstanz umgestellt.