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 sie im Rahmen der Erstellung des Migrationsjobs von Database Migration Service erstellen lassen. 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 die Netzwerkverbindung zwischen Ihren Quell- und Zieldatenbankinstanzen sicherstellen können.

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

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

  • Wenn Sie das Quellverbindungsprofil erstellen, verwenden Sie eine Beispiel-IP-Adresse, einen Beispielport, einen Beispielnutzernamen und ein Beispielpasswort. Beispiel:

    • IP-Adresse: 0.0.0.0
    • Port: 1234
    • Nutzername für die Migration: test-user

  • Wenn Sie den Migrationsjob erstellen:

    • Öffentliche IP-Verbindungen verwenden. Konfigurieren Sie keine zusätzlichen Netzwerkoptionen.
    • Verwenden Sie den einmaligen Migrationsjobtyp.

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. Bekannte Einschränkungen

  • Versionsübergreifende Überlegungen:

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

    • Eine Migration von MySQL 5.7 zu MySQL 8.0 ist nicht möglich.

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

  • Architekturübergreifende Überlegungen: Cloud SQL unterstützt die ARM-Architektur. Sie können Datenbanken nur zwischen Maschinen desselben Architekturtyps migrieren. Wenn Ihre Datenbank beispielsweise auf einer ARM64-Maschine gehostet wird, müssen Sie zu einer ARM64-Maschine migrieren.

  • Die Laufwerkgröße der Zieldatenbank muss größer oder gleich der Quelldatenbankgröße sein. Weitere Informationen finden Sie unter MySQL-Maschinentypen für Ihre Cloud SQL-Version.

  • 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 Ihre physische Percona XtraBackup-Datei größer als 5 TB ist, 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 Database Migration Service ohne Aufpreis 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 für Migrationszwecke 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.

Hinweise

  1. Überlegen Sie, in welcher Region Sie die Zieldatenbank erstellen 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, 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 Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie für homogene MySQL-Migrationen mit physischen 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 mit physischen 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 den Quell- und Cloud SQL-Zielinstanzen konfigurieren können. Je nachdem, welche Methode Sie verwenden, sind möglicherweise zusätzliche Schritte während der Migration erforderlich.

