Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan pemulihan dari bencana (DR) lanjutan

MySQL | PostgreSQL | SQL Server

Halaman ini menjelaskan cara menggunakan pemulihan dari bencana (DR) lanjutan. DR Lanjutan menyediakan dua kemampuan utama:

Failover replika memungkinkan Anda melakukan failover instance utama ke replika DR segera jika terjadi kegagalan regional.
Switchover memungkinkan Anda membalikkan peran instance utama dan replika DR tanpa kehilangan data. Anda dapat menggunakan pengalihan untuk memulihkan deployment ke status deployment aslinya setelah failover replika, atau Anda dapat menggunakan pengalihan untuk menguji DR.

DR Lanjutan hanya didukung di instance edisi Cloud SQL Enterprise Plus.

Sebelum memulai

Jika berencana menggunakan Google Cloud SDK, Anda harus menggunakan versi 502.0.0 atau yang lebih baru. Untuk memeriksa versi Google Cloud SDK, jalankan gcloud --version. Untuk mengupdate Google Cloud SDK, jalankan gcloud components update.

Untuk menginstal Google Cloud SDK, lihat Menginstal gcloud CLI.

Persyaratan instance utama

Instance utama harus berupa instance edisi Cloud SQL Enterprise Plus dan memiliki replika DR yang ditetapkan.

Anda harus mengaktifkan pemulihan point-in-time (PITR) di instance utama. Untuk mengaktifkan PITR, lihat Menggunakan pemulihan point-in-time (PITR).

Jika Anda membuat instance Cloud SQL dengan endpoint tulis DNS (Pratinjau), instance utama Anda harus memiliki konfigurasi SSL yang sama dengan replika DR yang ditetapkan sebelum Anda memanggil operasi failover replika atau pengalihan. Misalnya, jika Anda mengonfigurasi replika DR untuk menerapkan enkripsi SSL, tetapi instance utama mengizinkan koneksi yang tidak dienkripsi, klien tidak akan dapat terhubung ke instance utama baru setelah operasi pengalihan atau failover selesai.

Persyaratan replika DR

Replika baca DR yang ditetapkan harus memenuhi persyaratan berikut:

Harus berupa instance edisi Cloud SQL Enterprise Plus
Tidak dapat dikonfigurasi untuk Private Service Connect; namun, replika baca DR dapat dikonfigurasi untuk akses layanan pribadi

Harus memiliki versi database yang sama dengan instance utama, yang menjalankan PostgreSQL 12, 13, 14, 15, atau 16

Harus berada di region terpisah dari instance utama
Harus berupa replika baca langsung; tidak boleh berupa replika bertingkat

Jika dikonfigurasi dengan tanda yang mewajibkan replika memiliki nilai yang lebih besar atau sama dengan instance utama, tanda tersebut harus dikonfigurasi dengan nilai yang sama dengan instance utama
Flag cloudsql.logical_decoding tidak dapat dikonfigurasi; slot logis atau replikasi logis tidak dapat dikonfigurasi

Harus menyimpan log transaksi yang digunakan untuk PITR di Cloud Storage
Tidak boleh berupa replika eksternal

Rekomendasi replika DR

Bagian ini memberikan rekomendasi untuk replika DR Anda. Rekomendasi berikut dapat membantu Anda menghindari masalah performa dalam deployment:

Gunakan ukuran disk yang sama dengan instance utama atau aktifkan pertumbuhan otomatis.
Gunakan konfigurasi HA yang konsisten. Jika Anda mengaktifkan HA di instance utama, aktifkan juga HA di replika DR.
Gunakan konfigurasi cache data yang konsisten. Jika Anda mengaktifkan cache data di instance utama, aktifkan juga cache data di replika DR.
Konfigurasikan flag database yang sesuai untuk replika DR Anda sebelum dan setelah operasi failover replika atau pengalihan.

Membuat replika untuk memenuhi persyaratan replika DR

Jika instance utama belum memiliki replika baca lintas region yang memenuhi persyaratan replika DR, buat replika tersebut.

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Temukan instance utama.
Di kolom Tindakan, klik menu Tindakan Lainnya.
Pilih Buat replika baca.
Di kolom Instance ID, masukkan nama untuk replika DR.
Di kolom Database version, versi utama instance utama yang sama akan dipilih untuk Anda.
Di bagian Pilih region dan ketersediaan zona pada halaman, lakukan hal berikut:
- Pilih region yang _berbeda_ dengan region instance utama Anda.
- Opsional. Pilih Beberapa zona untuk replika DR.
- Opsional. Pilih Zona primer dan Zona sekunder untuk replika DR.
Di bagian Customize your instance pada halaman, Anda dapat memperbarui setelan untuk replika DR. Untuk mengetahui detail selengkapnya tentang setiap setelan, lihat halaman Tentang setelan instance.
Untuk Bentuk mesin, pilih jenis mesin yang sama dengan instance utama Anda.
Untuk Flag, konfigurasikan flag yang diperlukan untuk database Anda.
Klik Buat replika.

Cloud SQL membuat cadangan instance utama dan membuat replika. Anda akan dikembalikan ke halaman instance untuk instance utama.

gcloud

Untuk membuat replika yang memenuhi persyaratan replika DR, jalankan perintah berikut:

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"

Ganti variabel berikut:

REPLICA_NAME: nama replika DR.
PRIMARY_INSTANCE_NAME: nama instance utama.
REPLICA_REGION_NAME: menentukan region yang berbeda dengan region instance utama.
DATABASE_VERSION: tentukan string versi yang cocok dengan versi utama dan minor database dari instance utama, misalnya POSTGRES_16.
Versi utama dan minor database harus sama untuk replika utama dan DR.
MACHINE_TYPE: menentukan jenis mesin yang sama dengan instance utama. Sebaiknya jenis mesin cocok dengan jenis mesin instance utama.
AVAILABILITY_TYPE: jika instance utama dikonfigurasi untuk ketersediaan tinggi, sebaiknya tentukan REGIONAL untuk mengaktifkan ketersediaan tinggi.
EDITION: tentukan ENTERPRISE_PLUS.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PRIMARY_INSTANCE_NAME: nama instance utama.
PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
String versi DATABASE_VERSION: yang cocok dengan versi database instance utama, misalnya POSTGRES_16. Versi database harus sama untuk replika utama dan replika DR.
REPLICA_NAME: nama instance replika DR yang Anda buat.
REPLICA_REGION: region instance replika DR. Region replika harus berbeda dengan region instance utama.
MACHINE_TYPE: menentukan jenis mesin yang sama dengan instance utama. Sebaiknya pilih jenis mesin yang sama dengan instance utama.
AVAILABILITY_TYPE: jika instance utama dikonfigurasi untuk ketersediaan tinggi, sebaiknya tentukan REGIONAL untuk mengaktifkan ketersediaan tinggi.

Metode HTTP dan URL:

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

Meminta isi 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",
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PRIMARY_INSTANCE_NAME: nama instance utama.
PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
String versi DATABASE_VERSION: yang cocok dengan versi database instance utama, misalnya POSTGRES_16. Versi database harus sama untuk replika utama dan replika DR.
REPLICA_NAME: nama instance replika DR yang Anda buat.
REPLICA_REGION: region instance replika DR. Region replika harus berbeda dengan region instance utama.
MACHINE_TYPE: menentukan jenis mesin yang sama dengan instance utama. Sebaiknya ukuran disk cocok dengan ukuran disk instance utama.
AVAILABILITY_TYPE: jika instance utama dikonfigurasi untuk ketersediaan tinggi, sebaiknya tentukan REGIONAL untuk mengaktifkan ketersediaan tinggi.

Metode HTTP dan URL:

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

Meminta isi 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",
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Menetapkan replika DR untuk instance utama

