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 persistono per la relativa istanza finché non viene rimosso il flag o il suo valore non viene modificato di nuovo.
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 è attivata la norma sui tempi di inattività ridotti, 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_APPLYcon il comandogcloud 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 di picco diversi minuti dopo l'applicazione forzata di un aggiornamento del flag.
Se è abilitata l'applicazione forzata dei criteri, l'aggiornamento di un flag che richiede un riavvio sull'istanza primaria del cluster ha i seguenti effetti:
L'istanza principale subisce un'interruzione di circa un minuto.
L'aggiornamento del flag sull'istanza principale al nuovo valore termina 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 un tempo di inattività di circa un minuto.
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.
Console
Nella console Google Cloud , vai alla pagina Cluster.
Fai clic su un cluster nella colonna Nome risorsa.
Nella pagina Panoramica, vai a Istanze nel cluster, seleziona un'istanza e poi fai clic su Modifica.
Aggiungi, modifica o elimina un flag di database dalla tua istanza:
Aggiungere un flag
- Per aggiungere un flag di database all'istanza, fai clic su Aggiungi flag.
- Seleziona un flag dall'elenco Nuovo flag database.
- Specifica un valore per il flag.
- Fai clic su Fine.
Modificare un flag
- 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.
- Fai clic su Fine.
Eliminare un flag
- Per eliminare un flag del database dall'istanza, seleziona un flag e fai clic sull'icona di eliminazione.
- Fai clic su Fine.
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_IDPer 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_APPLYSostituisci quanto segue:
INSTANCE_ID: l'ID dell'istanza.FLAGS_LIST: un elenco separato da virgole di una o più specifiche di flag del database. Ogni specifica è costituita 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 si trova l'istanza, ad esempious-central1.CLUSTER_ID: l'ID del cluster in cui viene inserita l'istanza.PROJECT_ID: l'ID del progetto in cui si trova 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