Mengonfigurasi parameter database AlloyDB Omni

Pilih versi dokumentasi:

Untuk mengonfigurasi parameter database untuk AlloyDB Omni, Anda dapat memperbarui parameter Grand Unified Configuration (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 dalam container

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

  1. Temukan 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 flag berikut dalam file postgresql.conf:

    password.enforce_expiration = ON

  3. Setelah flag database ditambahkan atau diedit, muat ulang file postgresql.conf 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 di 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 memperbarui 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 terletak di bagian status kolom currentParameters.

Untuk melihat parameter database, jalankan perintah berikut:

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

Outputnya akan terlihat mirip seperti berikut:

{"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 manifes Anda. Misalnya, Anda menerapkan parameter yang tidak ada atau menetapkan nilai string ke parameter bilangan bulat.