Von einer physischen XtraBackup-Datei zu Cloud SQL migrieren

MySQL | PostgreSQL | SQL Server

Vorschau — Database migration to Cloud SQL for MySQL from XtraBackup physical files

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Sie können personenbezogene Daten für dieses Feature gemäß der Zusatz zur Verarbeitung von Cloud-Daten verarbeiten, vorbehaltlich der in der Vereinbarung beschriebenen Verpflichtungen und Einschränkungen, die für den Zugriff auf Google Cloud gelten. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Auf dieser Seite wird beschrieben, wie Sie eine MySQL-Datenbank mithilfe einer physischen Datei von Percona XtraBackup for MySQL 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 mithilfe von Percona XtraBackup. Sie generieren physische Dateien mit dem Dienstprogramm XtraBackup und laden sie dann in Cloud Storage hoch. Mit physischen Dateien können Sie die Gesamtgeschwindigkeit Ihrer Migration bis zu zehnmal im Vergleich zu einer regulären logischen Dumpdatei-basierten Migration verbessern.

Cloud SQL unterstützt die physische dateibasierte Migration für MySQL 5.7 und 8.0. MySQL 5.6 wird nicht unterstützt. Die Migration von Amazon Aurora oder MySQL in Amazon RDS-Datenbanken wird nicht unterstützt. Außerdem muss die Zielreplikatinstanz in Cloud SQL for MySQL mit derselben MySQL-Hauptversion wie auf Ihrem externen 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 for MySQL Version 8.0.31 oder höher sein.

Für das Verfahren in diesem Dokument wird die Cloud SQL for MySQL Admin API verwendet. Sie können für diese Migration auch Database Migration Service verwenden. Weitere Informationen zur Verwendung des Database Migration Service finden Sie unter Datenbanken mit einer physischen Percona XtraBackup-Datei migrieren.

Hinweise

In diesem Abschnitt werden die Schritte beschrieben, die Sie vor der Migration Ihrer MySQL-Datenbank zu Google Cloud ausführen müssen.

Google Cloud-Projekt einrichten

Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

Zur Projektauswahl

Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

Cloud SQL Admin API aktivieren.

Aktivieren Sie die API

Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

Zur Projektauswahl

Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

Cloud SQL Admin API aktivieren.

Aktivieren Sie die API

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 die gcloud CLI-Befehle auf Ihrem externen Server verwenden möchten, installieren Sie das Google Cloud SDK.

Externen Server für die Migration vorbereiten

Installieren Sie auf Ihrem externen Server eine der folgenden Versionen des Dienstprogramms XtraBackup.
- Installieren Sie für MySQL 5.7 Percona XtraBackup 2.4.
- Installieren Sie für MySQL 8.0 Percona XtraBackup 8.0.x.
Für MySQL 8.0 müssen Sie eine Version von XtraBackup installieren, die mindestens der Version Ihres Quellservers entspricht. Weitere Informationen finden Sie unter Serverversion und Sicherungsversion im Vergleich in der Percona XtraBackup-Dokumentation.
Prüfen Sie, ob der externe 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 hat die Migration von einer physischen XtraBackup-Datei folgende 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 in Amazon RDS-Datenbanken wird nicht unterstützt.
- Sie dürfen den Parameter innodb_data_file_path nur mit einer Datendatei konfigurieren, die den Standarddatendateinamen ibdata1 verwendet. Wenn die 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. Beispielsweise wird eine mit innodb_data_file_path=ibdata01:50M:autoextend konfigurierte Datenbank für die Migration nicht unterstützt.
- Für den Parameter innodb_page_size in Ihrer externen Quelldatenbank muss der Standardwert 16384 konfiguriert sein.
Erstellen Sie ein Nutzerkonto für die Replikation, falls Sie noch keines eingerichtet haben. 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

