Configurare i flag di database di un'istanza

Questa pagina descrive come aggiungere flag di database per un'istanza, modificare i flag di database ed eliminare i flag di database da un'istanza in un cluster AlloyDB per PostgreSQL.

Utilizzi i flag di database per molte operazioni, tra cui la modifica dei parametri PostgreSQL, la modifica delle opzioni e la configurazione e l'ottimizzazione di un'istanza. Le modifiche al valore di un flag di database vengono mantenute per la relativa istanza finché non rimuovi il flag o modifichi di nuovo il suo valore.

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

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

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

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

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

    • L'istanza primaria subisce un tempo di inattività inferiore a un secondo per la maggior parte dei carichi di lavoro.

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

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

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

    • L'aggiornamento del flag sull'istanza del pool di lettura al nuovo valore termina dopo circa 10 minuti.

  • Forza applicazione. Per applicare più rapidamente gli aggiornamenti dei flag, 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 al picco delle prestazioni diversi minuti dopo l'applicazione forzata di un aggiornamento del flag.

    Con l'applicazione forzata dei criteri abilitata, l'aggiornamento di un flag che richiede un riavvio sull'istanza principale del cluster ha i seguenti effetti:

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

    • Il flag sull'istanza principale termina l'aggiornamento al nuovo valore dopo uno o due minuti.

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

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

    • Il flag sull'istanza del pool di lettura termina l'aggiornamento al nuovo valore dopo uno o due minuti.

Prima di iniziare

  • Il Google Cloud progetto che utilizzi 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 garantire 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 di max_wal_senders. Per ulteriori informazioni sulla configurazione di questo flag, consulta Configurare 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 poi fai clic su Modifica.

  4. Espandi Opzioni di configurazione avanzate.

  5. Aggiungi, modifica o elimina un flag di database dall'istanza:

    Aggiungere un flag

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

    Modificare un flag

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

    Eliminare un flag

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

  6. Fai clic su Aggiorna istanza.

gcloud

Utilizza il comando gcloud alloydb instances update per modificare i flag del 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é questa operazione 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 di flag di database. Ogni specifica è costituita dal nome del flag, dal segno uguale (=) e dal valore da assegnare ai flag. Per i flag di database che non accettano valori, fornisci 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 viene inserita l'istanza.
  • PROJECT_ID: l'ID del progetto in cui è posizionato il cluster. sottoposto a ciclo di manutenzione con tempi di inattività bassi o nulli, dopo la modifica dei flag del database.

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

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