Configura i parametri del database AlloyDB Omni

Select a documentation version:

Per configurare un parametro del database per AlloyDB Omni, puoi aggiornare i parametri GUC (Grand Unified Configuration) in uno dei seguenti modi:

  • Nel file postgresql.conf per gli ambienti che eseguono AlloyDB Omni su una VM.

  • Nel manifest del cluster di database per gli ambienti che eseguono AlloyDB Omni su un cluster Kubernetes.

Aggiorna un parametro in AlloyDB Omni containerizzato

In un'istanza di AlloyDB Omni in esecuzione su una VM, puoi aggiornare un parametro modificando il file postgresql.conf come segue:

  1. Individua il file di configurazione postgresql.conf per l'installazione di AlloyDB Omni.

  2. Utilizza un editor di testo per aggiungere o aggiornare un flag di database in postgresql.conf.

    Ad esempio, per applicare la scadenza della password, imposta il seguente flag nel file postgresql.conf:

    password.enforce_expiration = ON
    
  3. Dopo aver aggiunto o modificato i flag di database, ricarica il file postgresql.conf affinché le modifiche vengano applicate. Ad esempio, se hai installato AlloyDB Omni utilizzando Docker, esegui il comando seguente per riavviare l'istanza Docker e ricaricare postgresql.conf:

    docker restart CONTAINER-NAME

Per ulteriori informazioni, consulta Impostazione dei parametri nella documentazione di PostgreSQL.

Aggiorna un parametro in AlloyDB Omni su un cluster Kubernetes

Puoi configurare i parametri del database utilizzando il campo parameters nella sezione primarySpec del manifest del cluster di database:

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

Sostituisci quanto segue:

  • PARAMETER_NAME: il nome del parametro, ad esempio autovacuum.
  • PARAMETER_VALUE: il valore del parametro, ad esempio off.

Per alcuni parametri è necessario riavviare il cluster affinché le modifiche vengano applicate. Puoi ottenere un elenco dei parametri che richiedono un riavvio da pg_catalog.pg_settings. Qualsiasi parametro con pg_catalog.pg_settings.context = 'postmaster' richiede un riavvio.

Per aggiornare i parametri del database, esegui il comando seguente:

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

Le impostazioni dei parametri si trovano nella parte status del campo currentParameters.

Per visualizzare i parametri del database, esegui il comando seguente:

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

L'output è simile al seguente:

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

Se AlloyDB Omni non riesce ad applicare i parametri richiesti nel manifest del cluster di database, i valori del campo currentParameters possono differire dai valori del campo parameters del manifest. Ad esempio, applichi un parametro inesistente o imposti un valore stringa su un parametro intero.