レプリケーション用に Cloud SQL と外部サーバーを構成する

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL へのレプリケーション用に外部サーバーを構成する方法、Cloud SQL にレプリケーション元表現インスタンスを作成する方法、データを Cloud SQL にレプリケートする方法について説明します。レプリケーションの手順に進む前に、このページで説明する手順をすべて完了する必要があります。

このページで説明する手順の代わりに、Database Migration Service を使用することもできます。このサービスを使用して、外部サーバーから Cloud SQL に継続的なレプリケーションを行うことも、データベースの移行を 1 回行うこともできます。

始める前に

用語

外部サーバー: Cloud SQL の外部にあり、データのレプリケーション元となる MySQL サーバー。レプリケーション元データベース、外部データベースサーバーとも呼ばれます。別の Cloud SQL インスタンスの場合も、オンプレミス、Amazon リレーショナルデータベースサービス（RDS）などの他のデータベースサーバーの場合もあります。
レプリケーション元表現インスタンス: Cloud SQL レプリカに対する外部サーバーを表す Cloud SQL インスタンスのモック。これは Google Cloud コンソールに表示されます。通常の Cloud SQL インスタンスのように見えますが、データは含まれていません。構成やメンテナンスは必要ありません。また、課金にも影響しません。
Cloud SQL レプリカ: 外部サーバーから複製する Cloud SQL インスタンス。外部プライマリリードレプリカともいいます。
レプリケーションユーザーアカウント: 外部サーバーと Cloud SQL レプリカ間のレプリケーションを実行できる十分な権限がある、外部サーバー上の MySQL ユーザーアカウント。
マネージドインポート: 外部サーバーから Cloud SQL レプリカにデータを直接インポートするプロセス。この場合、Cloud SQL はレプリケーションユーザーアカウントを使用して外部サーバーに接続し、外部サーバーで直接データダンプを実行して Cloud SQL レプリカにデータをインポートします。

Google Cloud プロジェクトの設定

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.

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

Go to project selector

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

Enable the Cloud SQL Admin API.

Enable the API

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

Go to project selector

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

Enable the Cloud SQL Admin API.

Enable the API

ユーザーアカウントに Cloud SQL 管理者、ストレージ管理者、Compute 閲覧者のロールがあることを確認します。

IAM ページに移動

Google Cloud SDK のインストール

レプリケーションを構成するには、外部サーバー用の Google Cloud SDK をインストールします。SDK を別の場所にすでにインストールしていない限り、外部サーバーに SDK をインストールすることをおすすめします。

レプリケーション用の外部サーバーを設定する

外部サーバーのチェックリスト

外部サーバーに MySQL 5.5、5.6、5.7、8.0、または 8.4 がインストールされていることを確認します。MySQL Community Edition、Cloud SQL for MySQL、Amazon Aurora、Amazon RDS 上の MySQL に対応しています。
- 外部サーバーで動作している MySQL のバージョンと以上のメジャーバージョンの MySQL を、Cloud SQL レプリカで使用する必要があります。
- 外部サーバーに MySQL 5.5 がインストールされている場合、GTID には対応しません。
バイナリログが有効になっていることと、次のことを確認します。
- 行ベースのバイナリロギングが使用されている。
- データベースの移行への対応が完了するまでバイナリログが保持されている。通常は 1 週間ほどで十分です。
外部サーバーで GTID が有効になっているかどうか確認します。これにより、レプリケーションの設定に必要な手順が変わります。
外部サーバーにグローバル読み取りロック権限があるかどうか確認します。これにより、レプリケーションの設定に必要な手順が変わります。
送信プライベート IP アドレスが静的でないために Cloud SQL レプリカがプライベート IP アドレスで有効になっている場合は、Cloud SQL レプリカがプライベートネットワークとして使用する VPC ネットワークのプライベートサービスアクセスに割り振られた内部 IP 範囲を許可するように外部サーバーのファイアウォールを構成します。

ソースデータベースサーバーのファイアウォールは、Cloud SQL の宛先インスタンスが IPConfiguration 設定の privateNetwork フィールドとして使用する VPC ネットワークのプライベートサービス接続に割り振られた内部 IP 範囲全体を許可するように構成する必要があります。

内部 IP 範囲を確認するには:
1. Google Cloud コンソールの [VPC ネットワーク] ページに移動します。
  
  [VPC ネットワーク] ページに移動
2. 使用する VPC ネットワークを選択します。
3. [プライベートサービス接続] タブをクリックします。
外部サーバーに DEFINER 句（ビュー、イベント、トリガー、ストアドプロシージャ）が含まれている場合、これらのステートメントの実行順序によってはレプリケーションが失敗することがあります。Cloud SQL での DEFINER の使用方法と考えられる回避策の詳細をご確認ください。
InnoDB は、Cloud SQL で対応している唯一のストレージエンジンです。MyISAM を使用して移行すると、データに不整合が生じる可能性があり、データの検証が必要になることがあります。詳細については、MySQL ドキュメントで MyISAM から InnoDB へのテーブルの変換をご覧ください。

バイナリログの保持期間の構成

バイナリログを少なくとも 24 時間保持するように外部サーバーを構成する必要があります。

MySQL コミュニティ

外部サーバーで MySQL Community Edition を使用している場合は、以下の MySQL コマンドを使用してバイナリログの保持設定を更新できます。

MySQL 5.5～5.7: expire_logs_days
MySQL 8.0.x: expire_logs_days, binlog_expire_logs_seconds
MySQL 8.4: binlog_expire_logs_seconds

Cloud SQL for MySQL

外部サーバーで Cloud SQL for MySQL を使用している場合、デフォルトでは、バイナリログは 7 日間保持されます。この設定は変更できます。

Amazon RDS と Aurora

外部サーバーが Amazon RDS インスタンスの場合、次のコマンドを使用して、バイナリログ保持の設定を更新できます。

call mysql.rds_set_configuration('binlog retention ', HOURS);

プロパティ	説明
HOURS	Amazon RDS インスタンスがバイナリログを保持する合計時間数。

詳細については、mysql.rds_set_configuration をご覧ください。

レプリケーションユーザーアカウントの作成

外部サーバーに、Cloud SQL レプリカへのレプリケーションを管理する専用の MySQL ユーザーアカウントが存在する必要があります。このユーザーアカウントは、レプリケーションの管理にのみ使用します。使用する移行方法によっては、後でユーザーに権限を付与する必要があります。

レプリケーションユーザーアカウントを追加するには、外部サーバーでターミナルを開き、次の MySQL コマンドを入力します。

MySQL

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

例

CREATE USER 'replicationUser'@'%' IDENTIFIED BY '8*&fwwd';
GRANT SELECT, SHOW VIEW ON *.* TO 'replicationUser'@'%';
FLUSH PRIVILEGES;

プロパティ	説明
`USERNAME`	外部サーバー上のレプリケーションユーザーアカウント。
`PASSWORD`	レプリケーションユーザーアカウントのパスワード。
`HOST`	任意のホストからのすべての接続を受け入れるには、これを `%` に設定します。この後のステップで、Cloud SQL レプリカからの接続のみを受け入れるように変更されます。

レプリケーション元表現インスタンスの設定

レプリケーション元表現インスタンスは外部サーバーを参照します。ここには、外部サーバーからのリクエストデータのみが含まれます。リクエストデータを作成して curl コマンドで使用し、Cloud SQL にレプリケーション元表現インスタンスを作成します。

リクエストデータの作成

リクエストデータには、外部サーバーに関する基本情報が JSON 形式で含まれています。リクエストデータは、パブリックネットワークまたはプライベートネットワーク上の Cloud SQL レプリカ用に構成でき、この情報が含まれている必要があります。

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"
      }
    }