Prosedur berikut menjelaskan cara menetapkan salah satu replika lintas-region dari instance utama sebagai replika DR untuk pengalihan atau replika failover.

Konsol

Untuk menetapkan replika DR untuk instance utama, lakukan hal berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Cari dan pilih instance utama. Halaman Ringkasan untuk instance utama akan muncul.
Di menu navigasi, klik Replicas.
Dalam daftar replika baca, temukan replika baca lintas region yang ingin Anda tetapkan sebagai replika DR.
Untuk replika, klik tombol more_vert Actions, lalu pilih Designate as DR replica.
Klik Konfirmasi.

gcloud

Untuk menetapkan replika DR ke instance utama, gunakan perintah berikut:

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

Ganti variabel berikut:

PRIMARY_INSTANCE_NAME: nama instance utama.
REPLICA_NAME: nama replika DR.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PRIMARY_INSTANCE_NAME: nama instance utama.
REPLICA_NAME: nama replika DR.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PRIMARY_INSTANCE_NAME: nama instance utama.
REPLICA_NAME: nama replika DR.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Mengubah penetapan replika DR

Jika replika memenuhi persyaratan, Anda dapat menetapkan replika lain sebagai replika DR. Replika DR lama kehilangan penetapan replika DR.

Konsol

Untuk mengubah replika DR untuk instance utama, lakukan hal berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Cari dan pilih instance utama. Halaman Ringkasan untuk instance utama akan muncul.
Di menu navigasi, klik Replicas.
Dalam daftar replika baca, temukan replika baca lintas region yang ingin Anda tetapkan sebagai replika DR baru.
Untuk replika, klik tombol more_vert Actions, lalu pilih Designate as DR replica.

gcloud

Untuk mengubah replika DR, jalankan perintah penetapan lagi, dan tentukan replika DR yang berbeda.

REST

Untuk mengubah replika DR, buat permintaan API penetapan lagi, dan tentukan replika DR yang berbeda.

Melihat penetapan replika DR

Anda dapat memeriksa replika DR mana yang ditetapkan ke instance utama menggunakan gcloud CLI atau Cloud SQL Admin API. Anda juga dapat memeriksa apakah replika adalah replika DR yang ditetapkan.

Untuk mengetahui replika DR yang ditetapkan untuk instance utama, gunakan prosedur berikut.

Konsol

Untuk mengetahui replika baca mana yang merupakan replika DR yang ditetapkan untuk instance utama, lakukan tindakan berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Cari dan pilih instance utama. Halaman Ringkasan untuk instance utama akan muncul.
Di menu navigasi, klik Replicas.
Dalam daftar replika baca, pastikan PostgreSQL disaster recovery replica muncul di kolom Jenis untuk replika DR yang ditetapkan.

gcloud

Untuk mengetahui instance mana yang merupakan replika DR yang ditetapkan dari instance utama, gunakan perintah berikut:

gcloud sql instances describe PRIMARY_INSTANCE_NAME

Ganti variabel berikut:

PRIMARY_INSTANCE_NAME: nama instance utama

Output perintah ini berisi kolom bernama failoverDrReplica yang mengidentifikasi replika DR yang ditetapkan.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
PRIMARY_INSTANCE_NAME: nama instance utama.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
PRIMARY_INSTANCE_NAME: nama instance utama.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Untuk memeriksa apakah replika adalah replika DR, gunakan salah satu prosedur berikut.

Konsol

Untuk memeriksa apakah instance replika adalah replika DR, lakukan tindakan berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Temukan instance replika.
Pastikan PostgreSQL disaster recovery replica muncul di kolom Type untuk replika DR yang ditetapkan.

gcloud

Untuk memeriksa apakah instance replika adalah replika DR, jalankan perintah berikut:

gcloud sql instances describe REPLICA_NAME

Ganti variabel berikut:

REPLICA_NAME: nama replika baca yang ingin Anda periksa

Jika replika adalah replika DR, output perintah akan berisi kolom drReplica=true.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
REPLICA_NAME: nama replika.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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

PowerShell (Windows)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
REPLICA_NAME: nama replika.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Menghapus replika DR

Anda dapat menghapus penetapan replika DR dari instance utama. Namun, jika replika DR tidak ditetapkan ke instance utama, Anda tidak dapat melakukan pengalihan atau failover replika.

Konsol

Untuk menghapus replika DR yang ditetapkan dari instance utama, lakukan tindakan berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Cari dan pilih instance utama. Halaman Ringkasan untuk instance utama akan muncul.
Di menu navigasi, klik Replicas.
Dalam daftar replika baca, temukan replika baca lintas region yang ingin Anda hapus.
Untuk replika, klik tombol more_vert Actions, lalu pilih Remove as DR replica.
Klik Konfirmasi.

gcloud

Untuk menghapus penetapan replika DR, jalankan perintah berikut pada instance utama:

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

Ganti variabel berikut:

PRIMARY_INSTANCE_NAME: nama instance utama tempat Anda ingin menghapus replika DR yang ditetapkan

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
PRIMARY_INSTANCE_NAME: nama instance utama.
Tetapkan kolom failoverDrReplicaName ke string kosong.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
PRIMARY_INSTANCE_NAME: nama instance utama.
Tetapkan kolom failoverDrReplicaName ke string kosong.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Melakukan pengalihan

Setelah menetapkan replika DR, Anda dapat melakukan operasi pengalihan. Namun, sebagai praktik terbaik, hindari melakukan operasi pengalihan dalam keadaan berikut:

Instance utama sedang digunakan secara aktif.
Operasi admin sedang berlangsung, seperti pencadangan otomatis atau pengaktifan atau penonaktifan ketersediaan tinggi (HA).

Untuk menghindari waktu tunggu habis, pertimbangkan untuk melakukan pengalihan saat volume transaksi rendah.

Saat pengalihan selesai, operasi akan mengambil cadangan instance utama baru (replika DR sebelumnya) segera setelah instance utama baru dipromosikan. Setelah pencadangan ini selesai, pemulihan point-in-time (PITR) akan diaktifkan sepenuhnya di instance utama baru. Pencadangan ini dapat memerlukan waktu antara 5 hingga 15 menit untuk diselesaikan, bergantung pada ukuran disk. Cakupan PITR hanya dimulai setelah pencadangan ini selesai. Untuk mengetahui informasi selengkapnya tentang pertimbangan penggunaan PITR dengan DR lanjutan, lihat Menggunakan PITR dengan DR lanjutan.

Setelah operasi pengalihan selesai, Anda akan melihat bahwa arah replika dibalik.

Setelah instance utama lama Anda dikonfigurasi ulang sebagai replika baca, endpoint tulis DNS, yang sebelumnya me-resolve ke instance utama lama, akan me-resolve ke instance utama baru.

Sebelum memulai

Sebelum Anda melakukan operasi pengalihan, lakukan hal berikut:

Menentukan replika DR. Anda hanya dapat melakukan pengalihan antara instance utama dan replika DR yang ditetapkan.
Verifikasi bahwa instance utama dan replika DR sedang online.
Pastikan PITR diaktifkan di instance utama. Untuk mengaktifkan PITR, lihat Menggunakan pemulihan point-in-time (PITR).
Jika Anda menggunakan endpoint operasi tulis DNS, pastikan konfigurasi SSL untuk instance utama dan replika DR sama. Misalnya, jika replika DR dikonfigurasi untuk menerapkan enkripsi SSL, tetapi instance utama mengizinkan koneksi yang tidak dienkripsi, klien tidak akan dapat terhubung ke instance utama baru setelah operasi pengalihan selesai.
Buat cadangan instance utama sesuai permintaan. Pencadangan ini adalah tindakan pengamanan jika Anda perlu memulihkan dari kegagalan yang tidak terduga.

