Mengonfigurasi parameter database

Pilih versi dokumentasi:

Halaman ini menjelaskan cara mengonfigurasi parameter database menggunakan orchestrator RPM AlloyDB Omni.

Parameter database, yang juga dikenal sebagai parameter Grand Unified Configuration (GUC), memungkinkan Anda menyesuaikan performa dan perilaku cluster database AlloyDB Omni. Untuk mengetahui informasi selengkapnya, lihat Menetapkan parameter dalam dokumentasi PostgreSQL.

Sebelum memulai

Sebelum mengonfigurasi parameter database, pastikan Anda telah:

  1. Menginstal the orchestrator AlloyDB Omni.
  2. Menyediakan dan membuat cluster AlloyDB Omni.

Mengonfigurasi parameter database

Untuk mengonfigurasi parameter database, Anda menggunakan kolom parameters dalam bagian primarySpec dari spesifikasi resource DBCluster.

Memperbarui spesifikasi resource

Tambahkan atau ubah parameter yang diperlukan dan nilainya dalam spesifikasi resource DBCluster. Anda dapat melakukannya untuk mengonfigurasi parameter selama pembuatan cluster atau untuk memperbarui parameter setelah cluster dibuat.

Cuplikan berikut menunjukkan contoh parameter GUC. Anda dapat mengonfigurasi parameter database lain yang didukung dengan cara yang sama:

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

Ganti kode berikut:

  • CLUSTER_NAME: nama cluster database Anda.
  • MAX_WAL_SIZE: contoh parameter yang mengontrol ukuran maksimum WAL yang dapat bertambah di antara checkpoint WAL otomatis, misalnya 2GB.
  • MAX_CONNECTIONS_LIMIT: contoh parameter yang mengontrol jumlah maksimum koneksi serentak yang diizinkan ke server database, misalnya, 200. Nilai minimum yang didukung adalah 50.
  • HUGE_PAGES: contoh parameter yang mengontrol penggunaan halaman besar, misalnya on.
  • LOG_STATEMENT: contoh parameter yang mengontrol pernyataan SQL mana yang dicatat, misalnya all.

Menerapkan konfigurasi

Terapkan perubahan menggunakan antarmuka orchestrator pilihan Anda.

Ansible

Jika Anda mengelola infrastruktur orchestrator RPM AlloyDB Omni secara langsung menggunakan Ansible, tindakan ini akan memicu pembaruan dengan menjalankan playbook yang sesuai dan meneruskan update_action yang dipilih sebagai variabel tambahan.

Contoh file untuk update.yml:

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

Jalankan perintah Ansible:

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

Ganti variabel berikut:

  • DEPLOYMENT_SPECIFICATION: jalur ke spesifikasi deployment yang Anda buat di Menginstal komponen AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: jalur ke spesifikasi cluster Anda.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Ganti variabel berikut:

  • DEPLOYMENT_SPECIFICATION: jalur ke spesifikasi deployment yang Anda buat di Menginstal komponen AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: jalur ke spesifikasi cluster Anda.

Memverifikasi perubahan parameter

Setelah menerapkan konfigurasi, Anda dapat memverifikasi bahwa parameter telah diperbarui menggunakan perintah SHOW di psql:

SHOW PARAMETER_NAME;

Ganti PARAMETER_NAME dengan nama parameter yang Anda konfigurasi.