Von einer physischen XtraBackup-Datei zu Cloud SQL migrieren

Auf dieser Seite wird beschrieben, wie Sie eine MySQL-Datenbank mithilfe einer physischen Percona XtraBackup for MySQL-Datei von einem externen Server zu Cloud SQL migrieren.

Cloud SQL unterstützt die Migration von MySQL-Datenbanken auf externen Servern zu Cloud SQL for MySQL-Instanzen mit Percona XtraBackup. Sie generieren physische Dateien mit dem XtraBackup-Dienstprogramm und laden sie dann in Cloud Storage hoch. Mit physischen Dateien können Sie die Gesamtgeschwindigkeit der Migration im Vergleich zu einer regulären Migration über eine logische Dumpdatei um das Zehnfache steigern.

Cloud SQL unterstützt die physische dateibasierte Migration für MySQL 5.7 und 8.0. MySQL 5.6 und 8.4 werden nicht unterstützt. Die Migration von Amazon Aurora- oder MySQL-Datenbanken auf Amazon RDS wird nicht unterstützt. Außerdem muss die Zielreplikatinstanz in Cloud SQL for MySQL mit derselben MySQL-Hauptversion wie Ihr externer Server installiert sein. Das Zielreplikat kann jedoch eine neuere Nebenversion verwenden. Wenn Ihre externe Datenbank beispielsweise MySQL 8.0.31 verwendet, muss das Zielreplikat Cloud SQL für MySQL 8.0.31 oder höher sein.

Hinweise

In diesem Abschnitt werden die Schritte beschrieben, die Sie ausführen müssen, bevor Sie Ihre MySQL-Datenbank zu Google Cloud migrieren.

Google Cloud-Projekt einrichten

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud SQL Admin API.

    Enable the API

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Cloud SQL Admin API.

    Enable the API

  8. Sie benötigen für Ihr Nutzerkonto die Rollen „Cloud SQL-Administrator“, „Storage-Administrator“ und „Compute-Betrachter“.

    Zur IAM-Seite

Cloud Storage-Bucket einrichten

Erstellen Sie einen Cloud Storage-Bucket, falls noch nicht geschehen.

Google Cloud SDK installieren

Wenn Sie gcloud CLI-Befehle auf Ihrem externen Server verwenden möchten, installieren Sie das Google Cloud SDK.

Externen Server für die Migration vorbereiten

  1. Installieren Sie eine der folgenden Versionen des XtraBackup-Dienstprogramms auf Ihrem externen Server.

    Für MySQL 8.0 müssen Sie eine Version von XtraBackup installieren, die der Version Ihres Quellservers entspricht oder höher ist. Weitere Informationen finden Sie in der Percona XtraBackup-Dokumentation unter Vergleich der Serverversion und der Sicherungsversion.

  2. Prüfen Sie, ob Ihr externer Server alle erforderlichen Anforderungen für die Replikation erfüllt. Weitere Informationen finden Sie unter Externen Server für die Replikation einrichten.

    Zusätzlich zu den Anforderungen an den externen Server für die Replikation gelten für die Migration von einer physischen XtraBackup-Datei die folgenden Anforderungen:

    • Ihre MySQL-Datenbank muss eine lokale Datenbank oder eine selbstverwaltete MySQL-Datenbank auf einer Compute Engine-VM sein. Die Migration von Amazon Aurora- oder MySQL-Datenbanken auf Amazon RDS wird nicht unterstützt.
    • 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 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 externen Quelldatenbank muss mit dem Standardwert 16384 konfiguriert sein.
  3. Wenn Sie noch keins eingerichtet haben, erstellen Sie ein Nutzerkonto für die Replikation. Sie benötigen den Nutzernamen und das Passwort für dieses Nutzerkonto.

Migration ausführen

Führen Sie alle Schritte in den folgenden Abschnitten aus, um Ihre externe MySQL-Datenbank zu Cloud SQL zu migrieren.