Melakukan operasi pengalihan

Konsol

Untuk melakukan operasi pengalihan, lakukan hal berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Temukan replika DR yang ditetapkan untuk instance utama.
Klik instance replika DR. Halaman Ringkasan untuk replika DR akan muncul.
Klik tombol Switchover.
Di halaman Lakukan pengalihan antara replika utama dan DR, masukkan nama instance utama di kolom Instance ID.
Klik Penggantian.

gcloud

Untuk melakukan operasi pengalihan, jalankan perintah berikut:

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

Ganti variabel berikut:

REPLICA_NAME: nama replika DR yang ditetapkan yang ingin Anda jadikan sebagai peran instance utama.
TIMEOUT_DURATION: opsional. periode waktu tunggu untuk memungkinkan penyelesaian operasi database pada instance.

Jika Anda tidak menentukan parameter ini, operasi pengalihan akan menyertakan waktu tunggu 10 menit.

Anda dapat meningkatkan nilai waktu tunggu ini dengan menentukan parameter --db-timeout. Ganti TIMEOUT_DURATION dengan durasi jangka waktu hingga 24 jam, termasuk notasi awal untuk format. Misalnya, untuk 30 detik, tentukan 30s. Untuk 24 jam, tentukan 24h. Anda juga dapat menentukan satuan pecahan jangka waktu dengan menggunakan desimal hingga 9 tempat. Misalnya, untuk 30,5 menit, tentukan 30.5m.

Jika tidak memiliki operasi yang tertunda, Anda dapat mengurangi nilai waktu tunggu ini.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
REPLICA_NAME: nama replika DR.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
REPLICA_NAME: nama replika DR.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Melakukan DR dengan memanggil failover replika

Jika terjadi kegagalan regional atau bencana, Anda dapat melakukan DR dengan memanggil operasi failover replika ke replika DR yang ditetapkan. Untuk melakukan replika replika, Anda mempromosikan replika DR yang ditetapkan. Berbeda dengan pengalihan, promosi replika DR bersifat langsung.

Karena replika DR langsung mengambil peran instance utama, replika mungkin tidak memiliki semua data dari instance utama lama karena jeda replikasi. Karena alasan ini, failover replika dapat menyebabkan hilangnya data.

Sebagai bagian dari proses promosi, failover replika mengambil cadangan instance utama baru (replika DR sebelumnya) tepat setelah replika DR menjadi instance utama baru. Setelah pencadangan ini selesai, pemulihan point-in-time (PITR) diaktifkan sepenuhnya di instance utama baru. Pencadangan ini dapat memerlukan waktu antara 5 dan 15 menit untuk selesai, bergantung pada ukuran disk instance utama baru (dan lama). Selama periode pencadangan ini, PITR tidak tersedia.

Saat instance utama lama kembali online, proses failover replika akan mengambil cadangan. Setelah pencadangan ini diambil, instance utama lama akan dibuat ulang sebagai replika baca dari instance utama baru.

Untuk mengetahui informasi selengkapnya tentang pertimbangan penggunaan PITR dengan DR lanjutan, lihat Menggunakan PITR dengan DR lanjutan.

Setelah Anda memanggil operasi failover replika, endpoint tulis DNS, yang sebelumnya me-resolve ke instance utama lama, akan me-resolve ke instance utama baru.

Sebelum memulai

Sebelum Anda dapat melakukan failover replika, lakukan hal berikut:

Jika Anda belum melakukannya, tentukan replika DR. Anda hanya dapat melakukan failover replika antara instance utama dan replika DR yang ditetapkan.
Pastikan replika DR online dan responsif.

Melakukan operasi failover replika

Konsol

Untuk melakukan operasi failover replika, lakukan hal berikut:

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Klik instance replika DR. Halaman Ringkasan untuk replika DR akan muncul.
Klik tombol Replica Failover.
Di halaman Lakukan failover replika antara replika primer dan DR, masukkan nama instance primer di kolom Instance ID untuk mengonfirmasi bahwa Anda ingin melanjutkan operasi.
Untuk memulai failover replika, klik Failover Replika.

