Configurare i flag di database di un'istanza

Per ottimizzare i parametri PostgreSQL, regolare le opzioni del database e personalizzare il comportamento dell'istanza in un cluster AlloyDB per PostgreSQL, puoi aggiungere, modificare o rimuovere i flag di database in un'istanza. Le modifiche al valore di un flag di database persistono per la sua istanza finché non rimuovi il flag o non ne modifichi nuovamente il valore.

In alcuni casi, l'impostazione di un flag potrebbe richiedere l'impostazione di un altro flag per abilitare completamente la funzionalità di destinazione.

Dopo aver impostato, rimosso o modificato un flag per un'istanza di database, AlloyDB potrebbe riavviare l'istanza. Questo dipende dal flag, come elencato in Flag di database supportati.

Quando modifichi un flag di database nell'istanza principale o in un'istanza del pool di lettura che richiede un riavvio, puoi scegliere una delle seguenti policy di manutenzione:

  • Tempi di inattività ridotti. Questa policy è attiva per impostazione predefinita. Ti consigliamo di utilizzare questa policy per tutti i cluster AlloyDB di produzione, perché riduce al minimo i tempi di inattività delle applicazioni.

    Se la policy per tempi di inattività ridotti è abilitata, l'aggiornamento di un flag che richiede il riavvio dell'istanza principale del cluster ha i seguenti effetti:

    • L'istanza principale subisce un tempo di inattività inferiore a un secondo per la maggior parte dei workload.

    • L'aggiornamento del flag sull'istanza principale al nuovo valore viene completato dopo circa 15 minuti.

    L'aggiornamento di un flag che richiede il riavvio di un'istanza del pool di lettura ha i seguenti effetti:

    • L'istanza del pool di lettura non richiede tempi di inattività.

    • Il flag nell'istanza del pool di lettura termina l'aggiornamento al nuovo valore dopo circa 10 minuti.

  • Forza applicazione. Per applicare gli aggiornamenti dei flag più velocemente, utilizza l'opzione FORCE_APPLY con il comando gcloud beta alloydb instances update.

    Questa policy è più adatta agli ambienti di sviluppo, in quanto consente di aggiungere o modificare rapidamente i flag, a fronte di tempi di inattività più lunghi dell'istanza e di una diminuzione temporanea delle prestazioni o del throughput del database. Il cluster torna alle prestazioni massime alcuni minuti dopo l'applicazione forzata di un aggiornamento dei flag.

    Con la policy di applicazione forzata abilitata, l'aggiornamento di un flag che richiede un riavvio nell'istanza principale del cluster ha i seguenti effetti:

    • L'istanza principale subisce circa un minuto di inattività.

    • L'aggiornamento del flag nell'istanza principale al nuovo valore viene completato dopo uno o due minuti.

    L'aggiornamento di un flag che richiede il riavvio di un'istanza del pool di lettura ha i seguenti effetti:

    • L'istanza del pool di lettura subisce un tempo di inattività di circa un minuto.

    • L'aggiornamento del flag nell'istanza del pool di lettura al nuovo valore viene completato dopo uno o due minuti.

Prima di iniziare

  • Il progetto Google Cloud che stai utilizzando deve essere stato abilitato per accedere ad AlloyDB.
  • Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che stai utilizzando:
    • roles/alloydb.admin (il ruolo IAM predefinito AlloyDB Admin)
    • roles/owner (il ruolo IAM di base Proprietario)
    • roles/editor (il ruolo IAM di base Editor)

    Se non disponi di nessuno di questi ruoli, contatta l'Amministratore organizzazione per richiedere l'accesso.

Per assicurarti che la manutenzione e gli aggiornamenti possano creare slot di replica temporanei per la sincronizzazione dello stato, assicurati che il numero totale di slot di replica sia almeno uno in meno rispetto al limite max_wal_senders. Per saperne di più sulla configurazione di questo flag, consulta Configura le istanze di origine.

Console

  1. Nella console Google Cloud , vai alla pagina Cluster.

    Vai a Cluster

  2. Fai clic su un cluster nella colonna Nome risorsa.

  3. Nella pagina Panoramica, vai a Istanze nel cluster, seleziona un'istanza e fai clic su Modifica.

  4. Espandi Opzioni di configurazione avanzate.

  5. Aggiungi, modifica o elimina un flag di database dalla tua istanza:

    Aggiungi un flag

    1. Per aggiungere un flag di database all'istanza, fai clic su Aggiungi flag.
    2. Seleziona un flag dall'elenco Nuovo flag di database.
    3. Specifica un valore per il flag.
    4. Fai clic su Fine.

    Modifica un flag

    1. Per modificare un flag di database presente nell'istanza, espandi il flag di database e modifica il valore del flag esistente nella sezione Modifica flag di database.
    2. Fai clic su Fine.

    Elimina un flag

    1. Per eliminare un flag di database dall'istanza, seleziona un flag e fai clic sull'icona Elimina.
    2. Fai clic su Fine.

  6. Fai clic su Aggiorna istanza.

gcloud

Utilizza il comando gcloud alloydb instances update per modificare i flag di database per un'istanza.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

Per applicare gli aggiornamenti dei flag più rapidamente, includi l'argomento --update-mode=FORCE_APPLY. Poiché ciò può ridurre temporaneamente le prestazioni del database, evita di utilizzare questa opzione in un ambiente di produzione.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza.
  • FLAGS_LIST: un elenco separato da virgole di una o più specifiche dei flag di database. Ogni specifica è costituita dal nome del flag, da un segno di uguale (=) e dal valore da assegnare ai flag. Per i flag di database che non accettano valori, specifica il nome del flag seguito da un segno di uguale (=).
  • REGION_ID: la regione in cui si trova l'istanza, ad esempio us-central1.
  • CLUSTER_ID: l'ID del cluster in cui si trova l'istanza.
  • PROJECT_ID: l'ID del progetto in cui si trova il cluster.

Per visualizzare l'elenco dei flag attuali di un'istanza impostati manualmente, esegui questo comando:

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID