Mengaktifkan dan menonaktifkan ketersediaan tinggi

MySQL   |  PostgreSQL   |  SQL Server

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.

Konfigurasi lama (legacy) untuk ketersediaan tinggi sebelumnya menggunakan instance failover replica. Namun, konfigurasi yang baru tidak menggunakan failover replica. Sebagai gantinya, konfigurasi baru menggunakan persistent disk regional Google, yang mereplikasi data secara sinkron pada tingkat blok di antara kedua zona dalam satu region. Jika Anda memiliki instance MySQL yang masih menggunakan konfigurasi ketersediaan tinggi yang lama, Anda dapat mengupdate konfigurasi untuk menggunakan versi terkini. Untuk prosedur lain terkait konfigurasi ketersediaan tinggi yang lama, lihat Konfigurasi lama untuk ketersediaan tinggi.

Catatan: Cloud SQL berencana akan menghentikan dukungan untuk instance dengan ketersediaan tinggi (high availability [HA]) yang lama di masa mendatang dan akan segera mengumumkan tanggal penghentiannya. Saat ini, instance HA yang lama masih tercakup di SLA Cloud SQL. Kami merekomendasikan Anda untuk mengupgrade instance HA yang lama ke instance HA persistent disk regional dan buat instance baru menggunakan HA persistent disk regional sesegera mungkin.

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 \
   --tier=MACHINE_TYPE \
   --enable-bin-log
   

   Untuk mengetahui daftar lengkap parameter yang tersedia, baca halaman referensi gcloud sql instances create.
2. Anda dapat menentukan zona primer dan sekunder menggunakan parameter --zone dan --secondary-zone. Beberapa aturan berikut berlaku jika zona sekunder adalah yang digunakan selama pembuatan atau pengeditan instance:
   • Zona yang dipilih harus berupa zona yang valid.
   • Jika zona sekunder ditentukan, maka zona primer juga harus ditentukan.
   • Jika zona primer dan sekunder ditentukan, maka kedua zona tersebut harus berbeda.
   • Jika zona primer dan sekunder ditentukan, maka kedua zona tersebut harus berada di region yang sama.
3. Konfigurasikan pengguna root:

   gcloud sql users set-password root --host=% \
   --instance=PRIMARY_INSTANCE_NAME \
   --password=PASSWORD
   

Terraform

Untuk membuat instance dengan ketersediaan tinggi, gunakan resource Terraform.

resource "google_sql_database_instance" "mysql_instance_ha" {
  name             = "mysql-instance-ha"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier              = "db-f1-micro"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled            = true
      binary_log_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.

Catatan: Contoh Terraform biasanya mengasumsikan bahwa API yang diperlukan diaktifkan di project Google Cloud Anda.

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

3. 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": {
            "binaryLogEnabled": true,
            "enabled": true
         },
         "availabilityType": "REGIONAL"
      }
   }
   

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 melihat respons JSON seperti berikut:

   Tanggapan

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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?name=root&host=%25'

   Meminta isi JSON:

   {
      "name": "root",
      "host": "%",
      "password": "password"}
   

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

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

   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/instance-id/users?name=root&host=%25'"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=root&host=%25'" | Select-Object -Expand Content

   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": {
            "binaryLogEnabled": true,
            "enabled": true
         },
         "availabilityType": "REGIONAL"
      }
   }
   

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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/sql/v1beta4/projects/project-id/instances"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   Tanggapan

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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?name=root&host=%25'

   Meminta isi JSON:

   {
      "name": "root",
      "host": "%",
      "password": "password"}
   

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

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

   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/instance-id/users?name=root&host=%25'"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25'" | Select-Object -Expand Content

   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.

Catatan: Setelah memulai konfigurasi ketersediaan tinggi untuk suatu instance, Anda tidak dapat menghentikannya. Jika mengonfigurasi ulang, instance akan memulai ulang instance tersebut. Biasanya hanya diperlukan waktu beberapa menit bagi Cloud SQL untuk mengonfigurasi ulang instance dan memulai ulang instance tersebut. Namun, jika instance memiliki disk atau muatan yang besar, mungkin perlu waktu hingga satu jam.

Konsol

Penting: Anda tidak dapat menggunakan konsol Google Cloud untuk mengonfigurasi instance yang telah mengaktifkan Private Service Connect untuk ketersediaan tinggi. Untuk mengonfigurasi instance ini, gunakan gcloud CLI atau API.

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. Pada bagian Pilih ketersediaan region dan zona, pilih Zona majemuk (Ketersediaan tinggi).
5. Luaskan Specify zones.
6. Pilih zona primer dan sekunder. Kondisi berikut berlaku jika Anda menggunakan zona sekunder saat membuat atau mengedit instance:
   • Zona secara default ditetapkan ke zona primer Any dan Any (different from primary) untuk zona sekunder.

   Jika Anda menentukan zona utama dan sekunder, keduanya harus berada di zona yang berbeda.