Verwenden Sie auf dem externen Server XtraBackup, um eine vollständige Sicherung der Quelldatenbank durchzuführen. Weitere Informationen zum Erstellen einer vollständigen Sicherung finden Sie unter Vollständige Sicherung erstellen in der Percona XtraBackup-Dokumentation.

Andere Arten der Sicherung, z. B. inkrementelle und Teilsicherungen, werden nicht unterstützt.

Beispiel:
```
sudo xtrabackup --backup \
--target-dir=XTRABACKUP_PATH \
--user=USERNAME \
--password=PASSWORD
```
Ersetzen Sie die folgenden Variablen:
- XTRABACKUP_PATH: der Speicherort der Ausgabesicherungsdatei
- USERNAME: ein Nutzer mit BACKUP_ADMIN-Berechtigungen für die Quelldatenbank
- PASSWORD: das Passwort für den Nutzer
Verwenden Sie das Dienstprogramm XtraBackup, um die Sicherungsdatei vorzubereiten. Die Datei muss einen konsistenten Status haben. Weitere Informationen zum Vorbereiten einer vollständigen Sicherung finden Sie unter Vollständige Sicherung vorbereiten. Beispiel:
```
sudo xtrabackup --prepare --target-dir=XTRABACKUP_PATH
```
Ersetzen Sie XTRABACKUP_PATH durch den Speicherort der Ausgabesicherungsdatei. Die Ausführung dieses Befehls kann je nach Größe Ihrer Datenbank einige Minuten dauern.

Physische XtraBackup-Datei in Cloud Storage hochladen

Verwenden Sie das Dienstprogramm gsutil, um die Sicherungsdatei in Cloud Storage hochzuladen.

  time gsutil -m rsync -r XTRABACKUP_PATH CLOUD_STORAGE_BUCKET

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 unbegrenzt. Die Größe jeder einzelnen Datei, die Sie in einen Cloud Storage-Bucket hochladen können, ist jedoch auf 5 TB begrenzt.

Quelldarstellungsinstanz definieren

Erstellen Sie eine Datei source.json, die die Quelldarstellungsinstanz für Ihren externen Server definiert. 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 die Region an, in der Sie die Cloud SQL-Zielreplikatinstanz erstellen möchten.
`DATABASE_VERSION`	Die auf dem externen Server ausgeführte Datenbankversion. Die einzigen unterstützten Optionen sind `MYSQL_5_7` und `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.

Erstellen Sie die Quelldarstellungsinstanz. 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 Datei source.json 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 \
http://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances
```
Attribut Beschreibung

PROJECT_ID Die ID Ihres Projekts in Google Cloud.

Zielreplikatinstanz identifizieren

Erstellen Sie eine Datei, die das Zielreplikat in Cloud SQL für die Migration identifiziert. Durch Erstellen eines Replikats lassen sich Daten entweder zu einer neuen Instanz migrieren oder Sie verwenden eine vorhandene Cloud SQL-Instanz, indem Sie ein Replikat zurückstufen.

Option 1: Replikatinstanz erstellen

Verwenden Sie zum Erstellen einer Replikatinstanz die folgende replica.json-Beispieldatei:

