Mengaktifkan dan menonaktifkan ketersediaan tinggi

Halaman ini menjelaskan cara mengonfigurasi instance untuk ketersediaan tinggi.

Anda dapat mengonfigurasi instance untuk ketersediaan tinggi saat membuat instance, atau Anda dapat mengaktifkan ketersediaan tinggi pada instance yang sudah ada.

Untuk informasi selengkapnya tentang ketersediaan tinggi, lihat Ringkasan konfigurasi ketersediaan tinggi.

Membuat instance baru yang dikonfigurasi untuk ketersediaan tinggi

Saat Anda membuat instance dan mengonfigurasinya untuk Cloud SQL akan membuatnya sebagai instance regional.

Untuk membuat instance yang dikonfigurasi untuk ketersediaan tinggi:

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Pilih Create instance.
  3. Pilih mesin database.
  4. Pada bagian Pilih ketersediaan region dan zona, pilih Beberapa zona (Ketersediaan tinggi).
  5. Luaskan Specify zones.
  6. Pilih zona primer dan sekunder. Kondisi berikut berlaku jika zona sekunder merupakan zona yang digunakan selama pembuatan atau pengeditan instance:
    • Zona secara default ditetapkan ke zona primer Any dan Any (different from primary) untuk zona sekunder.

      • Jika zona primer dan sekunder sudah ditentukan, maka kedua zona tersebut pasti merupakan zona yang berbeda.

  7. Klik Save.

    Anda akan dikembalikan ke halaman instance untuk instance utama sementara instance tersebut sedang diperbarui.

gcloud

  1. Buat instance regional: 
    gcloud sql instances create REGIONAL_INSTANCE_NAME \
--availability-type=REGIONAL \
--database-version=DATABASE_VERSION \
--cpu=NUMBER_CPUS \
--memory=MEMORY_SIZE
     Untuk mengetahui daftar lengkap parameter yang tersedia, lihat halaman referensi membuat instance gcloud sql.
  2. Konfigurasi pengguna root: 
    gcloud sql users set-password root no-host \
--instance=REGIONAL_INSTANCE_NAME \
--password=PASSWORD

Terraform

Untuk membuat instance dengan ketersediaan tinggi, gunakan resource Terraform. 

resource "google_sql_database_instance" "postgres_instance_ha" {
  name             = "postgres-instance-ha"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier              = "db-custom-2-7680"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled                        = true
      point_in_time_recovery_enabled = true
      start_time                     = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Menerapkan perubahan

Untuk menerapkan konfigurasi Terraform di project Google Cloud, selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

  1. Luncurkan Cloud Shell.

  2. Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

    Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

  1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

    Salin kode contoh ke dalam main.tf yang baru dibuat.

    Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

  3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
  4. Simpan perubahan Anda.
  5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori. 
    terraform init

    Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade: 

    terraform init -upgrade

Menerapkan perubahan

  1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan: 
    terraform plan

    Koreksi konfigurasi jika diperlukan.

  2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt: 
    terraform apply

    Tunggu hingga Terraform menampilkan pesan "Apply complete!".

  3. Buka project Google Cloud Anda untuk melihat hasilnya. Di Konsol Google Cloud, buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Menghapus perubahan

Untuk menghapus perubahan Anda, lakukan langkah-langkah berikut:

  1. Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false. 
    deletion_protection =  "false"
  2. Terapkan konfigurasi Terraform terbaru dengan menjalankan perintah berikut dan memasukkan yes pada perintah: 
    terraform apply

  1. Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

    terraform destroy

REST v1

Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instances:insert.

Membuat instance regional.

  1. Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • project-id: ID Project
    • instance-name: Nama instance
    • database-version: String enum versi database
    • region Region GCP
    • machine-type Jenis mesin

    Metode HTTP dan URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

    Meminta isi JSON: 

    {
  "name": "instance-name",
  "region": "region",
  "databaseVersion": "database-version",
   "settings": {
     "tier": "machine-type",
     "backupConfiguration": {
         "enabled": true,
         "pointInTimeRecoveryEnabled": true
      },
      "availabilityType": "REGIONAL"
   }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

  2. Setelah instance selesai melakukan inisialisasi, update sandi root pada instance:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • project-id: ID project
    • instance-id: ID instance
    • password: Sandi pengguna root yang baru

    Metode HTTP dan URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=postgres'

    Meminta isi JSON: 

    {
   "name": "postgres",
   "host": "nohost",
   "password": "password"}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

REST v1beta4

Untuk mengetahui daftar lengkap parameter permintaan (request), lihat halaman instances:insert.

Membuat instance regional.

  1. Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • project-id: ID Project
    • instance-name: Nama instance
    • database-version: String enum versi database
    • region Region GCP
    • machine-type Jenis mesin

    Metode HTTP dan URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

    Meminta isi JSON: 

    {
  "name": "instance-name",
  "region": "region",
  "databaseVersion": "database-version",
   "settings": {
     "tier": "machine-type",
     "backupConfiguration": {
         "enabled": true,
         "pointInTimeRecoveryEnabled": true
      },
      "availabilityType": "REGIONAL"
   }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

  2. Setelah instance selesai melakukan inisialisasi, update sandi root pada instance:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • project-id: ID project
    • instance-id: ID instance
    • password: Sandi pengguna root yang baru

    Metode HTTP dan URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=postgres'

    Meminta isi JSON: 

    {
   "name": "postgres",
   "host": "nohost",
   "password": "password"}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan menerima kode status berhasil (2xx) dan suatu respons kosong.

Untuk detail selengkapnya tentang cara membuat instance, lihat Membuat Instance.

Mengonfigurasi instance yang sudah ada untuk ketersediaan tinggi

Anda dapat mengonfigurasi instance Cloud SQL untuk ketersediaan tinggi dengan menggunakan Konsol Google Cloud, gcloud CLI, atau API.

Konsol

Guna mengonfigurasi instance untuk ketersediaan tinggi:

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Klik Edit.
  4. Di bagian opsi konfigurasi Pencadangan dan ketersediaan tinggi otomatis, pilih Ketersediaan tinggi (region). Sebaiknya, Anda juga mengaktifkan Otomatisasi pencadangan.
  5. Klik Save.

gcloud

Untuk mengonfigurasi instance agar menjadi instance regional yang memiliki ketersediaan tinggi, gunakan perintah gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type REGIONAL

Ganti INSTANCE_NAME dengan nama instance Cloud SQL yang Anda konfigurasi untuk ketersediaan tinggi.

REST v1

Untuk mengonfigurasi instance agar menjadi instance regional dengan ketersediaan tinggi:

  1. Periksa instance untuk melihat apakah pencadangan otomatis dan pemulihan point-in-time diaktifkan. Ini diperlukan bagi setiap instance dengan ketersediaan tinggi.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

    Pada outputnya, akan terdapat bagian yang mirip seperti berikut ini:

      "backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": true,
    "pointInTimeRecoveryEnabled": true
    }

  2. Jika enabled atau pointInTimeRecoveryEnabled adalah false, gunakan metode instances:patch untuk mengaktifkan keduanya. Untuk mengaktifkan pencadangan, tetapkan enabled ke true dan startTime ke sebuah nilai yang merupakan awal dari jendela pencadangan. Untuk mengaktifkan logging biner, tetapkan pointInTimeRecoveryEnabled ke true.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance replika utama atau baca yang Anda konfigurasi untuk ketersediaan tinggi
    • START_TIME: waktu (dalam jam dan menit)

    Metode HTTP dan URL: 

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

    Meminta isi JSON: 

    {
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

  3. Konfigurasikan instance ini untuk menjadi instance regional dengan ketersediaan tinggi:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

    Metode HTTP dan URL: 

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

    Meminta isi JSON: 

    {
  "settings": {"availabilityType": "REGIONAL" }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

REST v1beta4

Untuk mengonfigurasi instance agar menjadi instance regional dengan ketersediaan tinggi:

  1. Periksa instance untuk melihat apakah pencadangan otomatis dan pemulihan point-in-time diaktifkan. Ini diperlukan bagi setiap instance dengan ketersediaan tinggi.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
}

    Pada outputnya, akan terdapat bagian yang mirip seperti berikut ini:

      "backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": true,
    "pointInTimeRecoveryEnabled": true
    }

  2. Jika enabled atau pointInTimeRecoveryEnabled adalah false, gunakan metode instances:patch untuk mengaktifkan keduanya. Untuk mengaktifkan pencadangan, tetapkan enabled ke true dan startTime ke sebuah nilai yang merupakan awal dari jendela pencadangan. Untuk mengaktifkan logging biner, tetapkan pointInTimeRecoveryEnabled ke true.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance replika utama atau baca yang Anda konfigurasi untuk ketersediaan tinggi
    • START_TIME: waktu (dalam jam dan menit)

    Metode HTTP dan URL: 

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

    Meminta isi JSON: 

    {
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

  3. Konfigurasikan instance ini untuk menjadi instance regional dengan ketersediaan tinggi:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

    Metode HTTP dan URL: 

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

    Meminta isi JSON: 

    {
  "settings": {"availabilityType": "REGIONAL" }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

Memulai failover

Pengujian failover bersifat opsional, tetapi sebaiknya Anda lakukan agar dapat melihat respons aplikasi jika terjadi failover.

Untuk mempelajari tentang failover lebih lanjut, lihat Ringkasan failover.

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Klik Failover.
  4. Pada kotak dialog Picu failover secara manual, masukkan ID instance Anda di kolom teks, lalu klik Picu Failover.

gcloud

Memulai failover:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

  1. Tentukan instance utama untuk mendapatkan nilai dari kolom settingsVersion.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip seperti berikut:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}
  2. Memulai failover:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • project-id: ID Project
    • instance-name: Nama instance
    • settings-version: settingsVersion dari instanceInfo

    Metode HTTP dan URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover

    Meminta isi JSON: 

    {
  "failoverContext":
     {
        "settingsVersion":"settings-version"
     }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

REST v1beta4

  1. Tentukan instance utama untuk mendapatkan nilai dari kolom settingsVersion.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
    • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

    Metode HTTP dan URL: 

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

    Untuk mengirim permintaan, perluas salah satu opsi berikut:

    Anda akan menerima respons JSON yang mirip seperti berikut:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}
  2. Memulai failover:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • project-id: ID Project
    • instance-name: Nama instance
    • settings-version: settingsVersion dari instanceInfo

    Metode HTTP dan URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover

    Meminta isi JSON: 

    {
  "failoverContext":
     {
        "settingsVersion":"settings-version"
     }
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan melihat respons JSON seperti berikut:

Instance akan mengalami kegagalan (failover) sementara dan tidak dapat menyajikan data selama beberapa menit.

Memverifikasi konfigurasi ketersediaan tinggi pada instance

Untuk memverifikasi bahwa sebuah instance memiliki ketersediaan tinggi dan untuk melihat zona-zona tempat instance berjalan:

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Pastikan setelan ketersediaan tinggi berikut ditampilkan di bagian Konfigurasi:
    • Sangat tersedia (regional)
    • Berlokasi di menampilkan zona primer instance saat ini.

gcloud

gcloud sql instances describe INSTANCE_NAME

Outputnya akan menunjukkan bahwa availabilityType adalah REGIONAL. Kolom gceZone dan secondaryGceZone menampilkan zona primer dan sekunder saat ini dari instance tersebut.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

Outputnya akan menunjukkan bahwa availabilityType adalah REGIONAL. Kolom gceZone dan secondaryGceZone menampilkan zona primer dan sekunder saat ini dari instance tersebut.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
}

Outputnya akan menunjukkan bahwa availabilityType adalah REGIONAL. Kolom gceZone dan secondaryGceZone menampilkan zona primer dan sekunder saat ini dari instance tersebut.

Mengubah zona instance ketersediaan tinggi

Mengubah salah satu atau kedua zona dari instance ketersediaan tinggi yang sudah ada akan menyebabkan periode nonaktif selama beberapa menit saat instance dikonfigurasi ulang. Untuk melihat zona primer dan sekunder saat ini, yang mana tempat instance ketersediaan tinggi dijalankan, lihat Memverifikasi konfigurasi ketersediaan tinggi sebuah instance.

Untuk mengubah zona instance ketersediaan tinggi:

Konsol

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Klik Edit.
  4. Di bagian Pilih ketersediaan region dan zona, luaskan Tentukan zona lalu pilih zona baru. Zona secara default ditetapkan ke Any untuk zona primer dan Any (different from primary) untuk zona sekunder. Berikut adalah beberapa aturan yang berlaku:
    • Anda dapat menentukan hanya zona primer saja, atau zona primer dan sekunder.
    • Jika zona primer dan sekunder ditentukan, kedua zona tersebut harus berbeda.
  5. Klik Save.

    Anda akan dikembalikan ke halaman instance untuk instance utama sementara instance tersebut sedang diperbarui.

gcloud

Ubah zona tempat instance berjalan:

gcloud sql instances patch INSTANCE_NAME \
  --zone=PRIMARY_ZONE --secondary-zone=SECONDARY_ZONE

Parameter --secondary-zone bersifat opsional. Jika Anda menghapusnya, Cloud SQL akan memilih zona tersedia yang berbeda dari zona primer.

Berlaku batasan berikut:

  • Zona harus berupa zona yang valid dari region yang sama dengan instance Cloud SQL.
  • Jika zona sekunder ditentukan, maka harus berbeda dari zona primer.

REST v1

  1. Ubah zona instance regional:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID Project
    • INSTANCE_NAME: Nama instance
    • PRIMARY_ZONE: Zona primer
    • SECONDARY_ZONE: Zona sekunder

    Metode HTTP dan URL: 

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

    Meminta isi JSON: 

    {
"settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

    Parameter secondaryZone bersifat opsional. Jika Anda menghapusnya, Cloud SQL akan memilih zona tersedia yang berbeda dari zona primer.

    Berlaku batasan berikut:

    • Zona harus berupa zona yang valid.
    • Zona apa pun yang Anda pilih harus berada di region yang sama dengan instance Cloud SQL.

REST v1beta4

  1. Ubah zona instance regional:

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID Project
    • INSTANCE_NAME: Nama instance
    • PRIMARY_ZONE: Zona primer
    • SECONDARY_ZONE: Zona sekunder

    Metode HTTP dan URL: 

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

    Meminta isi JSON: 

    {
"settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
}

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

    Parameter secondaryZone bersifat opsional. Jika Anda menghapusnya, Cloud SQL akan memilih zona tersedia yang berbeda dari zona primer.

    Berlaku batasan berikut:

    • Zona harus berupa zona yang valid.
    • Zona apa pun yang Anda pilih harus berada di region yang sama dengan instance Cloud SQL.

Menonaktifkan ketersediaan tinggi untuk sebuah instance

Anda dapat menonaktifkan ketersediaan tinggi untuk instance Cloud SQL dengan menggunakan Konsol Google Cloud, gcloud CLI, atau API.

Konsol

Untuk menonaktifkan ketersediaan tinggi suatu instance:

  1. Di konsol Google Cloud, buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Klik Edit.
  4. Buka Pencadangan otomatis.
  5. Di bagian Availability, klik Single zone.
  6. Klik Save. Pengeditan ini mengharuskan Anda memulai ulang instance.
  7. Saat dialog muncul, klik Simpan dan mulai ulang.

gcloud

Untuk menonaktifkan ketersediaan tinggi untuk suatu instance, gunakan perintah gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type ZONAL

Ganti INSTANCE_NAME dengan nama instance Cloud SQL yang ketersediaan tingginya ingin Anda nonaktifkan.

REST v1

Untuk mengubah jenis ketersediaan instance menjadi ZONAL, gunakan metode instances:patch. Metode ini menonaktifkan ketersediaan tinggi untuk instance.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • INSTANCE_NAME: nama instance yang ketersediaan tingginya Anda nonaktifkan

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {"availabilityType": "ZONAL" }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

REST v1beta4

Untuk mengubah jenis ketersediaan instance menjadi ZONAL, gunakan metode instances:patch. Metode ini menonaktifkan ketersediaan tinggi untuk instance.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
  • INSTANCE_NAME: nama instance yang ketersediaan tingginya Anda nonaktifkan

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "settings": {"availabilityType": "ZONAL" }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

Memecahkan masalah

Masalah Pemecahan masalah
Anda tidak dapat menemukan metrik untuk failover manual. Hanya failover otomatis yang masuk ke metrik.
Penggunaan resource instance Cloud SQL (CPU dan RAM) mendekati 100%, sehingga instance ketersediaan tinggi mengalami gangguan. Ukuran mesin instance terlalu kecil untuk beban tersebut.

Edit instance untuk mengupgrade ke ukuran mesin yang lebih besar agar mendapatkan lebih banyak CPU dan memori.

Langkah selanjutnya