Cloud SQL und externen Server für die Replikation konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Ihren externen Server für die Replikation in Cloud SQL konfigurieren, eine Quelldarstellungsinstanz in Cloud SQL erstellen und die Daten in Cloud SQL replizieren. Sie müssen alle Schritte auf dieser Seite ausführen, bevor Sie mit den Replikationsschritten fortfahren.

Eine Alternative zu den auf dieser Seite beschriebenen Schritten ist der Database Migration Service. Dieser ermöglicht eine kontinuierliche Replikation oder eine einmalige Datenbankmigration von einem externen Server zu Cloud SQL.

Hinweis

Terminologie

  • Externer Server. Der MySQL-Server außerhalb von Cloud SQL, von dem Sie Daten replizieren möchten. Er wird auch als Quelldatenbank oder externer Datenbankserver bezeichnet. Dies kann eine andere Cloud SQL-Instanz oder ein anderer Datenbankserver sein, z. B. der lokale Amazon Relational Database Service (RDS) usw.

  • Quelldarstellungsinstanz. Die Simulation einer Cloud SQL-Instanz, die den externen Server für das Cloud SQL-Replikat darstellt. Sie ist in der Google Cloud Console sichtbar und sieht wie eine normale Cloud SQL-Instanz aus. Sie enthält jedoch keine Daten, erfordert keine Konfiguration oder Wartung und wirkt sich nicht auf die Abrechnung aus.

  • Cloud SQL-Replikat. Cloud SQL-Instanz, die vom externen Server repliziert wird. Sie wird auch als externes primäres Lesereplikat bezeichnet.

  • Nutzerkonto für die Replikation. Das MySQL-Nutzerkonto auf dem externen Server mit den erforderlichen Berechtigungen, um die Replikation zwischen dem externen Server und dem Cloud SQL-Replikat auszuführen.

  • Verwalteter Import. Vorgang, bei dem Daten direkt vom externen Server in das Cloud SQL-Replikat importiert werden. In diesem Fall stellt Cloud SQL über das Nutzerkonto für die Replikation eine Verbindung zum externen Server her und führt den Datendump direkt auf dem externen Server aus, um Daten in das Cloud SQL-Replikat zu importieren.

Google Cloud-Projekt einrichten

  1. 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.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

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

  4. Cloud SQL Admin API aktivieren.

    Aktivieren Sie die API

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

    Zur Projektauswahl

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

  7. Cloud SQL Admin API aktivieren.

    Aktivieren Sie die API

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

    Zur IAM-Seite

Google Cloud SDK installieren

Zum Konfigurieren der Replikation installieren Sie das Google Cloud SDK für Ihren externen Server. Sie können das SDK auf Ihrem externen Server installieren, sofern es nicht bereits an einem anderen Speicherort installiert ist.

Externen Server für die Replikation einrichten

