Questa pagina descrive come aggiungere flag di database per un'istanza, modificare i flag di database ed eliminarli 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 non modifichi di nuovo il suo valore.
In alcuni casi, l'impostazione di un flag potrebbe richiedere l'impostazione di un altro flag 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 di database supportati.
Quando modifichi un flag di 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 è attivato per impostazione predefinita. Ti consigliamo di utilizzare questo criterio per tutti i tuoi cluster AlloyDB di produzione perché riduce al minimo i tempi di inattività dell'applicazione.
Se è abilitata la policy di 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 downtime 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 di pool di lettura ha questi 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 norma è più adatta agli ambienti di sviluppo, in quanto consente di aggiungere o modificare rapidamente i flag in cambio di un tempo di inattività più lungo dell'istanza e di una riduzione 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.
Se è abilitato il criterio di applicazione forzata, 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 di pool di lettura ha questi 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 che stai utilizzando:
- Google Cloud
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 di 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 è 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