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) nel manifest del cluster di database (DBCluster) per gli ambienti che eseguono AlloyDB Omni su un cluster Kubernetes. Per un elenco dei flag supportati, consulta Flag di database supportati.

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 applicare le modifiche di alcuni parametri, è necessario riavviare il cluster. Puoi ottenere un elenco di 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 può applicare gli aggiornamenti richiesti, l'output elenca i valori attuali e quelli richiesti separatamente. Ad esempio, questa differenza può verificarsi se applichi un parametro inesistente o imposti un valore di stringa per un parametro intero.

Controlla i parametri del database utilizzando l'interfaccia utente web

Puoi controllare i flag di database attivi e identificare i parametri personalizzati che differiscono dai valori predefiniti del motore utilizzando la pagina Flag di database nell'interfaccia utente web di AlloyDB Omni.

Per controllare i parametri del database nell'interfaccia utente web, completa i seguenti passaggi:

  1. Connettiti alla UI web e seleziona il tuo cluster.
  2. Nel menu di navigazione, fai clic su Flag di database.
  3. Utilizza i seguenti controlli per cercare e filtrare i parametri:
    • Cerca flag: inserisci una parola chiave (ad esempio max) per filtrare i parametri in base al nome.
    • Mostra flag modificati: seleziona questa casella di controllo per visualizzare solo i parametri i cui valori attivi differiscono dai valori predefiniti del motore. I valori personalizzati sono evidenziati in giallo anche nella colonna Valore corrente.
    • Comprimi tutto o Espandi tutto: comprimi o espandi i gruppi di categorie di parametri (ad esempio Opzioni Google AlloyDB, Impostazioni predefinite per la connessione client/Impostazioni internazionali e formattazione, Impostazioni predefinite per la connessione client/Altre impostazioni predefinite e Impostazioni predefinite per la connessione client/Precaricamento della libreria condivisa).
  4. Esamina le colonne della tabella dei parametri all'interno di ogni gruppo di categorie:
    • Impostazione: il nome del parametro del database.
    • Tipo: il tipo di dati del parametro (ad esempio INTEGER).
    • Valore attuale: il valore attivo del parametro nell'istanza (evidenziato in giallo se modificato rispetto al valore predefinito).
    • Valore predefinito: il valore predefinito del motore per il parametro.
    • Riavvio richiesto: indica se la modifica del parametro richiede il riavvio del database (true o false).
    • Origine: l'origine della configurazione del valore corrente (ad esempio, default).