Physische XtraBackup-Datei erstellen und vorbereiten

  1. Führen Sie auf dem externen Server mit XtraBackup eine Vollsicherung der Quelldatenbank durch. Weitere Informationen zum Erstellen einer vollständigen Sicherung finden Sie in der Percona XtraBackup-Dokumentation unter Vollsicherung erstellen.

    Andere Arten von Sicherungen, z. B. inkrementelle und teilweise Sicherungen, werden nicht unterstützt.

    So verbessern Sie die Leistung des Sicherungsvorgangs:

    • Mit --parallel=threads können Sie beim Sicherungsschritt mehrere Dateien parallel kopieren.
    • Erhöhen Sie die Arbeitsspeicherzuweisung während des Vorbereitungsschritts mit --use-memory=size.

    Beispiele:

    sudo xtrabackup --backup \
    --target-dir=XTRABACKUP_PATH \
    --user=USERNAME \
    --password=PASSWORD \
    --parallel=THREADS

    Ersetzen Sie die folgenden Variablen:

    • XTRABACKUP_PATH: Speicherort der Ausgabesicherungsdatei
    • USERNAME: ein Nutzer mit BACKUP_ADMIN-Berechtigungen für die Quelldatenbank
    • PASSWORD: das Passwort für den Nutzer
    • THREADS: Die Anzahl der Threads, die beim gleichzeitigen Kopieren mehrerer Datendateien beim Erstellen einer Sicherung verwendet werden sollen
  2. Verwenden Sie das XtraBackup-Dienstprogramm, um die Sicherungsdatei vorzubereiten. Die Datei muss sich in einem konsistenten Zustand befinden. Weitere Informationen zum Erstellen einer vollständigen Sicherung finden Sie unter Vollsicherung vorbereiten. Beispiele:

    sudo xtrabackup --prepare --target-dir=XTRABACKUP_PATH \
        --use-memory=MEMORY

    Ersetzen Sie die folgenden Variablen:

    • XTRABACKUP_PATH: Speicherort der Ausgabesicherungsdatei
    • MEMORY: der für die Vorbereitung zugewiesene Arbeitsspeicher. Geben Sie einen Wert zwischen 1 GB und 2 GB an. Weitere Informationen zur Option -use-memory finden Sie in der Percona XtraBackup-Dokumentation.

    Die Zeit, die für die Vorbereitung der Sicherungsdatei benötigt wird, kann je nach Größe der Datenbank variieren.

Physische XtraBackup-Datei in Cloud Storage hochladen

Verwenden Sie die gcloud CLI, um die Sicherungsdatei in Cloud Storage hochzuladen.

  gcloud storage rsync XTRABACKUP_PATH CLOUD_STORAGE_BUCKET --recursive
  

Ersetzen Sie XTRABACKUP_PATH durch den Speicherort der Ausgabesicherungsdatei und CLOUD_STORAGE_BUCKET durch den Pfad des Cloud Storage-Buckets.

Die Größe Ihrer XtraBackup-Dateien ist nicht begrenzt. Die Größe einer einzelnen Datei, die Sie in einen Cloud Storage-Bucket hochladen können, ist jedoch auf 5 TB begrenzt.

Quelldarstellungsinstanz definieren

  1. Erstellen Sie eine source.json-Datei, in der die Instanz der Quelldarstellung für Ihren externen Server definiert ist. Eine Quelldarstellungsinstanz stellt Metadaten für den externen Server in Cloud SQL bereit.

    Geben Sie in der Datei source.json die folgenden grundlegenden Informationen zu Ihrem externen Server an.

    {
    "name": "SOURCE_NAME",
     "region": "REGION",
     "databaseVersion": "DATABASE_VERSION",
     "onPremisesConfiguration": {
        "hostPort": "SOURCE_HOST:3306",
        "username": "REPLICATION_USER_NAME",
        "password": "REPLICATION_USER_PASSWORD",
        "dumpFilePath": "CLOUD_STORAGE_BUCKET"
        "caCertificate": "SOURCE_CERT",
        "clientCertificate": "CLIENT_CERT",
        "clientKey": "CLIENT_KEY"
      }
    }
    Attribut Beschreibung
    SOURCE_NAME Der Name der zu erstellenden Quelldarstellungsinstanz.
    REGION Die Region, in der sich die Quelldarstellungsinstanz befinden soll. Geben Sie dieselbe Region an, in der Sie die Zielinstanz des Cloud SQL-Replikats erstellen.
    DATABASE_VERSION Die auf dem externen Server ausgeführte Datenbankversion. Die einzigen unterstützten Optionen sind MYSQL_5_7 oder MYSQL_8_0.
    SOURCE_HOST Die IPv4-Adresse und der Port für den externen Server oder die DNS-Adresse für den externen Server. Eine DNS-Adresse kann bis zu 60 Zeichen enthalten.
    USERNAME Das Nutzerkonto für die Replikation auf dem externen Server.
    PASSWORD Das Passwort des Nutzerkontos für die Replikation.
    CLOUD_STORAGE_BUCKET Der Name des Cloud Storage-Buckets, der die physische XtraBackup-Datei enthält.
    CLIENT_CA_CERT Das CA-Zertifikat auf dem externen Server. Nur einschließen, wenn auf dem externen Server SSL/TLS verwendet wird.
    CLIENT_CERT Das Clientzertifikat auf dem externen Server. Nur für die Server-Client-Authentifizierung erforderlich. Nur einschließen, wenn auf dem externen Server SSL/TLS verwendet wird.
    CLIENT_KEY Die private Schlüsseldatei für das Clientzertifikat auf dem externen Server. Nur für die Server-Client-Authentifizierung erforderlich. Nur einschließen, wenn auf dem externen Server SSL/TLS verwendet wird.
  2. Erstellen Sie die Quelldarstellungsinstanz, indem Sie mit dem folgenden curl-Befehl eine Anfrage an die Cloud SQL Admin API senden. Geben Sie in den Daten für die Anfrage die von Ihnen erstellte source.json-Datei an.

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data @./source.json \
        -X POST \
    https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances
    Attribut Beschreibung
    PROJECT_ID Die ID Ihres Projekts in Google Cloud.

Zielreplikatinstanz angeben

Erstellen Sie eine Datei, in der das Zielreplikat in Cloud SQL für die Migration angegeben ist. Sie können Daten entweder zu einer neuen Instanz migrieren, indem Sie ein Replikat erstellen, oder eine vorhandene Cloud SQL-Instanz verwenden, indem Sie ein Replikat herabstufen.

Option 1: Replikatinstanz erstellen

  1. Verwenden Sie zum Erstellen einer Replikinstanz die folgende Beispiel-replica.json-Datei:

    {
    "name": "REPLICA_NAME",
    "region": "REGION",
    "databaseVersion": "DB_VERSION",
    "settings": {
       "tier": "INSTANCE_TIER",
       "dataDiskSizeGb": "DISK_SIZE_GB",
       "edition": "EDITION_NAME"
    },
    "masterInstanceName": "SOURCE_NAME"
    }
    Attribut Beschreibung
    REPLICA_NAME Der Name des zu erstellenden Cloud SQL-Replikats.
    REGION Geben Sie dieselbe Region an, die Sie der Quelldarstellungsinstanz zugewiesen haben.
    DATABASE_VERSION Die Datenbankversion, die mit dem Cloud SQL-Replikat verwendet werden soll. Die Optionen für diese Version sind MYSQL_5_7 oder MYSQL_8_0. Diese Hauptversion der Datenbank muss mit der Datenbankversion übereinstimmen, die Sie für den externen Server angegeben haben. Sie können auch eine Nebenversion angeben. Diese muss mit der Version auf dem externen Server identisch oder höher sein. Eine Liste der verfügbaren Strings für MySQL finden Sie unter SqlDatabaseVersion.
    INSTANCE_TIER Der Maschinentyp zum Hosten der Replikatinstanz. Sie müssen einen Maschinentyp angeben, der mit der Version Ihrer Instanz übereinstimmt. Wenn Sie beispielsweise ENTERPRISE_PLUS für das Feld edition angeben, müssen Sie einen db-perf-optimized Maschinentyp angeben. Eine Liste der unterstützten Maschinentypen finden Sie unter Maschinentypen.
    DISK_SIZE_GB Die Speichergröße für das Cloud SQL-Replikat in GB.
    EDITION_NAME Die Cloud SQL-Version, die für das Replikat verwendet werden soll. Mögliche Werte sind ENTERPRISE_PLUS (nur MySQL 8.0) oder ENTERPRISE.
    SOURCE_NAME Der Name, den Sie der Quelldarstellungsinstanz zugewiesen haben.
  2. Erstellen Sie die Zielreplikatinstanz. Stellen Sie dazu mit dem folgenden curl-Befehl eine Anfrage an die Cloud SQL Admin API. Geben Sie in den Daten für die Anfrage die von Ihnen erstellte JSON-Datei an.

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data @./replica.json \
        -X POST \
    https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances
    Attribut Beschreibung
    PROJECT_ID Die ID Ihres Projekts in Google Cloud.

Option 2: Vorhandene Replikationsinstanz verwenden

  1. Die vorhandene Replikainstanz muss mindestens so viel freien Speicherplatz haben wie die physischen Dateien, die Sie in den Cloud Storage-Bucket hochgeladen haben. Die Instanz muss über ausreichenden Laufwerkspeicherplatz verfügen, um die gleiche Datenmenge aus Cloud Storage herunterzuladen.

  2. Wenn Sie eine vorhandene Replikationsinstanz verwenden möchten, verwenden Sie die folgende Beispiel-replica.json-Datei:

    {
    "demoteContext": {
        "sourceRepresentativeInstanceName": "SOURCE_NAME"
      }
    }
    Attribut Beschreibung
    SOURCE_NAME Der Name, den Sie der Quelldarstellungsinstanz zugewiesen haben.
  3. Stufen Sie die vorhandene Zielreplikatinstanz zurück. Stellen Sie dazu mit dem folgenden curl-Befehl eine Anfrage an die Cloud SQL Admin API. Geben Sie in den Daten für die Anfrage die von Ihnen erstellte JSON-Datei an.

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data @./replica.json \
        -X POST \
    https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/EXISTING_INSTANCE_ID/demote
    Attribut Beschreibung
    PROJECT_ID Die ID Ihres Projekts in Google Cloud.
    EXISTING_INSTANCE_ID Die ID der vorhandenen Replikationsinstanz, die Sie für die Migration verwenden möchten.

