Configurare i parametri del database

Select a documentation version:

Questa pagina descrive come configurare i parametri del database utilizzando l'orchestratore 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 ulteriori informazioni, 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 i parametri richiesti e i relativi valori alla specifica della risorsa DBCluster:

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"

Sostituisci quanto segue:

  • CLUSTER_NAME: nome del cluster di database.
  • MAX_WAL_SIZE: la dimensione massima che il WAL può raggiungere tra i checkpoint WAL automatici, ad esempio 2GB.
  • MAX_CONNECTIONS_LIMIT: numero massimo di connessioni simultanee consentite al server di database, ad esempio 200. Il valore minimo supportato è 50.

Parametri supportati durante la creazione del cluster

Puoi configurare i seguenti parametri del database (GUC) nella specifica della risorsa DBCluster durante la creazione del cluster:

  • log_connections
  • log_disconnections
  • log_hostname
  • log_statement
  • max_connections
  • max_wal_size
  • huge_pages
  • tcp_keepalives_idle
  • tcp_keepalives_interval
  • tcp_keepalives_count

Non puoi configurare i parametri, ad esempio shared_buffers, che non sono inclusi in questo elenco utilizzando la specifica DBCluster. Dovrai invece aggiornarli manualmente dopo la creazione del cluster.

Applicare la configurazione

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

Ansible 

ansible-playbook -i DEPLOYMENT_SPECIFICATION DBCLUSTER_PLAYBOOK -e resource_spec=DBCLUSTER_SPECIFICATION

Sostituisci le seguenti variabili:

  • DEPLOYMENT_SPECIFICATION: percorso della specifica del deployment creata in Installare i componenti AlloyDB Omni.

  • DBCLUSTER_PLAYBOOK: percorso del playbook creato per il cluster di database.

  • DBCLUSTER_SPECIFICATION: percorso della specifica del cluster.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Sostituisci le seguenti variabili:

Aggiornare i parametri del database dopo la creazione del cluster

Per aggiornare i parametri dopo la creazione del cluster, devi modificare manualmente i file di configurazione sui nodi del database.

Aggiornare i parametri in un cluster ad alta disponibilità

Per aggiornare manualmente i parametri del database in un cluster ad alta disponibilità (HA), completa i seguenti passaggi:

  1. Se availability.enableAutoFailover e availability.enableAutoHeal sono impostati su true nel file di specifica DBCluster, impostali su false.

    DBCluster:
  metadata:
    name: my-db-cluster
  spec:
    databaseVersion: 18.1.0
    mode: ""
    availability:
      ...
      enableAutoFailover: false
      enableAutoHeal: false
      ...

    Applica la specifica della risorsa aggiornata utilizzando l'interfaccia che preferisci.

  2. Su ogni nodo del database, modifica il file 30startup.conf nella seguente directory: DATA_DISK_PATH/18/db/postgresql.conf.d/.

    Sostituisci DATA_DISK_PATH con il valore del campo path del disco denominato DataDisk nella specifica della risorsa DBCluster.

    Esempio di specifica DBCluster:

    DBCluster:
  spec:
    primarySpec:
      resources:
        disks:
        - name: DataDisk
          path: /var/lib/alloydbomni/data  # This is your DATA_DISK_PATH

  3. Aggiungi o aggiorna le configurazioni dei parametri del database nel file 30startup.conf. Per ulteriori informazioni, consulta la documentazione di PostgreSQL.

  4. Riavvia il servizio di database su tutti i nodi:

    sudo systemctl restart alloydbomni18

  5. Se hai modificato i campi availability.enableAutoFailover e availability.enableAutoHeal nella specifica della risorsa DBCluster, ripristina i valori originali e applica le modifiche.

Aggiornare i parametri in un cluster autonomo

Per aggiornare manualmente i parametri del database in un cluster autonomo, completa i seguenti passaggi:

  1. Sul nodo del database, aggiorna il 30startup.conf file nella seguente directory: DATA_DISK_PATH/18/db/postgresql.conf.d/.

    Sostituisci DATA_DISK_PATH con il percorso del file system definito per DataDisk nella specifica della risorsa DBCluster.

  2. Aggiungi o aggiorna le configurazioni dei parametri del database nel file 30startup.conf.

  3. Riavvia il servizio di database:

    sudo systemctl restart alloydbomni18

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.