Configura i parametri del database AlloyDB Omni

Seleziona una versione della documentazione:

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 in container

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

  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 imporre la scadenza della password, imposta il seguente flag nel file postgresql.conf:

    password.enforce_expiration = ON

  3. Dopo aver aggiunto o modificato i flag del 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 saperne di più, consulta la sezione 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.

Alcuni parametri richiedono il riavvio del 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 questo comando:

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 questo comando:

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 da quelli del campo parameters del manifest. Ad esempio, applichi un parametro inesistente o imposti un valore stringa su un parametro intero.