高度な障害復旧（DR）を使用する

MySQL | PostgreSQL | SQL Server

このページでは、高度な障害復旧（DR）を使用する方法について説明します。高度な DR には、2 つの主な機能があります。

レプリカフェイルオーバーでは、リージョン障害が発生した場合、すぐにプライマリインスタンスを DR レプリカにフェイルオーバーできます。
切り替えでは、データを損失することなく、プライマリインスタンスと指定された DR レプリカのロールを入れ替えることができます。切り替えを使用すると、レプリカのフェイルオーバー後にデプロイを元のデプロイ状態に復元できます。また、DR をテストすることもできます。

高度な DR は、Cloud SQL Enterprise Plus エディションのインスタンスでのみサポートされています。

DR レプリカを指定する

高度な DR を実行するには、まずクロスリージョン DR レプリカを指定する必要があります。

始める前に

Google Cloud SDK を使用する場合は、バージョン 470.0.0 以降と gcloud beta コマンドを使用する必要があります。Google Cloud SDK のバージョンを確認するには、gcloud --version を実行します。Google Cloud SDK を更新するには、gcloud components update を実行します。

Google Cloud SDK をインストールするには、gcloud CLI をインストールするをご覧ください。

DR レプリカの要件

指定された DR リードレプリカは、次の要件を満たしている必要があります。

Cloud SQL Enterprise Plus エディションインスタンスである
プライマリインスタンスと同じデータベースのメジャーバージョンとマイナーバージョンで、MySQL 8.0.31 以降を実行している
プライマリインスタンスとは別のリージョンに存在している
直接のリードレプリカである。カスケードレプリカにすることはできない
DR レプリカでは、デフォルト値の使用だけでなく、次のフラグを構成することもできない
- replicate_do_db
- replicate_ignore_db
- replicate_do_table
- replicate_wild_do_table
- replicate_ignore_table
- replicate_wild_ignore_table
PITR に使用されるトランザクションログを Cloud Storage に保存する
外部レプリカではない

DR レプリカの推奨事項

このセクションでは、DR レプリカに関する推奨事項を示します。デプロイのパフォーマンスの問題を回避するには、次の推奨事項に沿って操作してください。

プライマリインスタンスと同じディスクサイズを使用するか、自動拡張を有効にします。
一貫性のある HA 構成を使用します。プライマリインスタンスで HA を有効にする場合、DR レプリカでも HA を有効にします。
一貫性のあるデータキャッシュ構成を使用します。プライマリインスタンスでデータキャッシュを有効にする場合、DR レプリカでもデータキャッシュを有効にします。
切り替えまたはレプリカのフェイルオーバーオペレーションの前後に、DR レプリカに適したデータベースフラグを構成します。

DR レプリカの要件を満たすレプリカを作成する

プライマリインスタンスに、DR レプリカの要件を満たすクロスリージョンリードレプリカがまだない場合は、作成します。

コンソール

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスを見つけます。
[アクション] 列で、[その他の操作] メニューをクリックします。
[リードレプリカを作成] を選択します。
[インスタンス ID] フィールドに、DR レプリカの名前を入力します。
[データベースバージョン] フィールドでは、MySQL 8.0 がすでに選択されています。
[マイナーバージョン] フィールドは、あらかじめ選択されたマイナーバージョンのままにします。DR レプリカとプライマリインスタンスは、同じデータベースのマイナーバージョンを共有している必要があります。
ページの [リージョンとゾーンの可用性の選択] セクションで、次の操作を行います。
- プライマリインスタンスのリージョンとは異なるリージョンを選択します。
- 省略可。DR レプリカで [複数のゾーン] を選択します。
- 省略可。DR レプリカのプライマリゾーンとセカンダリゾーンを選択します。
このページの [インスタンスのカスタマイズ] セクションで、DR レプリカの設定を更新できます。各設定の詳細については、インスタンスの設定についてのページをご覧ください。
[マシンシェイプ] で、プライマリインスタンスと同じマシンタイプを選択します。
[フラグ] で、データベースに必要なフラグを構成します。
[レプリカを作成する] をクリックします。

Cloud SQL により、プライマリインスタンスのバックアップが作成され、レプリカが作成されます。プライマリのインスタンスページに戻ります。