マネージドインポートの例

// 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#@%*@"
  }
}

ダンプファイルの例

// 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"
  }
}

カスタムインポートの例

// 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#@%*@"
  }
}

プロパティ	説明
`SOURCE_NAME`	作成するレプリケーション元表現インスタンスの名前。
`REGION`	レプリケーション元表現インスタンスを配置するリージョン。
`DATABASE_VERSION`	外部サーバーで実行されているデータベースのバージョン。選択肢は `MYSQL_5_6`、`MYSQL_5_7`、`MYSQL_8_0`、`MYSQL_8_4` です。.
`SOURCE HOST`	外部サーバーの IPv4 アドレスとポート、または外部サーバーの DNS アドレス。DNS アドレスを使用する場合は、最大 60 文字を含めることができます。外部サーバーが Cloud SQL でホストされている場合、ポートは `3306` です。
`USERNAME`	外部サーバー上のレプリケーションユーザーアカウント。
`PASSWORD`	レプリケーションユーザーアカウントのパスワード。
`BUCKET`	ダンプファイルが含まれるバケットの名前。Cloud Storage バケットに存在するダンプファイルを使用してレプリケーションを設定する場合にのみ指定します。
`DUMP_FILE`	外部サーバーのデータが含まれるバケット内のファイル。
`CLIENT_CA_CERT`	外部サーバーの CA 証明書。外部サーバーで SSL / TLS が使用されている場合にのみ指定します。
`CLIENT_CERT`	外部サーバー上のクライアント証明書。サーバークライアント認証を使用する場合にのみ必要です。外部サーバーで SSL / TLS が使用されている場合にのみ指定します。
`CLIENT_KEY`	外部サーバー上のクライアント証明書の秘密鍵ファイル。サーバークライアント認証を使用する場合にのみ必要です。外部サーバーで SSL / TLS が使用されている場合にのみ指定します。

レプリケーション元表現インスタンスを作成する

この手順を始める前に、レプリケーション元リクエストデータを含む JSON ファイルを作成します。

次に、Cloud SQL でレプリケーション元表現インスタンスを作成するために、ターミナルを開いて次のコマンドを実行します。

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

例

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

プロパティ	説明
`PROJECT_ID`	Google Cloud のプロジェクトの ID。
`JSON_PATH`	外部サーバーのリクエストデータを含む `JSON` ファイルのパス。

レプリケーション元表現インスタンスを更新する

外部サーバーからのリクエストデータを更新する場合は、変更した値を使用するように既存のレプリケーション元表現インスタンスを更新します。

リクエストデータを変更する

リクエストデータを更新して、変更されたフィールドを含めます。これには、hostPort、username、password、caCertificate、clientCertificate、clientKey フィールドが含まれます。リクエストデータを更新したら、そのデータを curl コマンドで使用して、Cloud SQL のインスタンスを更新します。

次の例では、username フィールドと password フィールドを別のユーザー名とパスワードで更新しています。

source.json

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

マネージドインポートの例

// 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#@%*@"
  }
}

ダンプファイルの例

// 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#@%*@"
  }
}

カスタムインポートの例

// 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#@%*@"
  }
}

プロパティ	説明
`SOURCE_NAME`	レプリケーション元表現インスタンスの名前。
`REGION`	レプリケーション元表現インスタンスが存在するリージョン。
`DATABASE_VERSION`	外部サーバーで実行されているデータベースのバージョン。選択肢は `MYSQL_5_6`、`MYSQL_5_7`、`MYSQL_8_0`、`MYSQL_8_4` です。
`NEW_USERNAME`	外部サーバー上の新しいレプリケーションユーザーアカウント。
`NEW_PASSWORD`	新しいアカウントのパスワード。

レプリケーション元表現インスタンスを変更する

この手順を始める前に、変更したリクエストデータを含む JSON ファイルを作成します。