{
"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 Datenbankhauptversion muss mit der Datenbankversion übereinstimmen, die Sie für den externen Server angegeben haben. Sie können auch eine Nebenversion angeben. Diese muss jedoch mit der auf dem externen Server installierten Version übereinstimmen 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 der Version Ihrer Instanz entspricht. Wenn Sie beispielsweise `ENTERPRISE_PLUS` für das Feld `edition` angeben, müssen Sie einen db-perf-optimierten Maschinentyp angeben. Eine Liste der unterstützten Maschinentypen finden Sie unter Maschinentyp.
`DISK_SIZE_GB`	Die Speichergröße für das Cloud SQL-Replikat in GB. Wichtig: Sie müssen eine Speichergröße angeben, die größer als die Größe der physischen Datei ist, die Sie in Cloud Storage hochgeladen haben.
`EDITION_NAME`	Die Cloud SQL-Version, die für das Replikat verwendet werden soll. Die möglichen Werte sind `ENTERPRISE_PLUS` (nur MySQL 8.0) oder `ENTERPRISE`.
`SOURCE_NAME`	Der Name, den Sie der Quelldarstellungsinstanz zugewiesen haben.

Erstellen Sie die Zielreplikatinstanz. Stellen Sie dazu eine Anfrage mit dem folgenden curl-Befehl an die Cloud SQL Admin API. Geben Sie in den Daten für die Anfrage die JSON-Datei an, die Sie erstellt haben.

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 \
http://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Attribut	Beschreibung
`PROJECT_ID`	Die ID Ihres Projekts in Google Cloud.

Option 2: Vorhandene Replikatinstanz verwenden

Achten Sie darauf, dass die vorhandene Replikatinstanz mindestens denselben freien Speicherplatz hat 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.
Verwenden Sie die folgende replica.json-Beispieldatei, um eine vorhandene Replikatinstanz zu verwenden:
```
{
"demoteContext": {
    "sourceRepresentativeInstanceName": "SOURCE_NAME"
  }
}
```
Attribut Beschreibung

SOURCE_NAME Der Name, den Sie der Quelldarstellungsinstanz zugewiesen haben.

Attribut	Beschreibung
`SOURCE_NAME`	Der Name, den Sie der Quelldarstellungsinstanz zugewiesen haben.

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 JSON-Datei an, die Sie erstellt haben.

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 \
http://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 Replikatinstanz, die Sie für die Migration verwenden möchten.

Migrationseinstellungen prüfen

Prüfen Sie mit dem folgenden Befehl, ob die Instanzen für die Migration ordnungsgemäß 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 \
http://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/verifyExternalSyncSettings

Attribut	Beschreibung
`SYNC_MODE`	Geben Sie `offline` an, um die Migration als einmaligen Prozess zu konfigurieren. Geben Sie `online` an, um die kontinuierliche Replikation vom externen Server einzurichten.
`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 erteilen, um mit der Migration fortfahren zu können. Die Fehlermeldung über unzureichende Berechtigungen wird erwartet. Hier ist eine Beispielantwort:

{
    "kind": "sql#externalSyncSettingError",
    "type": "INSUFFICIENT_GCS_PERMISSIONS",
    "detail": "Service account
              [email protected]
              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:

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

Buckets aufrufen
Klicken Sie auf den Tab Berechtigungen.
Klicken Sie auf Zugriff erlauben.
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 [email protected].
Wählen Sie im Drop-down-Menü Rolle auswählen die Rolle Storage Object Viewer aus.
Klicken Sie auf Speichern.

Bestätigung noch einmal ausführen

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

Bei der Bestätigung wird Folgendes geprüft:

Verbindung zwischen dem Cloud SQL-Replikat und dem externen Server ist vorhanden, jedoch nur bei kontinuierlicher Migration
Berechtigungen für den Replikationsnutzer sind ausreichend
Versionen sind kompatibel
Das Cloud SQL-Replikat wurde 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

Sie können keine Datenbanknutzerkonten vom externen Server importieren oder migrieren. Wenn Sie dem Cloud SQL-Replikat Datenbanknutzerkonten hinzufügen müssen, fügen Sie die Konten hinzu, bevor Sie mit der Replikation beginnen. Weitere Informationen finden Sie unter Nutzer mit integrierter Authentifizierung verwalten.

Migration starten

Wenn Sie die Prüfung abgeschlossen haben und keine Fehler zurückgegeben werden, können Sie mit der Migration beginnen. Verwenden Sie zum Migrieren des externen Servers die API startExternalSync.

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 \
http://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/startExternalSync

Attribut	Beschreibung
`SYNC_MODE`	Geben Sie `offline` an, um die Migration als einmaligen Prozess zu konfigurieren. Geben Sie `online` an, um die kontinuierliche Replikation vom externen Server einzurichten.
`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:

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

{
"kind": "sql#operation",
 "targetLink": "http://sqladmin.googleapis.com/v1/projects/my-project/instances/replica-instance",
 "status": "PENDING",
 "user": "[email protected]",
 "insertTime": "******",
 "operationType": "START_EXTERNAL_SYNC",
 "name": "******",
 "targetId": "replica-instance",
 "selfLink": "http://sqladmin.googleapis.com/v1/projects/my-project/operations/OPERATION_ID",
 "targetProject": "my-project"
}

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 \
http://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 des Migrationsjobs

Replikation überwachen

Wenn die Zielreplikatinstanz in Cloud SQL den anfänglichen Datenladevorgang abgeschlossen hat, 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 bestätigen.

Stellen Sie eine Verbindung zur Datenbank her, sobald das Cloud SQL-Replikat alle Änderungen vom externen Server erhalten hat und auf dem Cloud SQL-Replikat keine Replikationsverzögerung auftritt. 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 hochgestuft 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 bei der Migration von XtraBackup aufgeführt:

Sie müssen Percona XtraBackup nutzen, um Ihre Daten im Cloud Storage-Bucket zu sichern. Andere Sicherungsdienstprogramme werden nicht unterstützt.
Die Migration zu früheren Haupt- oder Nebenversionen der Datenbank wird nicht unterstützt. Beispielsweise können Sie nicht von MySQL 8.0 zu 5.7 oder von MySQL 8.0.36 zu 8.0.16 migrieren.
Die Datenbankmigration aus einer physischen XtraBackup-Datei wird nur für lokale MySQL-Datenbanken oder eine selbstverwaltete MySQL-Datenbank unterstützt, die auf einer Compute Engine-VM ausgeführt wird. Die Migration von Amazon Aurora- oder MySQL auf Amazon RDS-Datenbanken wird nicht unterstützt.
Eine Migration ist nur von einem vollständigen Backup möglich. Andere Sicherungstypen wie inkrementelle oder Teilsicherungen werden nicht unterstützt.
Die Datenbankmigration umfasst keine Datenbanknutzer oder -berechtigungen.
Sie müssen das Format des binären Logs auf ROW festlegen. Wenn Sie das binäre Log in einem anderen Format, z. B. STATEMENT oder MIXED, konfigurieren, kann die Replikation fehlschlagen.
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 Plug-ins aus Ihrer externen Datenbank migrieren.
Wenn Sie für Ihre Instanz eine Hochverfügbarkeit konfiguriert haben, gilt das SLA erst, wenn die Anfangsphase der Migration abgeschlossen ist. Diese Phase gilt als abgeschlossen, wenn alle Daten aus den physischen XtraBackup-Dateien in die Cloud SQL-Instanz importiert wurden.

Fehlerbehebung

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

Fehler beim Import

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

Wenn Sie keinen migrationType angeben, wird der Typ standardmäßig auf LOGICAL gesetzt.

Migration abbrechen oder beenden

Wenn Sie eine Migration abbrechen oder beenden müssen, 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 \
http://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.

Von einer physischen XtraBackup-Datei zu Cloud SQL migrieren

Hinweise

Google Cloud-Projekt einrichten

Cloud Storage-Bucket einrichten

Google Cloud SDK installieren

Externen Server für die Migration vorbereiten

Migration ausführen

Physische XtraBackup-Datei erstellen und vorbereiten

Physische XtraBackup-Datei in Cloud Storage hochladen

Quelldarstellungsinstanz definieren

Zielreplikatinstanz identifizieren

Option 1: Replikatinstanz erstellen

Option 2: Vorhandene Replikatinstanz verwenden

Migrationseinstellungen prüfen

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

Bestätigung noch einmal ausführen

Nutzer dem Cloud SQL-Replikat hinzufügen

Migration starten

Migration überwachen

Replikation überwachen

Beschränkungen

Fehlerbehebung

Fehler beim Import

Migration abbrechen oder beenden

Nächste Schritte