Mengonfigurasi flag database instance

Halaman ini menjelaskan cara menambahkan flag database untuk instance, mengubah flag database, dan menghapus flag database dari instance dalam cluster AlloyDB untuk PostgreSQL.

Anda menggunakan flag database untuk banyak operasi, termasuk menyesuaikan parameter PostgreSQL, menyesuaikan opsi, serta mengonfigurasi dan melakukan tuning pada sebuah instance. Perubahan pada nilai flag database tetap ada untuk instance-nya hingga Anda menghapus flag atau mengubah nilainya lagi.

Dalam beberapa kasus, menyetel sebuah flag mungkin akan mengharuskan Anda menyetel flag lain untuk mengaktifkan fungsionalitas yang diinginkan secara penuh.

Setelah Anda menyetel, menghapus, atau memodifikasi flag untuk sebuah instance database, AlloyDB mungkin akan memulai ulang instance tersebut. Hal ini bergantung pada flag, seperti yang tercantum di Flag database yang didukung.

Saat Anda mengubah tanda database di instance utama atau kumpulan baca yang perlu dimulai ulang, Anda dapat memilih salah satu kebijakan pemeliharaan berikut:

  • Periode nonaktif yang singkat. Kebijakan ini diaktifkan secara default. Sebaiknya gunakan kebijakan ini untuk semua cluster AlloyDB produksi Anda karena kebijakan ini meminimalkan periode nonaktif aplikasi.

    Jika kebijakan periode nonaktif rendah diaktifkan, memperbarui tanda yang memerlukan mulai ulang pada instance utama cluster Anda akan memberikan efek berikut:

    • Instance utama mengalami waktu nonaktif kurang dari satu detik untuk sebagian besar beban kerja.

    • Tanda pada instance utama selesai diperbarui ke nilai barunya setelah sekitar 15 menit.

    Memperbarui tanda yang memerlukan mulai ulang pada instance kumpulan baca memiliki efek berikut:

    • Instance kumpulan baca tidak memerlukan periode nonaktif.

    • Flag pada instance kumpulan baca selesai diperbarui ke nilai barunya setelah sekitar 10 menit.

  • Terapkan paksa. Untuk menerapkan update flag dengan lebih cepat, gunakan opsi FORCE_APPLY dengan perintah gcloud beta alloydb instances update.

    Kebijakan ini lebih sesuai untuk lingkungan pengembangan, sehingga Anda dapat menambahkan atau mengubah flag dengan cepat dengan imbalan waktu nonaktif instance yang lebih lama dan penurunan sementara performa atau throughput database. Cluster Anda akan kembali ke performa puncak beberapa menit setelah menerapkan pembaruan flag secara paksa.

    Dengan kebijakan penerapan paksa diaktifkan, memperbarui tanda yang memerlukan mulai ulang pada instance utama cluster Anda akan memberikan efek berikut:

    • Instance utama mengalami periode nonaktif sekitar satu menit.

    • Flag pada instance utama selesai diperbarui ke nilai barunya setelah satu atau dua menit.

    Memperbarui tanda yang memerlukan mulai ulang pada instance kumpulan baca memiliki efek berikut:

    • Instance kumpulan baca mengalami periode nonaktif sekitar satu menit.

    • Flag pada instance kumpulan baca selesai diperbarui ke nilai barunya setelah satu atau dua menit.

Sebelum memulai

  • Project Google Cloud yang Anda gunakan harus sudah diaktifkan untuk mengakses AlloyDB.
  • Anda harus memiliki salah satu peran IAM ini di Google Cloud project yang Anda gunakan:
    • roles/alloydb.admin (peran IAM bawaan Admin AlloyDB)
    • roles/owner (peran IAM dasar Pemilik)
    • roles/editor (peran IAM dasar Editor)

    Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi Anda untuk meminta akses.

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Klik cluster di kolom Nama Resource.

  3. Di halaman Overview, buka Instances in your cluster, pilih instance, lalu klik Edit.

  4. Menambahkan, mengubah, atau menghapus tanda database dari instance Anda:

    Menambahkan tanda

    1. Untuk menambahkan tanda database ke instance Anda, klik Tambahkan tanda.
    2. Pilih tanda dari daftar Tanda database baru.
    3. Berikan nilai untuk tanda.
    4. Klik Selesai.

    Mengubah tanda

    1. Untuk mengubah flag database yang ada di instance Anda, luaskan flag database dan ubah nilai flag yang ada di bagian Edit flag database.
    2. Klik Selesai.

    Menghapus tanda

    1. Untuk menghapus tanda database dari instance Anda, pilih tanda, lalu klik ikon hapus.
    2. Klik Selesai.

  5. Klik Update instance.

gcloud

Gunakan perintah gcloud alloydb instances update untuk mengubah flag database untuk instance.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

Untuk menerapkan update flag dengan lebih cepat, sertakan argumen --update-mode=FORCE_APPLY. Karena hal ini dapat mengurangi performa database untuk sementara, hindari penggunaan opsi ini di lingkungan produksi.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

Ganti kode berikut:

  • INSTANCE_ID: ID instance.
  • FLAGS_LIST: Daftar spesifikasi tanda database yang dipisahkan koma. Setiap spesifikasi terdiri dari nama tanda, tanda sama dengan (=), dan nilai yang akan ditetapkan ke tanda. Untuk tanda database yang tidak menggunakan nilai, berikan nama tanda yang diikuti dengan tanda sama dengan (=).
  • REGION_ID: Region tempat instance ditempatkan—misalnya, us-central1.
  • CLUSTER_ID: ID cluster tempat instance ditempatkan.
  • PROJECT_ID: ID project tempat cluster ditempatkan. menjalani siklus pemeliharaan dengan waktu henti rendah atau nol, setelah Anda mengubah flag database.

Untuk melihat daftar flag yang saat ini ditetapkan secara manual untuk instance, jalankan perintah berikut:

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID