Mengonfigurasi parameter database AlloyDB Omni

Pilih versi dokumentasi:

Untuk mengonfigurasi parameter database untuk AlloyDB Omni, Anda dapat memperbarui parameter Konfigurasi Terpadu Besar (GUC) di salah satu hal berikut:

  • File postgresql.conf untuk lingkungan yang menjalankan AlloyDB Omni di VM.

  • Manifes cluster database untuk lingkungan yang menjalankan AlloyDB Omni di cluster Kubernetes.

Memperbarui parameter di AlloyDB Omni yang di-container

Di AlloyDB Omni yang berjalan di VM, Anda dapat memperbarui parameter dengan mengedit file postgresql.conf sebagai berikut:

  1. Cari file konfigurasi postgresql.conf untuk penginstalan AlloyDB Omni Anda.

  2. Gunakan editor teks untuk menambahkan atau memperbarui flag database di postgresql.conf.

    Misalnya, untuk menerapkan masa berlaku sandi, tetapkan tanda berikut dalam file postgresql.conf:

    password.enforce_expiration = ON

  3. Setelah tanda database ditambahkan atau diedit, muat ulang postgresql.conf file agar perubahan diterapkan. Misalnya, jika Anda menginstal AlloyDB Omni menggunakan Docker, jalankan perintah berikut untuk memulai ulang instance Docker dan memuat ulang postgresql.conf:

    docker restart CONTAINER-NAME

Untuk mengetahui informasi selengkapnya, lihat Menetapkan parameter dalam dokumentasi PostgreSQL.

Memperbarui parameter di AlloyDB Omni pada cluster Kubernetes

Anda dapat mengonfigurasi parameter database menggunakan kolom parameters di bagian primarySpec manifes cluster database:

spec:
  primarySpec:
    parameters:
      "PARAMETER_NAME": "PARAMETER_VALUE"
      ...

Ganti kode berikut:

  • PARAMETER_NAME: nama parameter—misalnya, autovacuum.
  • PARAMETER_VALUE: nilai parameter—misalnya, off.

Beberapa parameter mengharuskan Anda memulai ulang cluster agar perubahan diterapkan. Anda dapat memperoleh daftar parameter yang memerlukan mulai ulang dari pg_catalog.pg_settings. Parameter apa pun dengan pg_catalog.pg_settings.context = 'postmaster' memerlukan mulai ulang.

Untuk mengupdate parameter database, jalankan perintah berikut:

kubectl patch dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -p '{"spec":{"primarySpec":{"parameters": {"PARAMETER_NAME": "PARAMETER_VALUE"}}}}' --type=merge

Setelan parameter berada di bagian status pada kolom currentParameters.

Untuk melihat parameter database, jalankan perintah berikut:

kubectl get dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -o jsonpath={.status.primary.currentParameters}

Outputnya terlihat mirip dengan yang berikut ini:

{"autovacuum":"off","max_connections":"3000"}

Jika AlloyDB Omni tidak dapat menerapkan parameter yang Anda minta dalam manifes cluster database, nilai untuk kolom currentParameters dapat berbeda dengan nilai di kolom parameters pada manifes Anda. Misalnya, Anda menerapkan parameter yang tidak ada atau menetapkan nilai string ke parameter bilangan bulat.