7. 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 \
--enable-bin-log \
--backup-start-time=HH:MM

Lakukan penggantian berikut:

• INSTANCE_NAME: nama instance Cloud SQL yang Anda konfigurasi untuk ketersediaan tinggi
• HH:MM: waktu (dalam jam dan menit)

REST v1

Untuk mengonfigurasi instance agar menjadi instance regional dengan ketersediaan tinggi:

1. Periksa instance untuk melihat apakah pencadangan otomatis dan log biner 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:

   curl (Linux, macOS, atau Cloud Shell)

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

   Jalankan perintah berikut:

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

   PowerShell (Windows)

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

   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/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

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

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

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

2. Jika enabled atau binaryLogEnabled 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 binaryLogEnabled 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,
         "binaryLogEnabled": true
       }
     }
   }
   

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

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

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

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   Respons

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

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:

   curl (Linux, macOS, atau Cloud Shell)

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

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

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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 log biner 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:

   curl (Linux, macOS, atau Cloud Shell)

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

   Jalankan perintah berikut:

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

   PowerShell (Windows)

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

   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/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

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

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

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

2. Jika enabled atau binaryLogEnabled 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 binaryLogEnabled 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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   Meminta isi JSON:

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

   Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

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

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

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   Respons

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

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:

   curl (Linux, macOS, atau Cloud Shell)

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

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

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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.

Fitur ini akan membantu Anda menguji respons aplikasi terhadap failover otomatis. Pastikan instance Anda telah menyelesaikan failover sebelumnya (sehingga instance akan merespons permintaan koneksi) sebelum Anda memicu failover yang lain. Selain itu, sebelum memulai failover untuk instance Anda, konfigurasikan instance untuk ketersediaan tinggi terlebih dahulu.

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:

   curl (Linux, macOS, atau Cloud Shell)

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

   Jalankan perintah berikut:

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

   PowerShell (Windows)

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

   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/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan menerima respons JSON yang mirip seperti berikut:

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

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:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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/instance-name/failover"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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/instance-name/failover" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   Tanggapan

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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:

   curl (Linux, macOS, atau Cloud Shell)

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

   Jalankan perintah berikut:

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

   PowerShell (Windows)

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

   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/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan menerima respons JSON yang mirip seperti berikut:

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

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:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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/sql/v1beta4/projects/project-id/instances/instance-name/failover"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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/sql/v1beta4/projects/project-id/instances/instance-name/failover" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   Respons

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

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.

Ketersediaan tinggi yang baru tidak menggunakan replika failover yang lama. Anda tidak akan melihat replika failover di dalam daftar instance kecuali jika Anda menggunakan konfigurasi lama.

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

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/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

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

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:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

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

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/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

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

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.

Catatan: Setelah memulai operasi perubahan zona pada sebuah instance, Anda tidak dapat menghentikannya. Operasi ini akan memulai ulang instance tersebut. Biasanya, hanya diperlukan beberapa menit untuk konfigurasi dan proses mulai ulang selesai. Namun, jika instance tersebut memiliki disk atau muatan yang besar, mungkin perlu beberapa waktu hingga satu jam.

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:

   curl (Linux, macOS, atau Cloud Shell)

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

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

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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:

   curl (Linux, macOS, atau Cloud Shell)

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

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

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   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.

Catatan: Sebelum Anda melakukan prosedur ini, pastikan tidak ada operasi yang berjalan pada instance.

Konsol

Penting: Anda tidak dapat menggunakan Konsol Google Cloud untuk menonaktifkan ketersediaan tinggi untuk instance yang mengaktifkan Private Service Connect. Untuk menonaktifkan instance ini, gunakan gcloud CLI atau API.

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:

curl (Linux, macOS, atau Cloud Shell)

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

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

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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:

curl (Linux, macOS, atau Cloud Shell)

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

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

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

• Pelajari lebih lanjut cara kerja konfigurasi ketersediaan tinggi.
• Uji bagaimana aplikasi Anda merespons ke koneksi yang terputus dengan memulai ulang instance Anda.
• Pelajari lebih lanjut cara mengelola koneksi database.
• Pelajari Kemampuan Observasi Google Cloud lebih lanjut.
• Pelajari lebih lanjut tentang Konfigurasi lama untuk ketersediaan tinggi.
• Buat replika baca untuk instance Anda.