Migrationseinstellungen prüfen

Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihre Instanzen für die Migration richtig eingerichtet sind.

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{
             "syncMode": "SYNC_MODE",
             "skipVerification": false,
             "migrationType": "PHYSICAL"
               }' \
     -X POST \
https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/verifyExternalSyncSettings
Attribut Beschreibung
SYNC_MODE Geben Sie offline an, um die Migration als einmaligen Vorgang zu konfigurieren. Wenn Sie eine kontinuierliche Replikation vom externen Server einrichten möchten, geben Sie online an.
PROJECT_ID Die ID Ihres Projekts in Google Cloud.
REPLICA_NAME Der Name, den Sie der Zielreplikatinstanz zugewiesen haben.

Als erste Antwort gibt dieser Bestätigungsschritt ein Dienstkonto zurück. Sie müssen diesem Dienstkonto Cloud Storage-Berechtigungen zuweisen, um mit der Migration fortzufahren. Die Fehlermeldung über unzureichende Berechtigungen wird erwartet. Hier ist ein Beispiel für eine Antwort:

{
    "kind": "sql#externalSyncSettingError",
    "type": "INSUFFICIENT_GCS_PERMISSIONS",
    "detail": "Service account
              p703314288590-df3om0@my-project.iam.gserviceaccount.com
              is missing necessary permissions storage.objects.list and
              storage.objects.get to access Google Cloud Storage bucket"
}

Dem zurückgegebenen Dienstkonto Cloud Storage-Berechtigungen hinzufügen

So fügen Sie die erforderlichen Berechtigungen hinzu:

  1. Wechseln Sie in der Google Cloud Console zur Cloud Storage-Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie auf den Tab Berechtigungen.

  3. Klicken Sie auf Zugriff erlauben.

  4. Geben Sie im Feld Neue Hauptkonten den Namen des Dienstkontos ein, das in der Bestätigungsantwort zurückgegeben wurde. In der Beispielausgabe des vorherigen Schritts lautet der zurückgegebene Dienstkontoname beispielsweise p703314288590-df3om0@my-project.iam.gserviceaccount.com.

  5. Wählen Sie im Drop-down-Menü Rolle auswählen die Rolle Storage Object Viewer aus.

  6. Klicken Sie auf Speichern.

Bestätigung noch einmal durchführen

Nachdem Sie dem Dienstkonto die erforderlichen Berechtigungen hinzugefügt haben, führen Sie den Bestätigungsschritt noch einmal aus, um sicherzustellen, dass das Dienstkonto Zugriff auf den Cloud Storage-Bucket hat.

Im Rahmen der Überprüfung wird Folgendes geprüft:

  • Es besteht eine Verbindung zwischen dem Cloud SQL-Replikat und dem externen Server, aber nur, wenn die Migration kontinuierlich erfolgt.
  • Berechtigungen für den Replikationsnutzer reichen aus
  • Versionen sind kompatibel
  • Das Cloud SQL-Replikat wird noch nicht repliziert
  • Binäre Logs sind auf dem externen Server aktiviert

Wenn Probleme erkannt werden, gibt Cloud SQL eine Fehlermeldung zurück.

Nutzer dem Cloud SQL-Replikat hinzufügen

Datenbanknutzerkonten können nicht vom externen Server importiert oder migriert werden. Wenn Sie dem Cloud SQL-Replikat Datenbanknutzerkonten hinzufügen möchten, fügen Sie diese Konten hinzu, bevor Sie mit der Replikation beginnen. Weitere Informationen finden Sie unter Nutzer mit integrierter Authentifizierung verwalten.

Migration starten

Nachdem Sie die Überprüfung abgeschlossen haben und keine Fehler zurückgegeben wurden, können Sie mit der Migration beginnen. Verwenden Sie die API startExternalSync, um Ihren externen Server zu migrieren.

