Configurare i flag di database di un'istanza

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

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

In alcuni casi, l'impostazione di un flag potrebbe richiedere l'impostazione di un altro per attivare 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 del database supportati.

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

  • Tempi di inattività ridotti. Questo criterio è attivo per impostazione predefinita. Ti consigliamo di utilizzare questo criterio per tutti i tuoi cluster AlloyDB di produzione, in quanto riduce al minimo il tempo di riposo dell'applicazione.

    Con il criterio di tempo di riposo ridotto abilitato, l'aggiornamento di un flag che richiede un riavvio sull'istanza principale del cluster ha i seguenti effetti:

    • L'istanza principale presenta un tempo di riposo inferiore a un secondo per la maggior parte dei carichi di lavoro.

    • L'aggiornamento del flag nell'istanza principale al nuovo valore viene completato 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 dell'istanza del pool di lettura al nuovo valore viene completato dopo circa 10 minuti.

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

    Questo criterio è più appropriato per gli ambienti di sviluppo, in quanto consente di aggiungere o modificare rapidamente i flag in cambio di un tempo di riposo dell'istanza più lungo e di una diminuzione temporanea delle prestazioni o del throughput del database. Il cluster torna al rendimento massimo diversi minuti dopo l'applicazione forzata di un aggiornamento del flag.

    Con il criterio di applicazione forzata abilitato, l'aggiornamento di un flag che richiede un riavvio sull'istanza principale del cluster ha i seguenti effetti:

    • L'istanza principale presenta circa un minuto di tempo di riposo.

    • L'aggiornamento del flag dell'istanza principale al nuovo valore viene completato 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 presenta circa un minuto di tempo di inattività.

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

Prima di iniziare

  • Il progetto Google Cloud che utilizzi deve essere stato abilitato per accedere ad AlloyDB.
  • Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che utilizzi:
    • 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 dell'organizzazione per richiedere l'accesso.

  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 tuo cluster, seleziona un'istanza e poi fai clic su Modifica.

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

    Aggiungere una segnalazione

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

    Modificare un indicatore

    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.

    Eliminare un indicatore

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

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é questo 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 indicatori del database. Ogni specifica è composta dal nome del flag, da un 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 è posizionata l'istanza, ad esempio us-central1.
  • CLUSTER_ID: l'ID del cluster in cui è posizionata l'istanza.
  • PROJECT_ID: l'ID del progetto in cui è posizionato il cluster. in fase di ciclo di manutenzione con tempo di riposo ridotto o nullo, dopo aver modificato i flag del database.

Per visualizzare l'elenco dei flag correnti impostati manualmente di un'istanza, esegui il seguente comando:

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