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 mengubah flag untuk instance database, AlloyDB mungkin memulai ulang instance. Hal ini bergantung pada flag, seperti yang tercantum dalam Flag database yang didukung.

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

  • Periode nonaktif rendah. 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.

    • Flag 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 read pool tidak memerlukan periode nonaktif.

    • Setelah sekitar 10 menit, tanda pada instance kumpulan baca selesai diperbarui ke nilai barunya.

  • 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, tetapi sebagai gantinya, instance akan mengalami periode nonaktif yang lebih lama dan penurunan performa atau throughput database untuk sementara. 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 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 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 flag database dari instance Anda:

    Menambahkan tanda

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

    Mengubah tanda

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

    Menghapus tanda

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

  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. sedang menjalani siklus pemeliharaan dengan waktu henti rendah atau nol, setelah Anda mengubah flag database.

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

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