gcloud

DR レプリカの要件を満たすレプリカを作成するには、次のコマンドを実行します。

gcloud sql instances create REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME \
   --region=REPLICA_REGION_NAME \
   --database-version=DATABASE_VERSION \
   --tier=MACHINE_TYPE \
   --availability-type=AVAILABILITY_TYPE
   --edition="ENTERPRISE_PLUS"

次の変数を置き換えます。

REPLICA_NAME: DR レプリカの名前。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
REPLICA_REGION_NAME: プライマリインスタンスのリージョンとは異なるリージョンを指定します。
DATABASE_VERSION: プライマリインスタンスのデータベースのメジャーバージョンとマイナーバージョンに一致するバージョン文字列を指定します（例: MYSQL_8_0_31）。
データベースのメジャーバージョンとマイナーバージョンは、プライマリレプリカと DR レプリカの両方において同じである必要があります。
MACHINE_TYPE: プライマリインスタンスと同じマシンタイプを指定します。マシンタイプは、プライマリインスタンスのマシンタイプと一致させることをおすすめします。
AVAILABILITY_TYPE: プライマリインスタンスが高可用性用に構成されている場合は、高可用性を有効にするために REGIONAL を指定することをおすすめします。
EDITION: ENTERPRISE_PLUS を指定します。

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
DATABASE_VERSION: バージョン文字列。プライマリインスタンスのデータベースのメジャーバージョンとマイナーバージョンに一致する必要があります（例: MYSQL_8_0_31）。データベースのメジャーバージョンとマイナーバージョンは、プライマリレプリカと DR レプリカの両方において同じである必要があります。
REPLICA_NAME: 作成する DR レプリカインスタンスの名前。
REPLICA_REGION: DR レプリカインスタンスのリージョン。レプリカのリージョンは、プライマリインスタンスのリージョンと別にする必要があります。
MACHINE_TYPE: プライマリインスタンスと同じマシンタイプを指定します。プライマリインスタンスと同じマシンタイプを選択することをおすすめします。
AVAILABILITY_TYPE: プライマリインスタンスが高可用性用に構成されている場合は、高可用性を有効にするために REGIONAL を指定することをおすすめします。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

リクエストの本文（JSON）:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "DATABASE_VERSION",
  "name": "REPLICA_NAME",
  "region": "REPLICA_REGION",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "replicationType": "ASYNCHRONOUS",
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

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"

PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_UD/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
DATABASE_VERSION: バージョン文字列。プライマリインスタンスのデータベースのメジャーバージョンとマイナーバージョンに一致する必要があります（例: MYSQL_8_0_31）。データベースのメジャーバージョンとマイナーバージョンは、プライマリレプリカと DR レプリカの両方において同じである必要があります。
REPLICA_NAME: 作成する DR レプリカインスタンスの名前。
REPLICA_REGION: DR レプリカインスタンスのリージョン。レプリカのリージョンは、プライマリインスタンスのリージョンと別にする必要があります。
MACHINE_TYPE: プライマリインスタンスと同じマシンタイプを指定します。ディスクサイズは、プライマリインスタンスのディスクサイズと一致させることをおすすめします。
AVAILABILITY_TYPE: プライマリインスタンスが高可用性用に構成されている場合は、高可用性を有効にするために REGIONAL を指定することをおすすめします。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

リクエストの本文（JSON）:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "DATABASE_VERSION",
  "name": "REPLICA_NAME",
  "region": "REPLICA_REGION",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "replicationType": "ASYNCHRONOUS",
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

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/v1beta4/projects/PROJECT_ID/instances"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_UD/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

プライマリインスタンスの DR レプリカを指定する

次の手順では、プライマリインスタンスのクロスリージョンレプリカの 1 つを、切り替えまたはレプリカフェイルオーバー用の DR レプリカとして指定する方法について説明します。

コンソール

プライマリインスタンスに DR レプリカを指定するには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスを見つけて選択します。プライマリインスタンスの概要ページが表示されます。
ナビゲーションメニューで [レプリカ] をクリックします。
リードレプリカのリストで、DR レプリカとして指定するクロスリージョンリードレプリカを見つけます。
レプリカのアクション ボタン more_vert をクリックし、[DR レプリカとして指定] を選択します。
[確認] をクリックします。

