Mengonfigurasi flag database instance

Untuk menyesuaikan parameter PostgreSQL, menyesuaikan opsi database, dan menyesuaikan perilaku instance di cluster AlloyDB untuk PostgreSQL, Anda dapat menambahkan, mengubah, atau menghapus flag database pada instance. Perubahan pada nilai flag database akan 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 target secara penuh.

Setelah Anda menetapkan, menghapus, atau mengubah flag untuk instance database, AlloyDB mungkin akan memulai ulang instance tersebut. Hal ini bergantung pada flag, seperti yang tercantum dalam Flag database yang didukung.

Saat mengubah flag database di instance utama atau instance kumpulan baca yang memerlukan mulai ulang, Anda dapat memilih salah satu kebijakan pemeliharaan berikut:

  • Waktu 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.

    Dengan mengaktifkan kebijakan periode nonaktif rendah, memperbarui flag yang memerlukan memulai ulang pada instance utama cluster Anda akan memiliki efek berikut:

    • Instance utama mengalami periode nonaktif kurang dari satu detik untuk sebagian besar workload.

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

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

    • Instance read pool tidak memerlukan periode nonaktif.

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

  • Penerapan paksa. Untuk menerapkan update flag 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, tetapi dengan konsekuensi periode nonaktif instance yang lebih lama dan penurunan sementara pada performa atau throughput database. Cluster Anda akan kembali ke performa puncak beberapa menit setelah menerapkan update flag secara paksa.

    Dengan mengaktifkan kebijakan penerapan paksa, memperbarui flag yang memerlukan memulai ulang pada instance utama cluster Anda akan memiliki 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 flag 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 dalam project Google Cloud yang Anda gunakan:
    • roles/alloydb.admin (peran IAM yang telah ditetapkan untuk Admin AlloyDB)
    • roles/owner (peran IAM dasar Pemilik)
    • roles/editor (peran IAM dasar Editor)

    Jika Anda tidak memiliki peran ini, hubungi Organization Administrator untuk meminta akses.

Untuk memastikan pemeliharaan dan update dapat membuat slot replikasi sementara untuk sinkronisasi status, pastikan jumlah total slot replikasi setidaknya satu lebih sedikit dari batas max_wal_senders. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi flag ini, lihat Mengonfigurasi instance sumber.

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Klik cluster di kolom Resource Name.

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

  4. Luaskan Advanced configuration options.

  5. Tambahkan, ubah, atau hapus flag database dari instance Anda:

    Menambahkan tanda

    1. Untuk menambahkan flag database ke instance, klik Add flag.
    2. Pilih flag database dari daftar New database flag.
    3. Berikan nilai untuk flag.
    4. Klik Done.

    Mengubah tanda

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

    Menghapus tanda

    1. Untuk menghapus flag database dari instance, pilih flag, lalu klik ikon hapus.
    2. Klik Done.

  6. 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 lebih cepat, sertakan argumen --update-mode=FORCE_APPLY. Karena hal ini dapat menurunkan 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 yang dipisahkan koma yang berisi satu atau beberapa spesifikasi flag database. Setiap spesifikasi terdiri dari nama flag, tanda sama dengan (=), dan nilai yang akan ditetapkan ke flag. Untuk flag database yang tidak mengambil nilai, berikan nama flag 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.

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

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