Halaman ini menjelaskan cara menambahkan flag database untuk instance, mengubah flag database, dan menghapus flag database dari instance di cluster AlloyDB untuk PostgreSQL.
Anda dapat menggunakan flag database untuk berbagai macam operasi, seperti menyesuaikan parameter PostgreSQL, menyesuaikan opsi, serta mengonfigurasi dan melakukan tuning pada sebuah 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 yang diinginkan secara penuh.
Setelah Anda menetapkan, menghapus, atau mengubah flag untuk instance database, AlloyDB mungkin memulai ulang instance. Hal ini bergantung pada flag, seperti yang tercantum dalam Flag database yang didukung.
Saat memodifikasi flag database di instance utama atau kumpulan operasi baca yang perlu dimulai ulang, Anda dapat memilih salah satu kebijakan pemeliharaan berikut:
Periode nonaktif yang rendah. 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 tanda yang memerlukan dimulai ulang di instance utama cluster Anda akan memiliki efek berikut:
Instance utama mengalami downtime kurang dari satu detik untuk sebagian besar workload.
Tanda pada instance utama selesai diperbarui ke nilai barunya setelah sekitar 15 menit.
Memperbarui flag yang memerlukan mulai ulang pada instance kumpulan operasi baca akan memiliki efek berikut:
Instance kumpulan operasi baca tidak memerlukan periode nonaktif.
Flag pada instance kumpulan operasi baca selesai diupdate ke nilai barunya setelah sekitar 10 menit.
Paksa terapkan. Untuk menerapkan pembaruan flag dengan lebih cepat, gunakan opsi
FORCE_APPLY
dengan perintahgcloud beta alloydb instances update
.Kebijakan ini lebih sesuai untuk lingkungan pengembangan, yang memungkinkan Anda menambahkan atau mengubah flag dengan cepat sebagai ganti waktu nonaktif instance yang lebih lama dan penurunan sementara performa atau throughput database. Cluster Anda akan kembali ke performa puncak beberapa menit setelah memaksakan penerapan update flag.
Dengan mengaktifkan kebijakan penerapan paksa, memperbarui flag yang memerlukan mulai ulang pada instance utama cluster Anda akan memiliki efek berikut:
Instance utama mengalami periode nonaktif selama 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 operasi baca memiliki efek berikut:
Instance kumpulan baca mengalami periode nonaktif selama sekitar satu menit.
Flag pada instance kumpulan operasi baca selesai diupdate ke nilai barunya setelah satu atau dua menit.
Sebelum memulai
- Project Google Cloud yang Anda gunakan harus telah diaktifkan untuk mengakses AlloyDB.
- Anda harus memiliki salah satu peran IAM berikut di project Google Cloud yang Anda gunakan:
roles/alloydb.admin
(peran IAM bawaan AlloyDB Admin)roles/owner
(peran IAM dasar Pemilik)roles/editor
(peran IAM dasar Editor)
Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi untuk meminta akses.
Di konsol Google Cloud, buka halaman Clusters.
Klik cluster di kolom Resource Name.
Di halaman Ringkasan, buka Instance in your cluster, pilih instance, lalu klik Edit.
Menambahkan, mengubah, atau menghapus flag database dari instance Anda:
Menambahkan tanda
- Untuk menambahkan flag database ke instance, klik Add flag.
- Pilih flag dari daftar Flag database baru.
- Berikan nilai untuk flag.
- Klik Done.
Mengubah tanda
- Untuk mengubah flag database yang ada di instance Anda, luaskan flag database dan ubah nilai flag yang ada di bagian Edit database flag.
- Klik Done.
Menghapus tanda
- Untuk menghapus tanda database dari instance Anda, pilih tanda, lalu klik ikon hapus.
- Klik Done.
Klik Update instance.
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 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 dari 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 menggunakan nilai, berikan nama flag 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. mengalami siklus pemeliharaan downtime rendah atau nol, setelah Anda mengubah flag database.
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