gcloud

プライマリインスタンスに DR レプリカを指定するには、次のコマンドを使用します。

gcloud beta sql instances patch PRIMARY_INSTANCE_NAME \
   --failover-dr-replica-name=PROJECT_ID:REPLICA_NAME

次の変数を置き換えます。

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。設定の一部としてプロジェクト ID を指定する必要があります。
REPLICA_NAME: DR レプリカの名前。

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。設定の一部としてプロジェクト ID を指定する必要があります。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
REPLICA_NAME: DR レプリカの名前。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

リクエストの本文（JSON）:

{
  "replicationCluster": {
     "failoverDrReplicaName": "PROJECT_ID:REPLICA_NAME"
   }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PATCH \
     -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/PRIMARY_INSTANCE_NAME"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。設定の一部としてプロジェクト ID を指定する必要があります。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
REPLICA_NAME: DR レプリカの名前。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

リクエストの本文（JSON）:

{
  "replicationCluster": {
     "failoverDrReplicaName": "PROJECT_ID:REPLICA_NAME"
   }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

DR レプリカの指定を変更する

レプリカが要件を満たしている場合、別のレプリカを DR レプリカとして指定できます。古い DR レプリカは DR レプリカの指定を失います。

コンソール

プライマリインスタンスの DR レプリカを変更するには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスを見つけて選択します。プライマリインスタンスの概要ページが表示されます。
ナビゲーションメニューで [レプリカ] をクリックします。
リードレプリカのリストで、新しい DR レプリカとして指定するクロスリージョンリードレプリカを見つけます。
レプリカのアクション ボタン more_vert をクリックし、[DR レプリカとして指定] を選択します。

gcloud

DR レプリカを変更するには、指定コマンドを再度実行し、別の DR レプリカを指定します。

REST

DR レプリカを変更するには、指定 API リクエストを再度作成し、別の DR レプリカを指定します。

DR レプリカの指定を表示する

gcloud CLI または Cloud SQL Admin API を使用して、プライマリインスタンスに割り当てられている DR レプリカを確認できます。レプリカが DR レプリカに指定されているかどうかを確認することもできます。

プライマリインスタンスに指定されている DR レプリカを確認するには、次の操作を行います。

コンソール

プライマリインスタンスに指定されている DR レプリカを確認するには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスを見つけて選択します。プライマリインスタンスの概要ページが表示されます。
ナビゲーションメニューで [レプリカ] をクリックします。
リードレプリカのリストで、指定された DR レプリカの [タイプ] 列に MySQL disaster recovery replica が表示されていることを確認します。

gcloud

プライマリインスタンスの DR レプリカとして指定されているインスタンスを確認するには、次のコマンドを使用します。

gcloud beta sql instances describe PRIMARY_INSTANCE_NAME

次の変数を置き換えます。

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前

このコマンドの出力には、指定された DR レプリカを識別する failoverDrReplica という名前のフィールドが含まれています。

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: インスタンスが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
  . . .
  "replicaNames": [
    "my-instance-replica"
  ],
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.5.4.1"
    }
  ],
  "instanceType": "CLOUD_SQL_INSTANCE",
   . . .
  "connectionName": "my-project:us-east1:my-instance",
  "name": "my-instance",
  "region": "us-east1",
  "gceZone": "us-east1-c",
  "secondaryGceZone": "us-east1-b",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "failoverDrReplicaName": "my-project:my-instance-replica"
   },
  "createTime": "2024-03-15T18:11:03.596Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: インスタンスが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
  . . .
  "replicaNames": [
    "my-instance-replica"
  ],
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.5.4.1"
    }
  ],
  "instanceType": "CLOUD_SQL_INSTANCE",
   . . .
  "connectionName": "my-project:us-east1:my-instance",
  "name": "my-instance",
  "region": "us-east1",
  "gceZone": "us-east1-c",
  "secondaryGceZone": "us-east1-b",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "failoverDrReplicaName": "my-project:my-instance-replica"
   },
  "createTime": "2024-03-15T18:11:03.596Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}
}