gcloud

Untuk memanggil failover replika ke replika DR, gunakan perintah berikut:

gcloud sql instances promote-replica \
   REPLICA_NAME --failover

Ganti variabel berikut:

REPLICA_NAME: nama replika DR

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
REPLICA_NAME: nama replika DR.
ENABLE_REPLICA_FAILOVER: tetapkan ke true untuk menggunakan failover replika. Jika Anda menetapkan ke false, API akan menggunakan metode promoteReplica reguler tanpa failover replika.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Tanggapan

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud dari instance utama dan replika DR.
REPLICA_NAME: nama replika DR.
ENABLE_REPLICA_FAILOVER: tetapkan ke true untuk menggunakan failover replika. Jika Anda menetapkan ke false, API akan menggunakan metode promoteReplica reguler tanpa failover replika.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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)

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Respons

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

Memeriksa status failover replika

Failover replika terjadi dalam dua fase. Fase pertama adalah promosi replika DR. Fase kedua adalah pembuatan ulang instance utama lama sebagai replika baca.

Untuk memeriksa status failover replika, periksa status setiap fase.

Periksa status fase pertama.
Konsol

Untuk memeriksa apakah replika DR telah dipromosikan ke instance mandiri, lakukan hal berikut:
1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.
  
  Buka Instance Cloud SQL
2. Temukan nama replika DR yang Anda promosikan.
3. Pastikan PostgreSQL VERSION muncul di kolom Type untuk instance utama baru.
gcloud
Anda dapat memeriksa status dengan menjalankan perintah berikut:
```
gcloud sql instances describe DR_REPLICA_NAME
```
Ganti variabel berikut:
- DR_REPLICA_NAME: nama replika DR yang dipromosikan
Dalam output, pastikan kolom berikut muncul dan replika telah menjadi instance utama Cloud SQL mandiri:
```
instanceType: CLOUD_SQL_INSTANCE
```
Untuk memverifikasi penyelesaian fase kedua, periksa log operasi di instance untuk pesan RECONFIGURE_OLD_PRIMARY.

Munculnya pesan ini bergantung pada waktu instance primer lama kembali online, yang dapat memerlukan waktu beberapa menit atau hari jika terjadi bencana.

Untuk mengetahui informasi selengkapnya tentang cara memeriksa log operasi di instance, lihat Melihat log instance.

Menggunakan PITR dengan DR lanjutan

Dengan pengalihan dan failover replika, segera setelah replika DR dipromosikan ke instance utama, perubahan berikut akan terjadi untuk mendukung pencadangan dan PITR:

Konfigurasi pencadangan, termasuk penjadwalan pencadangan otomatis, dikopi dari instance utama lama ke instance utama baru.

Cadangan baru diambil untuk mendukung PITR di instance utama baru.
Kebijakan retensi log transaksi disalin dari instance utama lama ke instance utama baru.

Untuk konfigurasi pencadangan dan kebijakan retensi log transaksi, sebaiknya Anda memverifikasi bahwa setelan yang diwarisi dari instance utama lama sudah benar untuk instance utama baru.

Awal cakupan PITR

Di akhir operasi pengalihan, Cloud SQL menjadwalkan cadangan otomatis dan mengambil cadangan pertama dari instance utama baru. Jika Anda ingin cakupan PITR dimulai lebih awal, sebaiknya verifikasi bahwa pencadangan pertama berhasil. Instance utama yang baru dipromosikan hanya memiliki cakupan PITR setelah pencadangan otomatis pertama berhasil selesai.

Untuk mengetahui informasi selengkapnya tentang cara melihat cadangan yang tersedia untuk instance, lihat Melihat daftar cadangan.

Cakupan PITR untuk instance selama switchover dan failover replika