Verwenden Sie den folgenden Befehl:

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{
               "syncMode": "SYNC_MODE",
               "skipVerification": false,
               "migrationType": "PHYSICAL"
              }' \
     -X POST \
https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/startExternalSync
Attribut Beschreibung
SYNC_MODE Geben Sie offline an, um die Migration als einmaligen Vorgang zu konfigurieren. Wenn Sie eine kontinuierliche Replikation vom externen Server einrichten möchten, geben Sie online an.
PROJECT_ID Die ID Ihres Projekts in Google Cloud.
REPLICA_NAME Der Name, den Sie der Zielreplikatinstanz zugewiesen haben.

Migration überwachen

So prüfen Sie den Status Ihrer Migration:

  1. Rufen Sie die Vorgangs-ID des Migrationsjobs aus der Antwort der startExternalSync API ab. Beispiele:

    {
    "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/my-project/instances/replica-instance",
     "status": "PENDING",
     "user": "user@example.com",
     "insertTime": "******",
     "operationType": "START_EXTERNAL_SYNC",
     "name": "******",
     "targetId": "replica-instance",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/my-project/operations/OPERATION_ID",
     "targetProject": "my-project"
    }
    
  2. Verwenden Sie die Vorgangs-ID im folgenden Befehl.

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        -X GET \
    https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/START_EXTERNAL_SYNC_OPERATION_ID
    Attribut Beschreibung
    PROJECT_ID Die ID Ihres Projekts in Google Cloud.
    START_EXTERNAL_SYNC_OPERATION_ID Die Vorgangs-ID Ihres Migrationsjobs.

Replikation überwachen

Wenn für die Zielreplikatinstanz in Cloud SQL der anfängliche Datenladevorgang abgeschlossen ist, stellt die Instanz eine Verbindung zum externen Server her und wendet alle Aktualisierungen an, die nach dem Exportvorgang vorgenommen wurden.

Informationen zum Überwachen des Replikationsstatus finden Sie unter Replikationsstatus prüfen.

Stellen Sie eine Verbindung zur Datenbank her, sobald das Cloud SQL-Replikat alle Änderungen vom externen Server erhalten hat und es keine Replikationsverzögerung auf dem Cloud SQL-Replikat gibt. Führen Sie die entsprechenden Datenbankbefehle aus, um zu prüfen, ob die Inhalte im Vergleich zum externen Server wie erwartet sind.

Nachdem Sie das Zielreplikat zu einer eigenständigen Instanz gemacht haben, können Sie die physischen XtraBackup-Dateien in Ihrem Cloud Storage-Bucket löschen. Behalten Sie Ihren externen Server bei, bis die erforderlichen Validierungen abgeschlossen sind.

Beschränkungen

In diesem Abschnitt werden die Einschränkungen des XtraBackup-Migrationsprozesses aufgeführt:

  • Sie müssen Percona XtraBackup verwenden, um Ihre Daten im Cloud Storage-Bucket zu sichern. Andere Sicherungstools werden nicht unterstützt.
  • 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.
  • Die Datenbankmigration von einer physischen XtraBackup-Datei wird nur für lokale MySQL-Datenbanken oder selbstverwaltete MySQL-Datenbanken unterstützt, die auf einer Compute Engine-VM ausgeführt werden. 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.
  • In Cloud Storage ist die Größe einer Datei, die Sie in einen Bucket hochladen können, auf 5 TB begrenzt.
  • Sie können keine Plugins aus Ihrer externen Datenbank migrieren.
  • Wenn Sie die Hochverfügbarkeit für Ihre Instanz konfiguriert haben, gilt das SLA erst nach Abschluss der ersten Phase der Migration. Diese Phase gilt als abgeschlossen, wenn alle Daten aus den physischen XtraBackup-Dateien in die Cloud SQL-Instanz importiert wurden.
  • Eine Migration zu oder von einer MySQL 8.4-Datenbank ist nicht möglich.

Fehlerbehebung

In diesem Abschnitt werden häufige Szenarien zur Fehlerbehebung aufgeführt.

Fehler beim Importieren

Wenn Sie beim Migrieren eine Fehlermeldung wie Attempt 1/2: import failed erhalten, müssen Sie beim Starten der Migration PHYSICAL für migrationType angeben.

Wenn Sie keinen migrationType angeben, wird standardmäßig LOGICAL verwendet.

Migration abbrechen oder beenden

Wenn Sie eine Migration abbrechen oder beenden möchten, können Sie den folgenden Befehl ausführen:

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
    -X POST \
https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/restart
Attribut Beschreibung
PROJECT_ID Die ID Ihres Projekts in Google Cloud.
REPLICA_NAME Der Name, den Sie der Zielreplikatinstanz zugewiesen haben.

Nächste Schritte