Überlegen Sie, welche Verbindungsmethode für Ihr Szenario am besten geeignet ist, bevor Sie mit den nächsten Schritten fortfahren. Ihre Auswahl kann sich auf die Einstellungen auswirken, die Sie verwenden müssen. 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 bereiten Sie die physische Sicherungsdatei Ihrer Quellinstanz mit Percona XtraBackup vor. Vollständige Informationen zur Verwendung von Percona XtraBackup finden Sie in der Dokumentation des Tools. Sie können auch den folgenden Abschnitt maximieren, um ein Beispiel für empfohlene Schritte zu sehen.

    Beispiel für 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 gewährleisten. 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.

    Database Migration Service ist ein vollständig regionales Produkt. Das bedeutet, dass alle Entitäten, die mit Ihrer Migration zusammenhängen (Verbindungsprofile für Quelle und Ziel, 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 Ihre 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 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 Hostname 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 über das Cloud SQL-Ziel zugegriffen werden. Weitere Informationen finden Sie unter Verbindung über 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 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.

      Im Abschnitt Verbindung sichern auf der Seite stehen drei Optionen für die SSL/TLS-Konfiguration zur Auswahl:

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

      2. Nur Serverauthentifizierung: 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 Sicherheitsstufe. Wenn Sie jedoch das Clientzertifikat und den privaten Schlüssel beim Erstellen der Cloud SQL-Zielinstanz nicht angeben möchten, können Sie auch nur die Serverauthentifizierung verwenden.

        Wenn Sie die Server-Client-Authentifizierung verwenden möchten, geben Sie beim Erstellen des Zielverbindungsprofils Folgendes an:

        • 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 private Schlüssel, der mit dem Clientzertifikat verknüpft ist (der 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 die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe prüfen, ob der Vorgang erfolgreich war.

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

    • CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennung für Ihr Verbindungsprofil.
    • Ersetzen Sie REGION durch die Kennung der Region, in der Sie das Verbindungsprofil speichern möchten.
    • HOST_IP_ADDRESS mit der IP-Adresse, über die Database Migration Service Ihre Quelldatenbankinstanz erreichen kann. Dieser Wert kann je nach Verbindungsmethode, die Sie für die Migration verwenden, variieren.
    • PORT_NUMBER mit der Portnummer, über die Ihre Quelldatenbank eingehende Verbindungen akzeptiert. Der Standard-MySQL-Port ist 3306.
    • USERNAME mit dem Namen des Datenbanknutzerkontos, mit dem Database Migration Service eine Verbindung zur Quelldatenbankinstanz herstellen soll.
    • PASSWORD durch das Passwort für das Datenbank-Nutzerkonto.
    • (Optional) Ersetzen Sie CONNECTION_PROFILE_NAME durch einen für Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.

    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 von Database Migration Service erstellen lassen. Weitere Informationen finden Sie unter Übersicht über die Erstellung von Migrationsjobs.

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

  • Wenn 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 von Database Migration Service erstellt wurde, wählen Sie Zu einer vorhandenen Zielinstanz migrieren aus.

  • Wenn Sie zu einer neuen Zielinstanz migrieren, erstellt Database Migration Service die Cloud SQL for MySQL-Zielinstanz für Sie während der Erstellung 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.

      Zu Migrationsjobs

    2. Klicken Sie auf Migrationsjob erstellen.

      Die Seite des Assistenten für die Konfiguration von Migrationsjobs wird geöffnet. Dieser Assistent enthält mehrere Bereiche, in denen Sie durch die einzelnen Konfigurationsschritte geführt werden.

      Sie können die Erstellung eines Migrationsjobs jederzeit pausieren, indem Sie auf SPEICHERN & SCHLIESSEN klicken. Alle Daten, die Sie bis dahin eingeben, werden in einem Migrationsjobentwurf gespeichert. Sie können den Migrationsjobentwurf später fertigstellen.

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

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

      2. Migrationsjob-ID

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

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

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

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

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

    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 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 die Option Physisch basiert aus.
      4. Klicken Sie unter Ordner angeben auf Durchsuchen und wählen Sie dann den Ordner aus, in den Sie die vollständige Dump-Datei hochgeladen haben (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 ID für die Cloud SQL-Instanz an oder verwenden Sie die automatisch generierte ID.

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

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

        Sie können das Passwort entweder manuell eingeben oder auf Generieren klicken, damit der Database Migration Service automatisch ein Passwort für Sie erstellt.

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

        Klicken Sie auf Nebenversionen anzeigen, um alle Nebenversionen aufzurufen. Weitere Informationen zur Unterstützung der versionsübergreifenden Migration

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

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

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

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

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

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

            Maximieren Sie diesen Abschnitt, um die vollständigen Anforderungen an private IP-Adressen zu sehen.
          • Wählen Sie das zugehörige VPC-Netzwerk für das Peering aus. Wenn Sie eine Verbindung zur Migrationsquelle über VPC-Peering herstellen möchten, wählen Sie die VPC aus, in der sich die Instanz befindet.
          • Wenn für die ausgewählte VPC noch kein Netzwerk für verwaltete Dienste konfiguriert wurde, können Sie entweder einen IP-Bereich auswählen und auf Verbinden klicken oder einen automatisch ausgewählten IP-Bereich verwenden und auf Zuweisen und verbinden klicken.
        • Wenn Sie über das Internet mithilfe einer IP-Zulassungsliste migrieren möchten, wählen Sie Öffentliche IP-Adresse aus.

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

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

    2. Wählen Sie den Maschinentyp für die Cloud SQL-Instanz aus.

      Weitere Informationen finden Sie unter Einschränkungen.

    3. Für Cloud SQL for MySQL Enterprise Plus: Wählen Sie das Kästchen Datencache aktivieren aus, wenn Sie die Datencachefunktion in Ihrer Zieldatenbank verwenden möchten.

      Der Datencache ist eine optionale Funktion, die für Cloud SQL for MySQL Enterprise Plus-Instanzen verfügbar ist und Ihrer Zieldatenbank eine lokale Hochgeschwindigkeits-SSD hinzufügt. Diese Funktion kann zusätzliche Kosten für Cloud SQL verursachen. Weitere Informationen zum Datencache finden Sie in der Cloud SQL-Dokumentation unter Datencache – Übersicht.

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

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

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

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

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

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

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

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

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

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

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

    Verbindung zwischen den Quell- und Zieldatenbankinstanzen einrichten

    Wählen Sie im Drop-down-Menü Verbindungsmethode eine Netzwerkverbindungsmethode aus. Diese Methode definiert, wie die neu erstellte Cloud SQL-Instanz eine Verbindung zur Quelldatenbank herstellt. Derzeit sind folgende Netzwerkverbindungsmethoden verfügbar: IP-Zulassungsliste, umgekehrter SSH-Tunnel und VPC-Peering.

    Wenn Sie… verwenden möchtenVorgehensweise
    Die Netzwerkverbindungsmethode „IP-Zulassungsliste“ Sie müssen die ausgehende IP-Adresse Ihrer Zielinstanz angeben. Wenn die von Ihnen erstellte Cloud SQL-Instanz eine Instanz mit Hochverfügbarkeit ist, geben Sie die ausgehenden IP-Adressen für die primäre und die sekundäre Instanz an.
    Die Methode für die Netzwerkverbindung über umgekehrte SSH-Tunnel Sie müssen die Compute Engine-VM-Instanz auswählen, auf der der Tunnel gehostet wird.

    Nachdem Sie die Instanz angegeben haben, stellt Google ein Skript zur Verfügung, das die Schritte zum Einrichten des Tunnels zwischen den Quell- und Zieldatenbanken ausführt. Sie müssen das Skript in der Google Cloud CLI ausführen.

    Führen Sie die Befehle auf einem Computer aus, der sowohl mit der Quelldatenbank als auch mit Google Cloudverbunden ist.
    Die Netzwerkverbindungsmethode „VPC-Peering“ Sie müssen das VPC-Netzwerk auswählen, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, damit eine Verbindung mit diesem Netzwerk hergestellt wird.

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

    Migrationsjob erstellen

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

    Führen Sie einen der folgenden Schritte aus, bevor Sie den Job testen, um die Jobkonfiguration zu validieren:

    • Wenn Sie Ihren Migrationsjob über die Google Cloud -Konsole testen möchten, nachdem Sie dem Dienstkonto der Zielinstanz die Berechtigungen zugewiesen haben, klicken Sie auf Speichern und beenden. Dadurch wird Ihr Migrationsjob als Entwurf gespeichert. Sie können später zu diesem Bildschirm zurückkehren, Ihren Migrationsjob testen und ausführen.
    • Wenn Sie Ihren Migrationsjob mit der Google Cloud CLI testen möchten, nachdem Sie dem Dienstkonto der Zielinstanz die Berechtigungen 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 einem einzigen Vorgang.
      Führen Sie den folgenden Befehl aus (klicken Sie auf den Link, um ihn zu maximieren):

      gcloud database-migration connection-profiles create cloudsql

      In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe prüfen, ob der Vorgang erfolgreich war.

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

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

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

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

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

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

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

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

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

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

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

        Wenn Sie öffentliche IP-Verbindungen verwenden möchten, sind keine zusätzlichen Flags erforderlich. Wenn Sie die Verbindung über private IP-Adressen mit VPC-Netzwerk-Peering oder einem Reverse-SSH-Tunnel verwenden möchten, müssen Sie die folgenden zusätzlichen Netzwerkanforderungen für die Aktivierung der Verbindung über private IP-Adressen erfüllen und zusätzliche Flags in Ihren Befehl aufnehmen.

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

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

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

      Führen Sie folgenden Befehl aus:

      Linux, macOS oder Cloud Shell

      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. Schließen Sie die Einrichtung der Netzwerkkonfiguration ab.

      Abhängig von der gewünschten Netzwerkverbindung sind möglicherweise zusätzliche Schritte erforderlich, bevor Sie den Migrationsjob erstellen.

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

      gcloud database-migration migration-jobs create

      In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe prüfen, ob der Vorgang erfolgreich war.

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

      • MIGRATION_JOB_ID durch eine maschinenlesbare ID für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs mithilfe von Google Cloud CLI-Befehlen oder der API des Database Migration Service zu arbeiten.
      • REGION durch die Regions-ID, in der Sie den Migrationsjob speichern möchten.
      • MIGRATION_JOB_NAME durch einen für Menschen lesbaren Namen für Ihren Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
      • SOURCE_CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennzeichnung des Quellverbindungsprofils.
      • DESTINATION_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Zielverbindungsprofils.
      • MIGRATION_JOB_TYPE durch den Typ Ihres Migrationsjobs. Zwei Werte sind zulässig: ONE_TIME oder CONTINUOUS. Weitere Informationen finden Sie unter Migrationsarten.
      • 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 Ihrem Befehl die folgenden Flags hinzu:

        Private IP-Verbindung 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 Compute Engine anzugeben: --vm-ip, --vm-port, --vpc. Sie können auch das optionale Flag --vm verwenden, um den Namen der VM anzugeben.

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

      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 für eine neue Instanz erstellen, erstellt 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 auf der Detailseite der Cloud SQL-Instanz nach der E‑Mail-Adresse des Dienstkontos für Ihre 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 in der IAM-Dokumentation unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Schritt 3c: (Optional) Migrationsjob testen

    Bevor Sie den Migrationsjob ausführen, können Sie einen Testvorgang durchführen, um zu prüfen, ob 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 Migrationsjobentwürfe testen, die Sie im Assistenten zum Erstellen von Migrationsjobs erstellen. 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 durchführen.

    So testen Sie einen Migrationsjobentwurf:

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

      Zu Migrationsjobs

    2. Klicken Sie auf dem Tab Entwürfe auf den Anzeigenamen des Migrationsjobs, den Sie fertig erstellen möchten.

      Der Assistent zum Erstellen von Migrationsjobs wird geöffnet.

    3. Klicken Sie auf der Seite Migrationsjob testen und erstellen auf Job testen. Database Migration Service prüft jetzt, ob Ihre Zielinstanz alle erforderlichen Berechtigungen hat und eine Verbindung zur Quelldatenbank herstellen kann.
    4. Wenn der Test abgeschlossen ist, klicken Sie auf Erstellen.

      Der Migrationsjob wurde 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 ID 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 ist die 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 Vorgang mit langer Ausführungszeit darstellt: 

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

    Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

    Schritt 3d: Migrationsjob starten

    Wenn Ihr Migrationsjob vollständig erstellt wurde (d. h. nicht im Entwurfsstatus gespeichert ist), können Sie ihn jederzeit starten, um mit der Migration der Daten zu beginnen.

    So starten Sie einen Migrationsjob:

    Console

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

      Zu Migrationsjobs

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

      Die Seite mit den Details zum Migrationsjob 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 ID 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 ist die 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 Vorgang mit langer Ausführungszeit darstellt: 

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

    Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:


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

    Schritt 3a: Zielinstanz vorbereiten

    So konfigurieren Sie Ihre Cloud SQL-Zielinstanz:

    1. Erstellen Sie die Cloud SQL for MySQL-Zielinstanz. Achten Sie darauf, dass Sie genügend Rechen- und Arbeitsspeicherressourcen für die Migration 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 Verbindung 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 in der IAM-Dokumentation unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
    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 Konsole erstellen, verwenden Sie die Kennung der Zielinstanz. Das Verbindungsprofil wird dann vom Database Migration Service verwaltet.

      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 die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe prüfen, ob der Vorgang erfolgreich war.

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

      • CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennung für Ihr Verbindungsprofil.
      • Ersetzen Sie REGION durch die Kennung der Region, in der Sie das Verbindungsprofil speichern möchten.
      • DESTINATION_INSTANCE_ID durch die Instanz-ID Ihrer Zielinstanz.
      • (Optional) Ersetzen Sie CONNECTION_PROFILE_NAME durch einen für Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.

      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.

      Zu Migrationsjobs

    2. Klicken Sie auf Migrationsjob erstellen.

      Die Seite des Assistenten für die Konfiguration von Migrationsjobs wird geöffnet. Dieser Assistent enthält mehrere Bereiche, in denen Sie durch die einzelnen Konfigurationsschritte geführt werden.

      Sie können die Erstellung eines Migrationsjobs jederzeit pausieren, indem Sie auf SPEICHERN & SCHLIESSEN klicken. Alle Daten, die Sie bis dahin eingeben, werden in einem Migrationsjobentwurf gespeichert. Sie können den Migrationsjobentwurf später fertigstellen.

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

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

      2. Migrationsjob-ID

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

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

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

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

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

    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 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 die Option Physisch basiert aus.
      4. Klicken Sie unter Ordner angeben auf Durchsuchen und wählen Sie dann den Ordner aus, in den Sie die vollständige Dump-Datei hochgeladen haben (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 möchten, stuft Database Migration Service die Zielinstanz herab und konvertiert sie in ein Replikat. Geben Sie im Bestätigungsfenster die Kennung der Zielinstanz ein, um anzugeben, dass die Herabstufung 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 eine Verbindung zur Quelldatenbank herstellt. Derzeit sind folgende Netzwerkverbindungsmethoden verfügbar: IP-Zulassungsliste, umgekehrter SSH-Tunnel und VPC-Peering.

    Wenn Sie… verwenden möchtenVorgehensweise
    Die Netzwerkverbindungsmethode „IP-Zulassungsliste“ Sie müssen die ausgehende IP-Adresse Ihrer Zielinstanz angeben. Wenn die von Ihnen erstellte Cloud SQL-Instanz eine Instanz mit Hochverfügbarkeit ist, geben Sie die ausgehenden IP-Adressen für die primäre und die sekundäre Instanz an.
    Die Methode für die Netzwerkverbindung über umgekehrte SSH-Tunnel Sie müssen die Compute Engine-VM-Instanz auswählen, auf der der Tunnel gehostet wird.

    Nachdem Sie die Instanz angegeben haben, stellt Google ein Skript zur Verfügung, das die Schritte zum Einrichten des Tunnels zwischen den Quell- und Zieldatenbanken ausführt. Sie müssen das Skript in der Google Cloud CLI ausführen.

    Führen Sie die Befehle auf einem Computer aus, der sowohl mit der Quelldatenbank als auch mit Google Cloudverbunden ist.
    Die Netzwerkverbindungsmethode „VPC-Peering“ Sie müssen das VPC-Netzwerk auswählen, in dem sich die Quelldatenbank befindet. Die Cloud SQL-Instanz wird aktualisiert, damit eine Verbindung mit diesem Netzwerk hergestellt wird.

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

    Migrationsjob testen, erstellen und ausführen

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

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

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

    2. Wenn der Test des Migrationsjobs abgeschlossen ist, klicken Sie auf Job erstellen und starten.

      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.

    gcloud

    So konfigurieren und führen Sie die Migration aus:

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

      gcloud database-migration migration-jobs create

      In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe prüfen, ob der Vorgang erfolgreich war.

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

      • MIGRATION_JOB_ID durch eine maschinenlesbare ID für Ihren Migrationsjob. Sie verwenden diesen Wert, um mit Migrationsjobs mithilfe von Google Cloud CLI-Befehlen oder der API des Database Migration Service zu arbeiten.
      • REGION durch die Regions-ID, in der Sie den Migrationsjob speichern möchten.
      • MIGRATION_JOB_NAME durch einen für Menschen lesbaren Namen für Ihren Migrationsjob. Dieser Wert wird in Database Migration Service in der Google Cloud Console angezeigt.
      • SOURCE_CONNECTION_PROFILE_ID durch eine maschinenlesbare Kennzeichnung des Quellverbindungsprofils.
      • DESTINATION_CONNECTION_PROFILE_ID mit einer maschinenlesbaren Kennung des Zielverbindungsprofils.
      • MIGRATION_JOB_TYPE durch den Typ Ihres Migrationsjobs. Zwei Werte sind zulässig: ONE_TIME oder CONTINUOUS. Weitere Informationen finden Sie unter Migrationsarten.
      • 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 Ihrem Befehl die folgenden Flags hinzu:

        Private IP-Verbindung 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 Compute Engine anzugeben: --vm-ip, --vm-port, --vpc. Sie können auch das optionale Flag --vm verwenden, um den Namen der VM anzugeben.

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

      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. Cloud SQL-Zielinstanz zurückstufen
       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 ID 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 ist die 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 Vorgang mit langer Ausführungszeit darstellt: 

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

      Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

    3. (Optional) Migrationsjob testen
      Sie können eine Prüfung durchführen, um zu sehen, ob 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 ID 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 ist die 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 Vorgang mit langer Ausführungszeit darstellt: 

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

      Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

    4. Migrationsjob starten
      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 ID 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 ist die 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 Vorgang mit langer Ausführungszeit darstellt: 

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

      Um zu prüfen, ob Ihr Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder den Status des Migrationsjobs prüfen:

      Wenn Sie den Migrationsjob starten, wird Ihre Cloud SQL-Zielinstanz in den schreibgeschützten Modus versetzt und vollständig von Database Migration Service verwaltet. Sie können sie in eine eigenständige Instanz hochstufen, wenn Ihre Daten vollständig migriert wurden.

      Hinweis: Mit den Observability-Funktionen von Database Migration Service können Sie den Migrationsfortschritt und den Zustand Ihrer Zielinstanz überwachen. 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 beenden und löschen, wenn Sie die Datenmigration abbrechen möchten. Sie können den Migrationsjob in der Google Cloud -Konsole oder mit der Google Cloud CLI verwalten.

Schritt 5: Migration abschließen

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

  • 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: Stufen Sie den Migrationsjob hoch, um Ihre Anwendung auf die neue Datenbankinstanz umzustellen.