次に、Cloud SQL でレプリケーション元表現インスタンスを変更するために、ターミナルを開いて次のコマンドを実行します。

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

例

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

プロパティ	説明
`PROJECT_ID`	Google Cloud のプロジェクトの ID。
`JSON_PATH`	外部サーバーのリクエストデータを含む `JSON` ファイルのパス。
`SOURCE_NAME`	レプリケーション元表現インスタンスの名前。

Cloud SQL レプリカの設定

Cloud SQL レプリカには、最終的に外部サーバーからのデータが含まれます。このステップでは、リクエストデータを作成し、そのデータを curl コマンドで使用して、Cloud SQL に Cloud SQL レプリカを作成します。

リクエストデータの作成

リクエストデータには、外部サーバーと Cloud SQL レプリカに関する基本情報が JSON 形式で含まれています。リクエストデータは、パブリックネットワークまたはプライベートネットワーク上の Cloud SQL レプリカ用に構成でき、この情報が含まれている必要があります。

replica.json

    {
        "settings": {
            "tier": "TIER",
            "dataDiskSizeGb": "DISK_SIZE",
            "ipConfiguration": {
                "ipv4Enabled": "PUBLIC_IP_STATUS",
                "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"
    }

例

    {
        "settings": {
            "tier": "db-custom-4-15360",
            "dataDiskSizeGb": "100"
        },
        "masterInstanceName": "source-instance",
        "region": "us-central1",
        "databaseVersion": "MYSQL_8_0",
        "name": "replica-instance"
    }

プロパティ	説明
`TIER`	レプリカインスタンスをホストするマシンタイプ。どのマシンタイプを使用するかわからない場合は、`db-custom-2-7680` から始めます。後で必要に応じてサイズと対応している他の値を変更できます。
`DISK_SIZE`	Cloud SQL レプリカのストレージサイズ（GB）。
`PUBLIC_IP_STATUS`	インスタンスにパブリック IP アドレスが割り当てられるかどうかを確認します。デフォルトでは、このプロパティの値は `true` です。レプリカのパブリック IP アドレスの割り当てをオフにするには、値を `false` に設定します。プロジェクトで `constraints/sql.restrictPublicIp` 組織のポリシーが有効になっている場合は、Cloud SQL レプリカを作成するために、`ipv4Enabled` プロパティの値を `false` に設定する必要があります。パブリック IP アドレスの割り当てを無効にする方法については、パブリック IP を無効にするをご覧ください。
`PROJECT_ID`	Cloud SQL レプリカがプライベートネットワーク上にある場合は、`replica.json` ファイルに `privateNetwork` プロパティを追加します。`PROJECT_ID` には、Google Cloud のプロジェクトの ID を指定します。
`NETWORK_NAME`	Cloud SQL レプリカで使用するプライベートネットワークの名前。
`AVAILABILITY_TYPE`	Cloud SQL レプリカの可用性タイプ。デフォルトでは、値は `ZONAL` です。レプリカを HA にするには、値を `REGIONAL` に設定します。使用可能な値については、SqlAvailabilityType をご覧ください。外部サーバーの HA レプリカを作成した後で、それを非 HA レプリカに変更することはできません。その逆も同様です。外部サーバーの非 HA レプリカを HA レプリカに変更することはできません。インスタンスが最初のデータをまだ読み込んでいるときに手動フェイルオーバーを行うと、回復不能な移行が発生する可能性があります。また、インスタンスが移行元からのレプリケートを開始している場合に手動フェイルオーバーを行うと、一時的なダウンタイムが発生する可能性があります。レプリケーションのステータスを確認します。
`SOURCE_REPRESENTATION_INSTANCE_NAME`	レプリケーション元表現インスタンスの名前。
`SOURCE_REGION`	レプリケーション元表現インスタンスに割り当てられているリージョン。
`DATABASE_VERSION`	Cloud SQL レプリカで使用するデータベースのバージョン。このバージョンの選択肢は `MYSQL_5_6`、`MYSQL_5_7`、`MYSQL_8_0`、`MYSQL_8_4` です。外部サーバーで実行されているデータベースと同じバージョンに合わせるか、それよりも 1 つ大きいバージョンに値を設定します。
`REPLICA_NAME`	作成する Cloud SQL レプリカの名前。

Cloud SQL レプリカの作成

この手順を始める前に、レプリカリクエストデータを含む JSON ファイルを作成します。次に、Cloud SQL レプリカを作成するため、Cloud Shell ターミナルを開いて次のコマンドを実行します。

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

例

    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

プロパティ	説明
`PROJECT_ID`	Google Cloud のプロジェクトの ID。これはレプリケーション元インスタンスの ID と同じにする必要があります。
`JSON_PATH`	Cloud SQL レプリカのリクエストデータが含まれる `JSON` ファイルのパス。

設定を確認する

インスタンスが正しく設定されていることを確認するには、Cloud SQL インスタンスページに移動します。

次のようなリストでレプリケーション元表現インスタンスと Cloud SQL レプリカが表示されます。

インスタンス ID	タイプ	パブリック IP
(-) source-representation-instance	データベース外部プライマリ	10.68.48.3:3306
replica-instance	データベースのリードレプリカ	34.66.48.59

Cloud SQL レプリカに対する cloudsql.instances.migrate 権限があることも確認してください。この権限は、cloudsql.admin または cloudsql.editor の IAM ロールに含まれています。

Cloud SQL レプリカへのユーザーの追加

外部サーバーからデータベースユーザーアカウントをインポートすることはできませんが、このアカウントを Cloud SQL レプリカに作成することはできます。外部サーバーから複製する前に、このアカウントを作成してください。

Cloud SQL レプリカの送信 IP アドレスの取得

Cloud SQL レプリカの送信 IP アドレスを使用して、外部サーバーと Cloud SQL レプリカ間に安全な接続を作成できます。この IP アドレスに対しては課金されません。

コンソール

レプリカの送信 IP アドレスを取得するには、次の手順を行います。

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
Cloud SQL レプリカのパブリック IP アドレスの横にある [詳細] ツールチップにカーソルを合わせて、送信 IP アドレスを取得します。

この送信 IP アドレスは、Google Cloud コンソールでレプリカのメインリストに表示される IP アドレスではありません。

gcloud

レプリカの送信 IP アドレスを取得するには、次のコマンドを実行します。

gcloud sql instances describe REPLICA_NAME --format="default(ipAddresses)"

プロパティ	説明
`REPLICA_NAME`	取得したい送信パブリック IP アドレスを持つ Cloud SQL レプリカの名前。

外部サーバーで受信接続を許可する

レプリケーションを成功させるには、Cloud SQL レプリカが外部サーバーに接続する必要があります。次の条件に当てはまる場合、Cloud SQL レプリカの送信 IP アドレスからの接続を受け入れるように外部サーバーのネットワークファイアウォールを構成する必要があります。

外部サーバーがファイアウォールの背後にあるか、その他のネットワーク制限で保護されている。
Cloud SQL レプリカでパブリック IP を使用している。

Cloud SQL レプリカに接続するには、レプリカのプライマリ IP アドレスを使用します。この IP アドレスは、Google Cloud コンソールに表示されます。

Cloud SQL レプリカへのレプリケーションを許可するためにレプリケーション元表現インスタンスを更新する

Cloud SQL レプリカのレプリケーション元表現インスタンスを設定したら、レプリケーション元表現インスタンスの更新が必要になることがあります。たとえば、次のようなシナリオでは構成の更新が必要です。

外部サーバーのホスト、ポート、または IP を変更する。
別の MySQL レプリケーションユーザーを使用する。
MySQL レプリケーションユーザーのパスワードを変更する。
外部サーバーとのセキュア接続に使用する SSL 証明書を変更する。

Cloud SQL レプリカをシードする

外部サーバーから Cloud SQL レプリカへのデータの初期読み込みを実施するには、次の 3 つの方法があります。

マネージドインポートは、外部サーバーからデータを抽出し、Cloud SQL インスタンスに直接インポートするサービスを使用します。Cloud SQL では、このオプションをおすすめします。外部サーバーでグローバルトランザクション識別子（GTID）レプリケーションを使用しない場合は、このオプションを使用する必要があります。詳細については、マネージドインポートを使用して外部データベースからのレプリケーションを設定するをご覧ください。
ダンプファイルを使用するには、外部サーバーのダンプファイルを作成し、それを Cloud Storage バケットに移動して、Cloud SQL にインポートする必要があります。このオプションは、外部サーバーで GTID レプリケーションを使用している場合にのみ使用できます。詳細については、ダンプファイルを使用して外部データベースからのレプリケーションを設定するをご覧ください。
カスタムインポートの場合は、Cloud SQL プライマリインスタンスを作成して、任意のツールを使用してカスタムデータインポートを実施し、それを Cloud SQL レプリカに降格してから、外部サーバーレプリケーションを設定する必要があります。マルチ TB のデータベース移行には、この方法が最適ですが、GTID レプリケーションを使用する必要があります。詳細については、カスタムインポートを使用して大規模な外部データベースからのレプリケーションを設定するをご覧ください。

最適なオプション

Cloud SQL ユーザーフロー図

レプリケーションをモニタリングする

Cloud SQL レプリカは、最初のデータ読み込みを完了すると、外部サーバーに接続し、エクスポートオペレーションの後に行われたすべての更新を適用します。レプリケーションのステータスを確認します。

スタンドアロンインスタンスにレプリカを昇格する前に、レプリケーションのステータスを確認することが重要です。レプリケーションプロセスが正常に完了しなかった場合、昇格されたレプリカには、外部サーバーからの変更がすべて含まれるわけではありません。

レプリケーションの遅延が 0 に近づかない場合は、対応が必要です。/postgresql/external_sync/initial_sync_complete、postgresql/external_sync/max_replica_byte_lag、database/replication/state の各指標の確認が必要になることがあります。Cloud SQL 指標の一覧を表示します。

Cloud SQL レプリカが外部サーバーと同等になり、Cloud SQL レプリカにレプリケーションの遅延がなければ、データベースに接続します。適切なデータベースコマンドを実行し、外部サーバーと比較してコンテンツが想定どおりであることを確認します。必要な検証が完了するまで、外部サーバーを維持します。

カスケードレプリカを設定する

移行後、Cloud SQL レプリカをプロモートする前に、Cloud SQL レプリカにカスケードリードレプリカを作成できます。

Cloud SQL インスタンスのカスケードレプリカを作成できるのは、GTID レプリケーションを使用している場合のみです。

カスケードレプリカを作成するには、次のコマンドを実行します。

コンソール

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
MySQL 5.7 以降の場合は、レプリケーションを有効にします。
作成するレプリカの親として機能するレプリカの [レプリカ] タブをクリックします。
[レプリカを作成する] をクリックします。
[リードレプリカを作成する] ページで、インスタンス ID とその他の構成オプション（名前、リージョン、ゾーンなど）を更新します。
[作成] をクリックします。
Cloud SQL がレプリカを作成します。親レプリカのインスタンスページに戻ります。
作成する新しいカスケードレプリカごとに手順 4～6 を行います。

gcloud

MySQL バージョン 5.7 以降を使用している場合は、新しいレプリカのプライマリのバイナリログを有効にします。
```
gcloud sql instances patch --enable-bin-log
      --project=cascade-replica PARENT_REPLICA_NAME
```
PARENT_REPLICA_NAME は、親レプリカの名前に置き換えます。

--master-instance-name フラグを使用して Cloud SQL レプリカをプライマリインスタンスとして指定し、新しいレプリカを作成します。

gcloud sql instances create REPLICA_NAME \
      --master-instance-name=PARENT_REPLICA_NAME \

REPLICA_NAME: 作成するレプリカの一意の ID
PARENT_REPLICA_NAME: Cloud SQL レプリカの名前

レプリカが作成されると、プライマリインスタンスに対して行われた変更がカスケードレプリカチェーン内のすべてのレプリカで複製されることがわかります。

curl

MySQL バージョン 5.7 以降を使用している場合は、バイナリロギングを有効にします。

バイナリロギングを有効にするには、request.JSON という名前のファイルに次の JSON を保存してから、curl コマンドを呼び出して、バイナリロギングを有効にします。
```
{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "binaryLogEnabled": true
    }
  }
}
```

親レプリカの下にレプリカを作成するには、次の JSON コードサンプルを編集し、request.json というファイルに保存します。

{
  "masterInstanceName": "EXTERNAL_SERVER_REPLICA_NAME",
  "project": "PROJECT_ID",
  "name": "REPLICA_NAME",
  "region": "REPLICA_REGION",
  "settings":
    {
      "tier": "MACHINE_TYPE",
    }
}

次のコマンドを実行します。

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"

レプリカを昇格させる

次の手順でレプリカを昇格させます。

レプリカをプライマリインスタンスに昇格させます。昇格したレプリカで GTID ログとバイナリログがオンになり、スケジュールされたバックアップが有効になります。
リードレプリカをインスタンスに追加します。
省略可: 高可用性（HA）を確保するためにインスタンスを構成します。今後のダウンタイムを防ぐには、AVAILABILITY_TYPE を REGIONAL に設定してレプリカの設定中に HA を有効にします。

次のステップ

カスタムインポートを使用して大規模な外部データベースからのレプリケーションを設定する方法を確認する。
ダンプファイルを使用して外部データベースからのレプリケーションを設定する方法を確認する。

マネージドインポートを使用して外部データベースからのレプリケーションを設定する方法を確認する。

レプリケーション用に Cloud SQL と外部サーバーを構成する

始める前に

用語

Google Cloud プロジェクトの設定

Google Cloud SDK のインストール

レプリケーション用の外部サーバーを設定する

外部サーバーのチェックリスト

バイナリログの保持期間の構成

MySQL コミュニティ

Cloud SQL for MySQL

Amazon RDS と Aurora

レプリケーション ユーザー アカウントの作成

MySQL

例

レプリケーション元表現インスタンスの設定

リクエスト データの作成

source.json

マネージド インポートの例

ダンプファイルの例

カスタム インポートの例

レプリケーション元表現インスタンスを作成する

curl

例

レプリケーション元表現インスタンスを更新する

リクエスト データを変更する

source.json

マネージド インポートの例

ダンプファイルの例

カスタム インポートの例

レプリケーション元表現インスタンスを変更する

curl

例

Cloud SQL レプリカの設定

リクエスト データの作成

replica.json

例

Cloud SQL レプリカの作成

curl

例

設定を確認する

Cloud SQL レプリカへのユーザーの追加

Cloud SQL レプリカの送信 IP アドレスの取得

コンソール

gcloud

外部サーバーで受信接続を許可する

Cloud SQL レプリカへのレプリケーションを許可するためにレプリケーション元表現インスタンスを更新する

Cloud SQL レプリカをシードする

最適なオプション

レプリケーションをモニタリングする

カスケード レプリカを設定する

コンソール

gcloud

curl

レプリカを昇格させる

次のステップ

レプリケーションユーザーアカウントの作成

リクエストデータの作成

マネージドインポートの例

カスタムインポートの例

リクエストデータを変更する

マネージドインポートの例

カスタムインポートの例

リクエストデータの作成

カスケードレプリカを設定する