このページは Cloud Translation API によって翻訳されました。

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

MySQL | PostgreSQL | SQL Server

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

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

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

始める前に

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

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

プライマリインスタンスの要件

プライマリインスタンスは Cloud SQL Enterprise Plus エディションのインスタンスで、指定された DR レプリカが必要です。

プライマリインスタンスでポイントインタイムリカバリ（PITR）を有効にする必要があります。PITR を有効にするには、ポイントインタイムリカバリ（PITR）を使用するをご覧ください。

DNS 書き込みエンドポイント（プレビュー）を使用して Cloud SQL インスタンスを作成する場合は、切り替えまたはレプリカフェイルオーバーオペレーションを呼び出す前に、プライマリインスタンスに指定された DR レプリカと同じ SSL 構成が必要です。たとえば、SSL 暗号化を適用するように DR レプリカを構成しても、プライマリインスタンスで暗号化されていない接続が許可されている場合、切り替えまたはフェイルオーバーオペレーションの完了後にクライアントは新しいプライマリインスタンスに接続できなくなります。

DR レプリカの要件

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

Cloud SQL Enterprise Plus エディションインスタンスである
Private Service Connect 用に構成することはできませんが、DR 読み取りレプリカはプライベートサービスアクセス用に構成できます。

プライマリインスタンスと同じデータベースバージョンで、PostgreSQL 12、13、14、15、16 を実行している

プライマリインスタンスとは別のリージョンに存在している
直接のリードレプリカである。カスケードレプリカにすることはできない

レプリカの値がプライマリインスタンスの値以上である必要があるフラグで構成されている場合は、プライマリインスタンスと同じ値でフラグを構成する必要があります。
cloudsql.logical_decoding フラグを構成できない。論理スロットや論理レプリケーションを構成できない

PITR に使用されるトランザクションログを Cloud Storage に保存する
外部レプリカではない

DR レプリカの推奨事項

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

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

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

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

コンソール

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

Cloud SQL の [インスタンス] に移動
プライマリインスタンスを見つけます。
[アクション] 列で、[その他の操作] メニューをクリックします。
[リードレプリカを作成] を選択します。
[インスタンス ID] フィールドに、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: プライマリインスタンスのデータベースのメジャーバージョンとマイナーバージョンに一致するバージョン文字列を指定します（例: POSTGRES_16）。
データベースのメジャーバージョンとマイナーバージョンは、プライマリレプリカと DR レプリカの両方において同じである必要があります。
MACHINE_TYPE: プライマリインスタンスと同じマシンタイプを指定します。マシンタイプは、プライマリインスタンスのマシンタイプと一致させることをおすすめします。
AVAILABILITY_TYPE: プライマリインスタンスが高可用性用に構成されている場合は、高可用性を有効にするために REGIONAL を指定することをおすすめします。
EDITION: ENTERPRISE_PLUS を指定します。

REST v1

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

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
DATABASE_VERSION: バージョン文字列。プライマリインスタンスのデータベースバージョンに一致する必要があります（例: POSTGRES_16）。データベースバージョンは、プライマリレプリカと 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_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
PROJECT_ID: プライマリインスタンスと DR レプリカの Google Cloud プロジェクトの ID またはプロジェクト番号。
DATABASE_VERSION: バージョン文字列。プライマリインスタンスのデータベースバージョンに一致する必要があります（例: POSTGRES_16）。データベースバージョンは、プライマリレプリカと 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 sql instances patch PRIMARY_INSTANCE_NAME \
   --failover-dr-replica-name=REPLICA_NAME

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

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
REPLICA_NAME: DR レプリカの名前。

REST v1

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

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
REPLICA_NAME: DR レプリカの名前。

HTTP メソッドと URL:

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

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