レプリカが DR レプリカかどうかを確認するには、次のいずれかの操作を行います。

コンソール

レプリカインスタンスが DR レプリカかどうかを確認するには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
レプリカインスタンスを見つけます。
指定された DR レプリカの [タイプ] 列に MySQL disaster recovery replica が表示されていることを確認します。

gcloud

レプリカインスタンスが DR レプリカかどうかを確認するには、次のコマンドを実行します。

gcloud beta sql instances describe REPLICA_NAME

次の変数を置き換えます。

REPLICA_NAME: 確認するリードレプリカの名前

レプリカが DR レプリカの場合、コマンドの出力に drReplica=true フィールドが含まれます。

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: インスタンスが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
REPLICA_NAME: レプリカの名前。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-perf-optimized-N-8",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    . . .
    },
  "masterInstanceName": "my-project:my-instance",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.3.2.1"
    }
  ],
  . . .
  "instanceType": "READ_REPLICA_INSTANCE",
  . . .
"connectionName": "my-project:us-east4:my-instance-replica",
  "name": "my-instance-replica",
  "region": "us-east4",
  "gceZone": "us-east4-b",
  "secondaryGceZone": "us-east4-c",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "drReplica": true
  },
  "createTime": "2024-03-15T18:17:44.655Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: インスタンスが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
REPLICA_NAME: レプリカの名前。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_31",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-perf-optimized-N-8",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    . . .
    },
  "masterInstanceName": "my-project:my-instance",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "192.3.2.1"
    }
  ],
  . . .
  "instanceType": "READ_REPLICA_INSTANCE",
  . . .
"connectionName": "my-project:us-east4:my-instance-replica",
  "name": "my-instance-replica",
  "region": "us-east4",
  "gceZone": "us-east4-b",
  "secondaryGceZone": "us-east4-c",
  "databaseInstalledVersion": "MYSQL_8_0_31",
  "maintenanceVersion": "MYSQL_8_0_31.R20240207.00_07",
  "replicationCluster" {
       "drReplica": true
  },
  "createTime": "2024-03-15T18:17:44.655Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

DR レプリカを削除する

プライマリインスタンスから DR レプリカの指定を消去できます。ただし、プライマリインスタンスに DR レプリカが割り当てられていない場合、切り替えまたはレプリカフェイルオーバーを実行することはできません。

コンソール

指定された DR レプリカをプライマリインスタンスから削除するには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスを見つけて選択します。プライマリインスタンスの概要ページが表示されます。
ナビゲーションメニューで [レプリカ] をクリックします。
リードレプリカのリストで、削除するクロスリージョンリードレプリカを見つけます。
レプリカのアクション ボタン more_vert をクリックし、[DR レプリカとして削除] を選択します。
[確認] をクリックします。

gcloud

DR レプリカの指定を削除するには、プライマリインスタンスで次のコマンドを実行します。

gcloud beta sql instances patch PRIMARY_INSTANCE_NAME \
  --clear-failover-dr-replica-name

次の変数を置き換えます。

PRIMARY_INSTANCE_NAME: 指定した DR レプリカを削除するプライマリインスタンスの名前

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
failoverDrReplicaName フィールドを空の文字列に設定します。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

リクエストの本文（JSON）:

{
  "replicationCluster": {
     "failoverDrReplicaName": ""
   }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PATCH \
     -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/PRIMARY_INSTANCE_NAME"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
failoverDrReplicaName フィールドを空の文字列に設定します。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME

リクエストの本文（JSON）:

{
  "replicationCluster": {
     "failoverDrReplicaName": ""
   }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_NAME" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

切り替えを行う

DR レプリカを指定したら、切り替えオペレーションを実行できます。ただし、ベストプラクティスとして、次の状況では切り替えオペレーションを行わないことをおすすめします。

プライマリインスタンスがアクティブに使用されている。
自動バックアップや高可用性（HA）の有効化 / 無効化などの管理オペレーションが進行中である。

タイムアウトを回避するには、トランザクションの量が少ないときに切り替えを行うことを検討してください。

切り替えが完了した後、新しいプライマリインスタンスが昇格するとすぐに、オペレーションによって新しいプライマリインスタンス（以前の DR レプリカ）のバックアップが作成されます。このバックアップが完了すると、新しいプライマリインスタンスでポイントインタイムリカバリ（PITR）が完全に有効になります。このバックアップは、ディスクサイズによって完了までに 5～15 分かかることがあります。PITR のカバレッジは、このバックアップが完了した後に開始されます。高度な DR で PITR を使用する際の考慮事項については、高度な DR で PITR を使用するをご覧ください。

切り替えオペレーションが完了すると、レプリケーションの方向が逆になります。

始める前に

切り替えオペレーションを実行する前に、次の操作を行います。

DR レプリカを指定する。プライマリインスタンスと指定された DR レプリカの間でのみ、切り替えを実行できます。
プライマリインスタンスと DR レプリカがオンラインであることを確認する。
プライマリインスタンスのオンデマンドバックアップを取得する。このバックアップは、予期しない障害から復旧する必要がある場合に備えて行います。

切り替えオペレーションを実行する

コンソール

切り替えオペレーションを実行するには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスの指定 DR レプリカを見つけます。
DR レプリカインスタンスをクリックします。DR レプリカの [概要] ページが表示されます。
[切り替え] ボタンをクリックします。
[プライマリレプリカと指定したリードレプリカを切り替える] ページの [インスタンス ID] フィールドに、プライマリインスタンスの名前を入力します。
[切り替え] をクリックします。

gcloud

切り替えオペレーションを実行するには、次のコマンドを実行します。

gcloud beta sql instances switchover REPLICA_NAME
   [--db-timeout=TIMEOUT_DURATION ]

次の変数を置き換えます。

REPLICA_NAME: プライマリインスタンスとロールを切り替える指定 DR レプリカの名前。
TIMEOUT_DURATION: 省略可。インスタンスでデータベースオペレーションを完了するためのタイムアウト期間。

このパラメータを指定しない場合、切り替えオペレーションには 10 分のタイムアウトが含まれます。

このタイムアウトの値を増やすには、--db-timeout パラメータを指定します。TIMEOUT_DURATION を、最大 24 時間の期間（単位記号の最初の 1 文字を含む）に置き換えます。たとえば、30 秒の場合は 30s を指定します。24 時間の場合は、24h を指定します。小数点以下 9 桁までを使用して、期間の単位の小数部を指定することもできます。たとえば、30.5 分の場合は 30.5m を指定します。

保留中のオペレーションがない場合は、このタイムアウトの値を削減できます。

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
REPLICA_NAME: DR レプリカの名前。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/switchover

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/switchover"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/switchover" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "SWITCHOVER",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
REPLICA_NAME: DR レプリカの名前。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "SWITCHOVER",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

レプリカフェイルオーバーを呼び出して DR を実行する

リージョンの障害または災害が発生した場合、指定された DR レプリカにレプリカのフェイルオーバーオペレーションを呼び出して、DR を実行できます。レプリカフェイルオーバーを実行するには、指定された DR レプリカを昇格します。切り替えとは異なり、DR レプリカの昇格は即座に行われます。

クロスリージョン DR レプリカはプライマリインスタンスのロールをすぐに引き受けるため、レプリケーションラグにより、レプリカに古いプライマリインスタンスのデータの一部が存在しない場合があります。これにより、レプリカのフェイルオーバーが原因でデータ損失が発生する可能性があります。

昇格プロセスの一環として、DR レプリカが新しいプライマリインスタンスになった直後に、レプリカのフェイルオーバーによって新しいプライマリインスタンス（以前の DR レプリカ）のバックアップが作成されます。このバックアップが完了すると、新しいプライマリインスタンスでポイントインタイムリカバリ（PITR）が完全に有効になります。このバックアップは、新しい（および古い）プライマリインスタンスのディスクサイズによって完了までに 5～15 分かかることがあります。このバックアップ期間中、PITR は利用できません。

古いプライマリインスタンスがオンラインに戻ると、レプリカのフェイルオーバープロセスがバックアップを取得します。このバックアップが取得された後、古いプライマリインスタンスは新しいプライマリインスタンスのリードレプリカとして再作成されます。このプロセスでは、まだ Cloud Storage に保存されていない古い PITR トランザクションログが、古いプライマリインスタンスから削除されます。したがって、レプリカのフェイルオーバーでは、古いプライマリインスタンスの PITR に使用されるすべてのトランザクションログが保持されるとは限りません。

高度な DR で PITR を使用する際の考慮事項については、高度な DR で PITR を使用するをご覧ください。

始める前に

レプリカのフェイルオーバーを行う前に、次の操作を行います。

まだ指定していない場合は、DR レプリカを指定します。レプリカフェイルオーバーは、プライマリインスタンスと指定された DR レプリカの間でのみ実行できます。
DR レプリカがオンラインかつ正常であることを確認します。

レプリカのフェイルオーバーオペレーションを実行する

コンソール

レプリカのフェイルオーバーオペレーションを行うには、次の操作を行います。

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスの指定 DR レプリカを見つけます。
DR レプリカインスタンスをクリックします。DR レプリカの [概要] ページが表示されます。
[レプリカフェイルオーバー] ボタンをクリックします。
[プライマリレプリカと指定したリードレプリカの間でレプリカフェイルオーバーを実行する] ページで、[インスタンス ID] フィールドにプライマリインスタンスの名前を入力して、オペレーションを続行することを確認します。
レプリカフェイルオーバーを開始するには、[レプリカフェイルオーバー] をクリックします。

gcloud

DR レプリカへのレプリカフェイルオーバーを呼び出すには、次のコマンドを使用します。

gcloud beta sql instances promote-replica \
   REPLICA_NAME --failover

次の変数を置き換えます。

REPLICA_NAME: DR レプリカの名前

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
REPLICA_NAME: DR レプリカの名前。
ENABLE_REPLICA_FAILOVER: レプリカのフェイルオーバーを使用するには、true に設定します。 false に設定すると、API はレプリカのフェイルオーバーなしで通常の promoteReplica メソッドを使用します。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "PROMOTE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
REPLICA_NAME: DR レプリカの名前。
ENABLE_REPLICA_FAILOVER: レプリカのフェイルオーバーを使用するには、true に設定します。 false に設定すると、API はレプリカのフェイルオーバーなしで通常の promoteReplica メソッドを使用します。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER

リクエストを送信するには、次のいずれかのオプションを開きます。

curl（Linux、macOS、Cloud Shell）

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER"

PowerShell（Windows）

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/promoteReplica?failover=ENABLE_REPLICA_FAILOVER" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T22:43:37.981Z",
  "operationType": "PROMOTE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

レプリカのフェイルオーバーのステータスを確認する

レプリカのフェイルオーバーには 2 つのフェーズがあります。フェーズ 1 では、DR レプリカを昇格します。フェーズ 2 では、古いプライマリインスタンスをリードレプリカとして再作成します。

レプリカのフェイルオーバーのステータスを確認するには、各フェーズのステータスを確認します。

最初のフェーズのステータスを確認します。
コンソール

指定した DR レプリカがスタンドアロンインスタンスに昇格されているかどうかを確認するには、次の操作を行います。
1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。
  
  Cloud SQL の [インスタンス] に移動
2. 昇格した DR レプリカの名前を確認します。
3. 新しいプライマリインスタンスの [タイプ] 列に MySQL 8.0 が表示されていることを確認します。
gcloud
ステータスを確認するには、次のコマンドを実行します。
```
gcloud sql instances describe DR_REPLICA_NAME
```
次の変数を置き換えます。
- DR_REPLICA_NAME: 昇格された DR レプリカの名前
出力に次のフィールドが表示されていて、レプリカがスタンドアロンの Cloud SQL プライマリインスタンスになったことを確認します。
```
instanceType: CLOUD_SQL_INSTANCE
```
フェーズ 2 が完了したことを確認するには、インスタンスのオペレーションログでメッセージ RECONFIGURE_OLD_PRIMARY を確認します。

このメッセージが表示されるのは、古いプライマリインスタンスがオンラインに戻ったときです。災害が発生した場合、数分または数日かかることがあります。

インスタンスのオペレーションログを確認する方法については、インスタンスのログを表示するをご覧ください。

高度な DR で PITR を使用する

切り替えとレプリカフェイルオーバーの両方で、DR レプリカがプライマリインスタンスに昇格するとすぐに、バックアップと PITR をサポートするために次の変更が実行されます。

バックアップ構成（自動バックアップのスケジュール設定など）は、古いプライマリインスタンスから新しいプライマリインスタンスにコピーされます。
無効になっている場合、バイナリログ構成フラグがオンになり、PITR が有効になります。
新しいプライマリインスタンスで PITR をサポートするために、新しいバックアップが取得されます。
トランザクションログ保持ポリシーが、古いプライマリインスタンスから新しいプライマリインスタンスにコピーされます。

バックアップ構成とトランザクションログ保持ポリシーの両方で、古いプライマリインスタンスから継承された設定が新しいプライマリインスタンスにおいて正しいかどうかを確認することをおすすめします。

PITR のカバレッジ開始

切り替えオペレーションの最後に、Cloud SQL は自動バックアップのスケジュールを設定し、新しいプライマリインスタンスの最初のバックアップを取得します。PITR のカバレッジをすぐに開始したい場合は、最初のバックアップが正常に完了したかどうかを確認することをおすすめします。新しく昇格されたプライマリインスタンスは、最初の自動バックアップが正常に完了した後にのみ PITR の対象となります。

インスタンスで使用可能なバックアップを表示する方法について詳しくは、バックアップのリストを表示するをご覧ください。

切り替えとレプリカフェイルオーバー中のインスタンスの PITR カバレッジ

切り替えまたはレプリカのフェイルオーバーオペレーションに参加する場合、インスタンスはリードレプリカとなります。インスタンスがリードレプリカとして使用されている期間は、PITR はサポートされません。切り替えイベントが発生する前の時点に PITR を実行する場合は、インスタンスをプライマリインスタンスに再度切り替える必要があります。インスタンスがプライマリインスタンスに切り替わった後、元の切り替えオペレーションより前の時点まで PITR を実行できます。

特定の時点でプライマリインスタンスがリードレプリカだったために PITR を実行できない場合は、その時点でプライマリインスタンスだったインスタンスに対して PITR リクエストを試行する必要があります。これを行うには、そのインスタンスに切り替えて PITR を試行します。

PITR リクエストに使用するインスタンスを決定するには、オペレーションリストを使用します。インスタンスのオペレーションリストは、インスタンスが切り替えまたはレプリカフェイルオーバーオペレーションをいつ行ったか判断するのに役立ちます。

レプリカのバックアップとトランザクションログの削除

PITR とバックアップで有効になっているプライマリインスタンスがリードレプリカになると、プライマリインスタンスとしての最後のバックアップと PITR 保持ポリシーが、レプリカとしての期間の間保持、適用されます。新しいプライマリインスタンスがバックアップを取得していなくても、最後に構成されたポリシーに沿って、PITR に使用される古いバックアップとトランザクションログがリードレプリカで削除されます。

たとえば、インスタンスが毎日自動バックアップを行い、7 日間の PITR ログを使用した 7 つのバックアップを保持するように構成されている場合、このインスタンスがリードレプリカになると、7 日以上経過したログは 1 日に 1 回削除されます。

バックアップをすぐに削除する必要がある場合は、バックアップを手動で削除できます。詳細については、バックアップを削除するをご覧ください。

制限事項

Private Service Connect を使用する Cloud SQL インスタンスでは、高度な DR はサポートされていません。
プライマリインスタンスがポイントインタイムリカバリ（PITR）のトランザクションログをディスクに保存している場合、Cloud SQL Enterprise Plus エディションのリードレプリカインスタンスを DR レプリカとして指定することはできません。インスタンスが PITR のログを保存する場所を確認するには、PITR に使用されるトランザクションログの保存場所を確認するをご覧ください。
外部レプリカを DR レプリカとして指定することはできません。

トラブルシューティング

問題	トラブルシューティング
切り替えオペレーションが失敗しました。	インスタンスが、DR レプリカの要件をすべて満たしていることを確認します。データベースのトランザクション量を確認します。切り替えは、切り替えを実行する前に、Cloud Storage でプライマリインスタンスのバイナリログを保護します。トランザクションの量が多いと、オペレーションがタイムアウトする可能性があります。トランザクションの負荷が少ないときにオペレーションを再試行することを検討してください。
切り替えオペレーションが失敗し、プライマリインスタンスが読み取り専用モードのまま停止しています。	データベースを再起動して、プライマリインスタンスを書き込みモードに戻します。
切り替えオペレーションは完了しましたが、Google Cloud コンソールにインスタンスの新しい入れ替え済みのロールが表示されません。	ブラウザを更新すると、更新されたトポロジが表示されます。
レプリカのフェイルオーバーオペレーションを実行できませんでした。	DR レプリカがプライマリインスタンス用に指定され、オンラインになっていることを確認します。 DR レプリカへのフェイルオーバーが失敗した場合、代わりに通常の（非 DR の）リードレプリカに昇格させます。
レプリケーションが行われていないかどうかを判断できません	レプリカに接続して、次のように入力します。 show slave status; レプリケーションが行われている場合は、最初の列の「`Slave_IO_State`」に「`Waiting for master to send event`」が表示され、`Last_IO_Error` フィールドは空になります。レプリケーションが行われていない場合、最初の列 `"Slave_IO_State"` に `"Connecting to master"` が表示されます。また、`"Last_IO_Error"` フィールドに `"error connecting to master 'cloudsqlreplica@x.x.x.x:3306"` のようなエラーが表示されます。 Cloud SQL モニタリングダッシュボードでレプリカのレプリケーションステータスを確認することもできます。詳細については、Cloud SQL インスタンスをモニタリングするをご覧ください。
次のエラーメッセージが表示されます。 `"Instance was converted into a replica between the target PITR time and the last available base backup. PITR logs are not available for the period instance was a replica. Please clone from the instance that was primary at time %s"`	インスタンスのレプリカへの切り替えが行われている期間は、PITR を実行できません。インスタンスがレプリカだった期間の PITR ログは使用できません。インスタンスのオペレーションのリストを調べ、その時点でインスタンスがレプリカであったかどうかを確認しますオペレーションのリストを使用して、その時点でプライマリインスタンスだったインスタンスを特定します。そのインスタンスのクローンを作成して PITR を実行します。
次のエラーメッセージが表示されます。 `"You can only designate a disaster recovery (DR) replica for primary instances that are storing their PITR logs in Cloud Storage. PITR logs of the instance %s are not stored in Cloud Storage"`	プライマリインスタンスは、まだトランザクションログの保存場所を Cloud Storage に切り替えていません。トランザクションログの保存場所が切り替わった後にもう一度試すか、別のプライマリインスタンスに DR レプリカを指定します。 PITR に使用されるトランザクションログの保存場所の移動について詳しくは、ポイントインタイムリカバリ（PITR）の使用をご覧ください。
次のエラーメッセージが表示されます。「`"The specified failover dr replica name REPLICA_NAME must be one of the replicas of the primary instance INSTANCE_NAME`」	プライマリインスタンスの DR レプリカを指定する場合は、プロジェクト ID または番号を指定してください。 DR レプリカの指定方法と正しいコマンド構文について詳しくは、プライマリインスタンスの DR レプリカを指定するをご覧ください。

次のステップ

データベースのオブザーバビリティについて確認する
Cloud SQL インスタンスをモニタリングする

高度な障害復旧（DR）を使用する

DR レプリカを指定する

始める前に

DR レプリカの要件

DR レプリカの推奨事項

DR レプリカの要件を満たすレプリカを作成する

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

プライマリ インスタンスの DR レプリカを指定する

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

DR レプリカの指定を変更する

コンソール

gcloud

REST

DR レプリカの指定を表示する

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

DR レプリカを削除する

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

切り替えを行う

始める前に

切り替えオペレーションを実行する

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

レプリカ フェイルオーバーを呼び出して DR を実行する

始める前に

レプリカのフェイルオーバー オペレーションを実行する

コンソール

プライマリインスタンスの DR レプリカを指定する

レプリカフェイルオーバーを呼び出して DR を実行する

レプリカのフェイルオーバーオペレーションを実行する

切り替えとレプリカフェイルオーバー中のインスタンスの PITR カバレッジ

レプリカのバックアップとトランザクションログの削除