Configurare i parametri del database

Seleziona una versione della documentazione:

Questa pagina descrive come configurare i parametri del database utilizzando l'orchestratore RPM di AlloyDB Omni.

I parametri del database, noti anche come parametri GUC (Grand Unified Configuration), consentono di ottimizzare le prestazioni e il comportamento del cluster di database AlloyDB Omni. Per saperne di più, consulta Impostazione dei parametri nella documentazione di PostgreSQL.

Prima di iniziare

Prima di configurare i parametri del database, assicurati di:

  1. Installato l' orchestratore AlloyDB Omni.
  2. Aver eseguito il provisioning e creato il cluster AlloyDB Omni.

Configurare i parametri del database

Per configurare i parametri del database, utilizza il campo parameters all'interno della sezione primarySpec della specifica della risorsa DBCluster.

Aggiornare la specifica della risorsa

Aggiungi o modifica i parametri richiesti e i relativi valori nella specifica della risorsa DBCluster. Puoi farlo per configurare i parametri durante la creazione del cluster o per aggiornarli dopo la creazione del cluster.

Il seguente snippet mostra esempi di parametri GUC. Puoi configurare in modo simile altri parametri del database supportati:

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 ...

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del cluster di database.
  • MAX_WAL_SIZE: un parametro di esempio che controlla la dimensione massima che il WAL può raggiungere tra i checkpoint WAL automatici, ad esempio 2GB.
  • MAX_CONNECTIONS_LIMIT: un parametro di esempio che controlla il numero massimo di connessioni simultanee consentite al server di database, ad esempio 200. Il valore minimo supportato è 50.
  • HUGE_PAGES: un parametro di esempio che controlla l'utilizzo di pagine enormi, ad esempio on.
  • LOG_STATEMENT: un parametro di esempio che controlla quali istruzioni SQL vengono registrate, ad esempio all.

Applicare la configurazione

Applica le modifiche utilizzando l'interfaccia dell'orchestratore che preferisci.

Ansible

Se gestisci l'infrastruttura dell'orchestratore RPM di AlloyDB Omni direttamente utilizzando Ansible, questo attiva gli aggiornamenti eseguendo il playbook appropriato e passando l'update_action selezionato come variabile extra.

File di esempio per 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

Esegui il comando Ansible:

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

Sostituisci le seguenti variabili:

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Sostituisci le seguenti variabili:

Verificare le modifiche dei parametri

Dopo aver applicato la configurazione, puoi verificare che i parametri siano stati aggiornati utilizzando il comando SHOW in psql:

SHOW PARAMETER_NAME;

Sostituisci PARAMETER_NAME con il nome del parametro che hai configurato.