Checkliste für externen Server

  • MySQL 5.5, 5.6, 5.7 oder 8.0 muss auf Ihrem externen Server installiert sein. MySQL Community Edition, Cloud SQL for MySQL, Amazon Aurora und MySQL unter Amazon RDS werden unterstützt.

    • Sie müssen für das Cloud SQL-Replikat eine Hauptversion von MySQL verwenden, die mit der Version auf dem externen Server identisch oder höher ist.
    • Wenn MySQL 5.5 auf dem externen Server installiert ist, wird GTID nicht unterstützt.
  • Achten Sie darauf, dass binäre Logs aktiviert und folgende Voraussetzungen erfüllt sind:

  • Prüfen Sie, ob auf Ihrem externen Server GTID aktiviert ist. Dies hat Auswirkungen auf die Vorgehensweise bei der Einrichtung der Replikation.

  • Prüfen Sie, ob Ihr externer Server globale Lesesperr-Berechtigungen hat. Dies hat Auswirkungen auf die Vorgehensweise bei der Einrichtung der Replikation.

  • Wenn das Cloud SQL-Replikat mit einer privaten IP-Adresse aktiviert ist, da die ausgehende private IP-Adresse nicht statisch ist, konfigurieren Sie die Firewall des externen Servers so, dass sie den internen IP-Bereich zulässt, der für den Zugriff auf private Dienste des VPC-Netzwerks zugewiesen wurde, das das Cloud SQL-Replikat als sein privates Netzwerk verwendet.

    Die Firewall des Quelldatenbankservers muss so konfiguriert sein, dass sie den gesamten internen IP-Adressbereich zulässt, der für die private Dienstverbindung des VPC-Netzwerks zugewiesen ist, das die Cloud SQL-Zielinstanz als Feld privateNetwork ihrer ipConfiguration-Einstellungen verwendet.

    So ermitteln Sie den internen IP-Bereich:

    1. Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf.

      Zur VPC-Netzwerkseite

    2. Wählen Sie das VPC-Netzwerk aus, das Sie verwenden möchten.

    3. Klicken Sie auf den Tab Private Dienstverbindung.

  • Wenn der externe Server DEFINER-Klauseln (Ansichten, Ereignisse, Trigger oder gespeicherte Prozeduren) enthält, kann die Replikation fehlschlagen, abhängig von der Reihenfolge, in der diese Anweisungen ausgeführt werden. Weitere Informationen zur Verwendung von DEFINER in Cloud SQL und zu möglichen Problemumgehungen finden Sie in diesem Artikel.

  • InnoDB ist die einzige unterstützte Speicher-Engine in Cloud SQL. Eine Migration mit MyISAM kann zu Dateninkonsistenzen führen und erfordert eine Datenvalidierung. Weitere Informationen finden Sie in der MySQL-Dokumentation unter Tabellen von MyISAM zu InnoDB konvertieren.

Aufbewahrung von binären Logs konfigurieren

Konfigurieren Sie Ihren externen Server so, dass binäre Logs für mindestens 24 Stunden lang aufbewahrt werden.

MySQL Community

Wenn Ihr externer Server die MySQL Community Edition nutzt, können Sie mithilfe der entsprechenden MySQL-Befehle die Einstellungen für die Aufbewahrung der binären Logs ändern.

Cloud SQL for MySQL

Wenn Ihr externer Server Cloud SQL for MySQL nutzt, werden Ihre binären Logs standardmäßig sieben Tage lang aufbewahrt. Sie können diese Einstellung aber ändern.

Amazon RDS und Aurora

Wenn der externe Server eine Amazon RDS-Instanz ist, können Sie mit folgendem Befehl die Einstellungen für die Aufbewahrung der binären Logs aktualisieren:

call mysql.rds_set_configuration('binlog retention ', HOURS);
Attribut Beschreibung
STUNDEN Die Gesamtzahl der Stunden an binären Logs, die die Amazon RDS-Instanz aufbewahren soll.

Weitere Informationen finden Sie unter mysql.rds_set_configuration.

Nutzerkonto für Replikation erstellen

Auf dem externen Server muss ein MySQL-Nutzerkonto für die Verwaltung der Replikation zum Cloud SQL-Replikat vorhanden sein. Dieses Nutzerkonto sollte nur zum Verwalten der Replikation verwendet werden. Je nach verwendetem Migrationsansatz müssen Sie dem Nutzer möglicherweise später Berechtigungen erteilen.

Um ein Nutzerkonto für die Replikation einzurichten, öffnen Sie auf dem externen Server ein Terminal und geben Sie die folgenden MySQL-Befehle ein:

MySQL

      CREATE USER 'USERNAME'@'%' IDENTIFIED BY 'PASSWORD';
      GRANT SELECT, SHOW VIEW ON *.* TO 'USERNAME'@'HOST';
      FLUSH PRIVILEGES;

Beispiel

CREATE USER 'replicationUser'@'%' IDENTIFIED BY '8*&fwwd';
GRANT SELECT, SHOW VIEW ON *.* TO 'replicationUser'@'%';
FLUSH PRIVILEGES;
Attribut Beschreibung
USERNAME Das Nutzerkonto für die Replikation auf dem externen Server.
PASSWORD Das Passwort des Nutzerkontos für die Replikation.
HOST Legen Sie diese Option auf % fest, um alle Verbindungen von jedem Host zu akzeptieren. In einem späteren Schritt wird dies geändert, damit nur noch Verbindungen vom Cloud SQL-Replikat akzeptiert werden.

Quelldarstellungsinstanz einrichten

Die Quelldarstellungsinstanz verweist auf den externen Server. Sie enthält nur die Anfragedaten vom externen Server. Erstellen Sie die Anfragedaten und verwenden Sie sie in einem curl-Befehl, der die Quelldarstellungsinstanz in Cloud SQL erstellt.

Anfragedaten erstellen

Die Anfragedaten enthalten grundlegende Informationen zu Ihrem Quelldatenbankserver im JSON-Format. Die Anfragedaten können für ein Cloud SQL-Replikat in einem öffentlichen oder privaten Netzwerk konfiguriert werden und sollten folgende Informationen enthalten:

source.json

    {
      "name": "SOURCE_NAME",
      "region": "REGION",
      "databaseVersion": "DATABASE_VERSION",
      "onPremisesConfiguration": {
        "hostPort": "SOURCE_HOST",
        "username": "USERNAME",
        "password": "PASSWORD",
        "caCertificate": "SOURCE_CERT",
        "clientCertificate": "CLIENT_CERT",
        "clientKey": "CLIENT_KEY"
      }
    }

Beispiel für verwalteten Import

// example of source.json for external server that
// - initiates replication from a Cloud SQL managed import
// - doesn't use SSL/TSL

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "hostPort": "192.0.2.0:3306",
    "username": "replicationUser",
    "password": "486#@%*@"
  }
}

Beispiel für Dumpdatei

// example of source.json for external server that
// - initiates replication from a file
// - uses SSL/TSL

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "hostPort": "192.0.2.0:"3306",
    "username": "replicationUser",
    "password": "486#@%*@",
    "dumpFilePath": "gs://replica-bucket/source-database.sql.gz",
    "caCertificate": "content of your certificate",
    "clientCertificate": "content of your certificate",
    "clientKey": "content of your client key"
  }
}

Beispiel für einen benutzerdefinierten Import

// example of source.json for external server that
// - initiates replication from a Cloud SQL custom import
// - doesn't use SSL/TSL

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "hostPort": "192.0.2.0:3306",
    "username": "replicationUser",
    "password": "486#@%*@"
  }
}
Attribut Beschreibung
SOURCE_NAME Der Name der zu erstellenden Quelldarstellungsinstanz.
REGION Die Region, in der sich die Quelldarstellungsinstanz befinden soll.
DATABASE_VERSION Die auf dem externen Server ausgeführte Datenbankversion. Die Optionen sind MYSQL_5_6, 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. Wenn der externe Server in Cloud SQL gehostet wird, lautet der Port 3306.
USERNAME Das Nutzerkonto für die Replikation auf dem externen Server.
PASSWORD Das Passwort des Nutzerkontos für die Replikation.
BUCKET Der Name des Buckets, der die Dumpdatei enthält. Nur einschließen, wenn Sie die Replikation mit einer Dumpdatei einrichten, die in einem Cloud Storage-Bucket vorhanden ist.
DUMP_FILE Eine Datei in dem Bucket, die die Daten vom externen Server 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.

Quelldarstellungsinstanz erstellen

Erstellen Sie eine JSON-Datei, die Ihre Quellanfragedaten enthält, bevor Sie diesen Schritt ausführen.

Öffnen Sie dann ein Terminal und führen Sie die folgenden Befehle aus, um die Quelldarstellungsinstanz in Cloud SQL zu erstellen:

curl

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data @JSON_PATH \
         -X POST \
         https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances

example

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/sql/v1beta4/projects/MyProject/instances
Attribut Beschreibung
PROJECT_ID Die ID Ihres Projekts in Google Cloud.
JSON_PATH Der Pfad zur JSON-Datei mit den Anfragedaten für den externen Server.

Quelldarstellungsinstanz aktualisieren

Wenn Sie die Anfragedaten vom externen Server aktualisieren, können Sie die vorhandene Quelldarstellungsinstanz für die Verwendung der geänderten Werte aktualisieren.

Anfragedaten ändern

Aktualisieren Sie die Anfragedaten, um alle Felder einzubeziehen, die geändert wurden. Dazu gehören die Felder hostPort, username, password, caCertificate, clientCertificate und clientKey. Nachdem Sie die Anfragedaten aktualisiert haben, verwenden Sie sie in einem curl-Befehl, um die Instanz in Cloud SQL zu aktualisieren.

Das folgende Beispiel zeigt die Aktualisierung der Felder username und password mit einem anderen Nutzernamen und Passwort:

source.json

    {
      "name": "SOURCE_NAME",
      "region": "REGION",
      "databaseVersion": "DATABASE_VERSION",
      "onPremisesConfiguration": {
        "username": "NEW_USERNAME",
        "password": "NEW_PASSWORD"
      }
    }

Beispiel für verwalteten Import

// example of source.json for external server that
// - initiates replication from a Cloud SQL managed import
// - doesn't use SSL/TSL

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "username": "newReplicationUser",
    "password": "525#@%*@"
  }
}

Beispiel für Dumpdatei

// example of source.json for external server that
// - initiates replication from a file
// - uses SSL/TSL

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "username": "newReplicationUser",
    "password": "486#@%*@"
  }
}

Beispiel für einen benutzerdefinierten Import

// example of source.json for external server that
// - initiates replication from a Cloud SQL custom import
// - doesn't use SSL/TSL

{
  "name": "cloudsql-source-instance",
  "region": "us-central1",
  "databaseVersion": "MYSQL_5_7",
  "onPremisesConfiguration": {
    "username": "newReplicationUser",
    "password": "486#@%*@"
  }
}
Attribut Beschreibung
SOURCE_NAME Der Name der Quelldarstellungsinstanz.
REGION Die Region, in der sich die Quelldarstellungsinstanz befindet.
DATABASE_VERSION Die auf dem externen Server ausgeführte Datenbankversion. Die Optionen sind MYSQL_5_6, MYSQL_5_7 oder MYSQL_8_0 .
NEW_USERNAME Das neue Nutzerkonto für die Replikation auf dem externen Server.
NEW_PASSWORD Das Passwort für das neue Konto.

Quelldarstellungsinstanz ändern

Erstellen Sie eine JSON-Datei, die Ihre geänderten Anfragedaten enthält, bevor Sie diesen Schritt ausführen.

Öffnen Sie dann ein Terminal und führen Sie die folgenden Befehle aus, um die Quelldarstellungsinstanz in Cloud SQL zu ändern:

curl

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data @JSON_PATH \
         -X PATCH \
         https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/SOURCE_NAME

example

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 PATCH \
     https://sqladmin.googleapis.com/sql/v1beta4/projects/MyProject/instances/cloudsql-source-instance
Attribut Beschreibung
PROJECT_ID Die ID Ihres Projekts in Google Cloud.
JSON_PATH Der Pfad zur JSON-Datei mit den Anfragedaten für den externen Server.
SOURCE_NAME Der Name der Quelldarstellungsinstanz.

Cloud SQL-Replikat einrichten

Das Cloud SQL-Replikat erhält schließlich die Daten vom externen Server. In diesem Schritt erstellen Sie die Anfragedaten und verwenden sie in einem curl-Befehl, mit dem das Cloud SQL-Replikat in Cloud SQL erstellt wird.

Anfragedaten erstellen

Die Anfragedaten enthalten grundlegende Informationen zum externen Server und zum Cloud SQL-Replikat im JSON-Format. Die Anfragedaten für ein Cloud SQL-Replikat können in einem öffentlichen oder privaten Netzwerk konfiguriert werden und sollten folgende Informationen enthalten:

replica.json

    {
        "settings": {
            "tier": "TIER",
            "dataDiskSizeGb": "DISK_SIZE",
            "ipConfiguration": {
                "privateNetwork": "projects/PROJECT_ID/global/networks/NETWORK_NAME"
             },
             "availabilityType": "AVAILABILITY_TYPE"
        },
        "masterInstanceName": "SOURCE_REPRESENTATION_INSTANCE_NAME",
        "region": "SOURCE_REGION",
        "databaseVersion": "DATABASE_VERSION",
        "name": "REPLICA_NAME"
    }

example

    {
        "settings": {
            "tier": "db-custom-4-15360",
            "dataDiskSizeGb": "100"
        },
        "masterInstanceName": "source-instance",
        "region": "us-central1",
        "databaseVersion": "MYSQL_5_7",
        "name": "replica-instance"
    }
Attribut Beschreibung
TIER Der Maschinentyp zum Hosten der Replikatinstanz. Wenn Sie nicht wissen, welchen Maschinentyp Sie verwenden sollen, beginnen Sie mit db-custom-2-7680. Bei Bedarf können Sie die Größe und andere Parameter ändern.
DISK_SIZE Die Speichergröße für das Cloud SQL-Replikat in GB.
PROJECT_ID Die ID Ihres Projekts in Google Cloud. Geben Sie ipConfiguration nur an, wenn sich das Cloud SQL-Replikat in einem privaten Netzwerk befindet.
NETWORK_NAME Der Name des privaten Netzwerks, das mit dem Cloud SQL-Replikat verwendet werden soll.
AVAILABILITY_TYPE Der Verfügbarkeitstyp des Cloud SQL-Replikats. Der Standardwert ist ZONAL. Legen Sie den Wert auf REGIONAL fest, um die Hochverfügbarkeitsreplikat (HA-Replikat) zu erstellen. Informationen zu den zulässigen Werten finden Sie unter SqlAvailabilityType.
Nachdem Sie ein externes Server-HA-Replikat erstellt haben, können Sie es nicht mehr in ein Nicht-HA-Replikat ändern. Dies gilt auch umgekehrt. Externe Nicht-HA-Replikate können nicht in Hochverfügbarkeitsreplikate geändert werden.
Ein manuelles Failover kann zu einer nicht wiederherstellbaren Migration führen, wenn versucht wird, dass die Instanz noch die ursprünglichen Daten lädt, oder es kann zu temporären Ausfallzeiten führen, wenn die Instanz bereits aus der Quelle repliziert. Prüfen Sie den Replikationsstatus.
SOURCE_REPRESENTATION_INSTANCE_NAME Der Name der Quelldarstellungsinstanz.
SOURCE_REGION Die Region, die der Quelldarstellungsinstanz zugewiesen ist.
DATABASE_VERSION Die Datenbankversion, die mit dem Cloud SQL-Replikat verwendet werden soll. Die Optionen für diese Version sind MYSQL_5_6, MYSQL_5_7 oder MYSQL_8_0. Passen Sie die Datenbankversion an, die auf Ihrem externen Server ausgeführt wird, oder legen Sie den Wert auf maximal eine Version fest.
REPLICA_NAME Der Name des zu erstellenden Cloud SQL-Replikats.

Cloud SQL-Replikat erstellen

Erstellen Sie vor diesem Schritt eine JSON-Datei, die die Anfragedaten für das Replikat enthält. Öffnen Sie zum Erstellen eines Cloud SQL-Replikats ein Cloud Shell-Terminal und führen Sie die folgenden Befehle aus:

curl

    gcloud auth login
    ACCESS_TOKEN="$(gcloud auth print-access-token)"
    curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
         --header 'Content-Type: application/json' \
         --data @JSON_PATH \
         -X POST \
         https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances

example

    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/sql/v1beta4/projects/MyProject/instances
Attribut Beschreibung
PROJECT_ID Die ID Ihres Projekts in Google Cloud, die mit der ID der Quellinstanz übereinstimmen muss.
JSON_PATH Der Pfad zur JSON-Datei, die die Anfragedaten für das Cloud SQL-Replikat enthält.

Einrichtung überprüfen

Rufen Sie die Seite Cloud SQL-Instanzen auf, um zu prüfen, ob die Instanzen korrekt eingerichtet wurden.

Die Quelldarstellungsinstanz und das Cloud SQL-Replikat sollten in etwa so aussehen:

Instanz-ID Typ Öffentliche IP-Adresse
(-) source-representation-instance Externe Datenbank primär 10.68.48.3:3306
     Replikatinstanz Lesereplikat der Datenbank 34.66.48.59

Achten Sie außerdem darauf, dass Sie die Berechtigung cloudsql.instances.migrate für das Cloud SQL-Replikat haben. Diese Berechtigung ist in den IAM-Rollen cloudsql.admin oder cloudsql.editor enthalten.

Nutzer dem Cloud SQL-Replikat hinzufügen

Datenbanknutzerkonten können nicht vom externen Server importiert werden. Sie können jedoch auf einem Cloud SQL-Replikat erstellt werden. Legen Sie diese an, bevor Sie ein Replikat vom externen Server erstellen.

Ausgehende IP-Adresse des Cloud SQL-Replikats abrufen

Sie können mit der ausgehenden IP-Adresse des Cloud SQL-Replikats eine sichere Verbindung zwischen dem externen Server und dem Cloud SQL-Replikat herstellen. Diese IP-Adresse wird Ihnen nicht in Rechnung gestellt.

Console

So rufen Sie die ausgehende IP-Adresse für das Replikat ab:

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Bewegen Sie den Mauszeiger neben der öffentlichen IP-Adresse des Cloud SQL-Replikats auf die Kurzinfo Weitere Informationen und rufen Sie die ausgehende IP-Adresse ab.

    Beachten Sie, dass die ausgehende IP-Adresse nicht die IP-Adresse ist, die in der Hauptliste für das Replikat in der Google Cloud Console angezeigt wird.

gcloud

Führen Sie den folgenden Befehl aus, um die ausgehende IP-Adresse für das Replikat abzurufen:

gcloud sql instances describe REPLICA_NAME --format="default(ipAddresses)"
Attribut Beschreibung
REPLICA_NAME Der Name des Cloud SQL-Replikats, dessen ausgehende öffentliche IP-Adresse Sie abrufen möchten.

Eingehende Verbindungen auf dem externen Server zulassen

Das Cloud SQL-Replikat muss eine Verbindung zum externen Server herstellen, damit die Replikation möglich ist. Sie müssen die Netzwerkfirewall für Ihren externen Server so konfigurieren, dass Verbindungen von der ausgehenden IP-Adresse des Cloud SQL-Replikats zulässig sind, wenn die folgenden Bedingungen zutreffen:

  • Der externe Server ist durch eine Firewall oder durch andere Netzwerkbeschränkungen geschützt.
  • Ihr Cloud SQL-Replikat verwendet eine öffentliche IP-Adresse.

Um eine Verbindung zum Cloud SQL-Replikat herzustellen, verwenden Sie die primäre IP-Adresse des Replikats. Diese IP-Adresse wird in der Google Cloud Console angezeigt.

Quelldarstellungsinstanz für eine Replikation zum Cloud SQL-Replikat aktualisieren

Nach der Einrichtung der Quelldarstellungsinstanz für das Cloud SQL-Replikat müssen Sie möglicherweise die Quelldarstellungsinstanz aktualisieren. Beispielsweise müssen Ihre Konfigurationen in folgenden Fällen aktualisiert werden:

  • Der Host, der Port oder die IP des externen Servers hat sich geändert.
  • Sie möchten einen anderen Nutzer für MySQL-Replikate verwenden.
  • Das Passwort des Nutzers für MySQL-Replikate wurde geändert.
  • Die SSL-Zertifikate, die für die sichere Verbindung zum externen Server verwendet wurden, wurden geändert.

Cloud SQL-Replikat übertragen

Für das anfängliche Laden der Daten vom externen Server in das Cloud SQL-Replikat gibt es drei Möglichkeiten:

  • Ein verwalteter Import verwendet einen Dienst, der Daten vom externen Server extrahiert und direkt in die Cloud SQL-Instanz importiert. Cloud SQL empfiehlt diese Option. Sie müssen diese Option verwenden, wenn Ihr externer Server keine Replikation der globalen Transaktions-ID (GTID) verwendet. Weitere Informationen finden Sie unter Replikation aus externen Datenbanken mithilfe eines verwalteten Imports einrichten.
  • Für eine Dumpdatei müssen Sie eine Dumpdatei Ihres externen Servers erstellen, sie in einen Cloud Storage-Bucket verschieben und in Cloud SQL importieren. Sie können diese Option nur verwenden, wenn Ihr externer Server die GTID-Replikation verwendet. Weitere Informationen finden Sie unter Replikation aus externen Datenbanken mithilfe einer Dumpdatei einrichten.
  • Bei einem benutzerdefinierten Import müssen Sie eine primäre Cloud SQL-Instanz erstellen, einen benutzerdefinierten Datenimport mithilfe Ihrer bevorzugten Tools ausführen, den Import auf ein Cloud SQL-Replikat zurückstufen und dann die Replikation von einem externen Server einrichten. Dies funktioniert am besten für Multi-TB-Datenbankmigrationen. Sie müssen jedoch die GTID-Replikation verwenden. Weitere Informationen finden Sie unter Benutzerdefinierten Import zum Einrichten der Replikation aus großen externen Datenbanken verwenden.

Welche Option ist die richtige für Sie?

Diagramm: Cloud SQL-Nutzerfluss

Replikation überwachen

Wenn für das Cloud SQL-Replikat der anfängliche Datenladevorgang abgeschlossen ist, wird eine Verbindung zum externen Server hergestellt und es werden alle Aktualisierungen angewendet, die nach dem Exportvorgang vorgenommen wurden. Bestätigen Sie den Replikationsstatus.

Es ist wichtig, dass Sie den Replikationsstatus prüfen, bevor Sie das Replikat zu einer eigenständigen Instanz hochstufen. Wenn der Replikationsvorgang nicht erfolgreich abgeschlossen wurde, enthält ein hochgestuftes Replikat nicht alle Änderungen von Ihrem externen Server.

Wenn die Replikationsverzögerung nicht gegen 0 tendiert, nehmen Sie entsprechende Korrekturen vor. Sie können diese Messwerte prüfen: /postgresql/external_sync/initial_sync_complete, postgresql/external_sync/max_replica_byte_lag und database/replication/state. Liste der Cloud SQL-Messwerte aufrufen.

Stellen Sie eine Verbindung zur Datenbank her, sobald das Cloud SQL-Replikat den externen Server erreicht 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. Behalten Sie Ihren externen Server bei, bis die erforderlichen Validierungen abgeschlossen sind.

Kaskadierendes Replikat einrichten

Nach der Migration können Sie kaskadierende Lesereplikate unter Ihrem Cloud SQL-Replikat erstellen, bevor Sie das Cloud SQL-Replikat hochstufen.

Sie können kaskadierende Replikate für Ihre Cloud SQL-Instanz nur erstellen, wenn Sie die GTID-Replikation verwenden.