{
  "replicationCluster": {
     "failoverDrReplicaName": "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

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

PRIMARY_INSTANCE_NAME: プライマリインスタンスの名前。
REPLICA_NAME: DR レプリカの名前。

HTTP メソッドと URL:

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

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

{
  "replicationCluster": {
     "failoverDrReplicaName": "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/sql/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/sql/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 レプリカの [タイプ] 列に PostgreSQL disaster recovery replica が表示されていることを確認します。

gcloud

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

gcloud 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": "POSTGRES_16",
  "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": "POSTGRES_16",
  "maintenanceVersion": "POSTGRES_16_3.R20240205.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": "POSTGRES_16",
  "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": "POSTGRES_16",
  "maintenanceVersion": "POSTGRES_16_3.R20240205.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 レプリカの [タイプ] 列に PostgreSQL disaster recovery replica が表示されていることを確認します。

gcloud

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

gcloud 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": "POSTGRES_16",
  "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": "POSTGRES_16",
  "maintenanceVersion": "POSTGRES_16_3.R20240205.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/sql/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/sql/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/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME" | Select-Object -Expand Content

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

レスポンス

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_16",
  "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": "POSTGRES_16",
  "maintenanceVersion": "POSTGRES_16_3.R20240205.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 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/sql/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/sql/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/sql/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 レプリカを指定したら、切り替えオペレーションを実行できます。ただし、ベストプラクティスとして、次の状況では切り替えオペレーションを行わないことをおすすめします。

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

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

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

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

古いプライマリインスタンスがリードレプリカとして再構成されると、以前は古いプライマリインスタンスに解決されていた DNS 書き込みエンドポイントが新しいプライマリインスタンスに解決されます。

始める前に

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

DR レプリカを指定する。プライマリインスタンスと指定された DR レプリカの間でのみ、切り替えを実行できます。
プライマリインスタンスと DR レプリカがオンラインであることを確認する。
プライマリインスタンスで PITR が有効になっていることを確認します。PITR を有効にするには、ポイントインタイムリカバリ（PITR）を使用するをご覧ください。
DNS 書き込みエンドポイントを使用している場合は、プライマリインスタンスと DR レプリカの SSL 構成が同じであることを確認します。たとえば、DR レプリカが SSL 暗号化を適用するように構成されていても、プライマリインスタンスが暗号化されていない接続を許可している場合、切り替えオペレーションの完了後にクライアントは新しいプライマリインスタンスに接続できなくなります。
プライマリインスタンスのオンデマンドバックアップを取得する。このバックアップは、予期しない障害から復旧する必要がある場合に備えて行います。

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

コンソール

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

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

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

gcloud

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

gcloud 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/sql/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/sql/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/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_NAME/switchover" | Select-Object -Expand Content

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

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/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/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

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

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

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

古いプライマリインスタンスがオンラインに戻ると、レプリカのフェイルオーバープロセスがバックアップを取得します。このバックアップが取得された後、古いプライマリインスタンスは新しいプライマリインスタンスのリードレプリカとして再作成されます。

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

レプリカのフェイルオーバーオペレーションを呼び出すと、以前は古いプライマリインスタンスに解決されていた DNS 書き込みエンドポイントが新しいプライマリインスタンスに解決されます。

始める前に

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

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

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

コンソール

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

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

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

gcloud

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

gcloud 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/sql/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/sql/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/sql/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/sql/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/sql/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. 新しいプライマリインスタンスの [タイプ] 列に PostgreSQL VERSION が表示されていることを確認します。
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 のカバレッジ開始

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

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

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

切り替えまたはレプリカのフェイルオーバーオペレーションに参加する場合、インスタンスはリードレプリカとなります。PITR とバックアップの復元は、インスタンスがリードレプリカとプライマリインスタンスとして使用されている期間にサポートされます。

インスタンスがプライマリインスタンスだった切り替え前の時点に PITR を実行できます。切り替えオペレーションとレプリカフェイルオーバーオペレーションの両方で、新しいプライマリインスタンスが昇格するとすぐに、Cloud SQL は新しいプライマリインスタンスのベストエフォートバックアップを開始します。PITR は、このバックアップが完了した後にのみ、昇格したインスタンスで有効になります。このバックアップは、ディスクサイズによって完了までに 5 ～ 15 分かかることがあります。

レプリカフェイルオーバー中のスプリットブレイン

レプリカフェイルオーバーを使用してレプリカが昇格されているときに、プライマリインスタンスが書き込みを引き続き受け入れると、スプリットブレインが発生することがあります。レプリカが昇格された後で、古いプライマリインスタンスが再び使用可能になると、古いプライマリインスタンスが昇格されたインスタンスのレプリカとして再ビルドされ、最終的なバックアップが作成されます。このバックアップを使用して、昇格されたレプリカに書き込まれなかったスプリットブレインデータを復元できます。

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

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

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

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

制限事項

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

高度な DR は PostgreSQL 17 ではサポートされていません。

トラブルシューティング

問題	トラブルシューティング
切り替えオペレーションが失敗しました。	データベースのトランザクション量を確認します。トランザクションの量が多いと、オペレーションがタイムアウトする可能性があります。トランザクションの負荷が少ないときにオペレーションを再試行することを検討してください。
切り替えオペレーションが失敗し、プライマリインスタンスが読み取り専用モードのまま停止しています。	データベースを再起動して、プライマリインスタンスを書き込みモードに戻します。
切り替えオペレーションは完了しましたが、Google Cloud コンソールにインスタンスの新しい入れ替え済みのロールが表示されません。	ブラウザを更新すると、更新されたトポロジが表示されます。
レプリカのフェイルオーバーオペレーションを実行できませんでした。	DR レプリカへのフェイルオーバーが失敗した場合、代わりに通常の（非 DR の）リードレプリカにプロモートします。

次のステップ

世界中のロケーションで利用可能なすべての Google Cloud Platform サービスを確認する。
データベースのオブザーバビリティについて確認する
Cloud SQL インスタンスをモニタリングする

高度な障害復旧（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 カバレッジ

レプリカフェイルオーバー中のスプリットブレイン

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