Saat instance berpartisipasi dalam operasi failover replika atau pengalihan, instance akan menghabiskan waktu sebagai replika baca. PITR dan pemulihan cadangan didukung selama jangka waktu yang dihabiskan instance sebagai replika baca dan sebagai instance utama.

Anda dapat melakukan PITR ke waktu sebelum pengalihan saat instance adalah instance utama. Untuk operasi pengalihan dan failover replika, Cloud SQL memulai pencadangan dengan upaya terbaik untuk instance utama baru segera setelah instance utama baru dipromosikan. PITR diaktifkan di instance yang dipromosikan hanya setelah pencadangan ini selesai. Pencadangan ini dapat memerlukan waktu 5 hingga 15 menit untuk diselesaikan, bergantung pada ukuran disk.

Split-brain selama failover replika

Split-brain mungkin terjadi saat instance utama terus menerima operasi tulis saat replika dipromosikan menggunakan failover replika. Setelah replika dipromosikan, saat instance utama lama tersedia lagi, instance tersebut akan di-build ulang sebagai replika instance yang dipromosikan dan cadangan akhir akan dibuat. Cadangan ini dapat digunakan untuk memulihkan data split-brain yang tidak ditulis ke replika yang dipromosikan.

Penghapusan cadangan dan log transaksi di replika

Jika instance utama yang diaktifkan dengan PITR dan pencadangan menjadi replika baca, kebijakan retensi PITR dan cadangan terakhir dari waktunya sebagai instance utama akan dipertahankan dan diterapkan selama waktunya sebagai replika. Meskipun instance utama baru tidak membuat cadangan, cadangan lama dan log transaksi yang digunakan untuk PITR akan dihapus di replika baca sesuai dengan kebijakan yang terakhir dikonfigurasi.

Misalnya, jika instance dikonfigurasi untuk memiliki pencadangan otomatis harian dan menyimpan 7 pencadangan dengan log PITR 7 hari, maka saat instance ini menjadi replika baca, semua yang lebih lama dari 7 hari akan dihapus sekali sehari.

Jika perlu menghapus cadangan lebih cepat, Anda dapat menghapus cadangan secara manual. Untuk mengetahui informasi selengkapnya, lihat Menghapus cadangan.

Batasan

DR Lanjutan tidak didukung untuk instance Cloud SQL yang menggunakan Private Service Connect. DR Lanjutan mendukung akses layanan pribadi.
Anda tidak dapat menetapkan instance replika baca edisi Cloud SQL Enterprise Plus sebagai replika DR jika instance utama menyimpan log transaksinya untuk pemulihan point-in-time (PITR) di disk. Untuk memeriksa tempat instance menyimpan lognya untuk PITR, lihat Memeriksa lokasi penyimpanan log transaksi yang digunakan untuk PITR.
Anda tidak dapat menetapkan replika eksternal sebagai replika DR.
Terraform tidak didukung untuk operasi failover replika atau pengalihan.

DR Lanjutan tidak didukung untuk PostgreSQL 17.

Memecahkan masalah

Masalah	Pemecahan masalah
Operasi pengalihan gagal.	Periksa volume transaksi di database. Jika volume transaksi tinggi, operasi mungkin akan habis waktu tunggunya. Pertimbangkan untuk mencoba kembali operasi saat beban transaksi lebih rendah.
Operasi pengalihan telah gagal dan instance utama macet dalam mode hanya baca.	Lakukan mulai ulang database untuk mengembalikan instance utama ke mode tulis.
Operasi pengalihan telah selesai, tetapi konsol Google Cloud tidak menampilkan peran baru yang dibalik untuk instance.	Muat ulang browser untuk menampilkan topologi yang diperbarui.
Operasi failover replika telah gagal.	Jika failover ke replika DR gagal, promosikan ke replika baca reguler (non-DR).

Langkah selanjutnya

Baca tentang kemampuan observasi database
Memantau instance Cloud SQL