Erstellen Sie ein kaskadierendes Replikat, um folgende Befehle auszuführen:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Aktivieren Sie für MySQL 5.7 oder höher die Replikation.
  3. Klicken Sie auf den Tab Replikate für das Replikat, das als übergeordnetes Element für das Replikat fungieren soll, das Sie erstellen möchten.
  4. Klicken Sie auf Replikat erstellen.
  5. Aktualisieren Sie auf der Seite Lesereplikat erstellen die Instanz-ID sowie alle anderen Konfigurationsoptionen, einschließlich Name, Region und Zone.
  6. Klicken Sie auf Erstellen.

    Cloud SQL erstellt ein Replikat. Sie werden dann zur Instanzseite des übergeordneten Replikats zurückgeleitet.

  7. Führen Sie die Schritte 4 bis 6 für jedes neue kaskadierende Replikat aus, das Sie erstellen möchten.

gcloud

  1. Wenn Sie MySQL Version 5.7 oder höher verwenden, aktivieren Sie binlogs für das primäre Replikat des neuen Replikats:
    gcloud sql instances patch --enable-bin-log
          --project=cascade-replica PARENT_REPLICA_NAME
    
    Ersetzen Sie PARENT_REPLICA_NAME durch den Namen des übergeordneten Replikats.
  2. Erstellen Sie das neue Replikat. Geben Sie dazu mit dem Flag --master-instance-name Ihr Cloud SQL-Replikat als primäre Instanz an:

    gcloud sql instances create REPLICA_NAME \
          --master-instance-name=PARENT_REPLICA_NAME \
    
    Dabei gilt:
    • REPLICA_NAME: die eindeutige ID des Replikats, das Sie erstellen
    • PARENT_REPLICA_NAME: der Name des Cloud SQL-Replikats
  3. Nachdem das Replikat erstellt wurde, können Sie sehen, dass die an der primären Instanz vorgenommenen Änderungen durch alle Replikate in der Kette der kaskadierenden Replikate repliziert werden.

curl

  1. Wenn Sie MySQL Version 5.7 oder höher verwenden, aktivieren Sie binäres Logging:

    Speichern Sie zum Aktivieren des binären Loggings den folgenden JSON-Code in einer Datei mit dem Namen „request.JSON“ und rufen Sie dann den curl-Befehl auf um binäres Logging zu aktivieren
    {
      "settings":
      {
        "backupConfiguration":
        {
          "enabled": false,
          "binaryLogEnabled": true
        }
      }
    }
    

  2. Zum Erstellen eines Replikats unter dem übergeordneten Replikat bearbeiten Sie das folgende JSON-Codebeispiel und speichern es in einer Datei mit dem Namen request.json:

    {
      "masterInstanceName": "EXTERNAL_SERVER_REPLICA_NAME",
      "project": "PROJECT_ID",
      "name": "REPLICA_NAME",
      "region": "REPLICA_REGION",
      "settings":
        {
          "tier": "MACHINE_TYPE",
        }
    }
    
  3. Führen Sie dazu diesen Befehl aus:
    curl -X POST
    -H "Authorization: Bearer "$(gcloud auth print-access-token)
    -H "Content-Type: application/json; charset=utf-8"
    -d @request.json
    "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"
    

Replikat hochstufen

Stufen Sie das Replikat so hoch:

  1. Stufen Sie das Replikat zur primären Instanz hoch. Beachten Sie, dass GTID und binäre Logs sowie die geplanten Sicherungen auf dem hochgestuften Replikat aktiviert sind.
  2. Fügen Sie der Instanz Lesereplikate hinzu.
  3. Optional: Konfigurieren Sie eine Hochverfügbarkeit für Ihre Instanz. Zur Vermeidung zusätzlicher Ausfallzeiten können Sie HA während der Einrichtung eines Replikats aktivieren, indem Sie AVAILABILITY_TYPE auf REGIONAL setzen.

Nächste Schritte