Questa pagina descrive come aggiungere, modificare ed eliminare i flag di database di un'istanza in un cluster AlloyDB per PostgreSQL.
I flag di database vengono utilizzati per molte operazioni, tra cui la regolazione dei parametri di PostgreSQL, la regolazione 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 rimuovi il flag o non ne modifichi di nuovo il 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. Ciò 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:
Tempo di inattività ridotto. Questi criteri sono abilitati per impostazione predefinita. Ti consigliamo di utilizzare questi criteri per tutti i cluster AlloyDB di produzione, in quanto riducono al minimo il tempo di inattività delle applicazioni.
Con i criteri di tempo di inattività ridotto abilitati, l'aggiornamento di un flag che richiede un riavvio nell'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 carichi di lavoro.
L'aggiornamento del flag nell'istanza principale al nuovo valore termina dopo circa 15 minuti.
L'aggiornamento di un flag che richiede un riavvio in 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 nell'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.Questi criteri sono più adatti agli ambienti di sviluppo, in quanto consentono 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 dei flag.
Con i criteri di applicazione forzata abilitati, 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 tempo di inattività.
L'aggiornamento del flag nell'istanza principale al nuovo valore termina dopo uno o due minuti.
L'aggiornamento di un flag che richiede un riavvio in un'istanza del pool di lettura ha i seguenti effetti:
L'istanza del pool di lettura subisce circa un minuto di tempo di inattività.
L'aggiornamento del flag nell'istanza del pool di lettura al nuovo valore termina dopo uno o due minuti.
Prima di iniziare
- Il Google Cloud progetto che stai utilizzando deve essere stato abilitato per accedere ad AlloyDB.
- Devi disporre di uno di questi ruoli IAM nel Google Cloud progetto 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 uno di questi ruoli, contatta l'Amministratore organizzazione per richiedere l'accesso.
Console
Nella Google Cloud console, 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 fai clic su Modifica.
Aggiungi, modifica o elimina un flag di database dall'istanza:
Aggiungere un flag
- Per aggiungere un flag di database all'istanza, fai clic su Aggiungi flag.
- Seleziona un flag dall'elenco Nuovo flag di database.
- Fornisci un valore per il flag.
- Fai clic su Fine.
Modificare un flag
- 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.
- Fai clic su Fine.
Eliminare un flag
- Per eliminare un flag di database dall'istanza, seleziona un flag e fai clic sull'icona Elimina.
- Fai clic su Fine.
Fai clic su Aggiorna istanza.
gcloud
Utilizza il gcloud alloydb instances update
comando per modificare i flag di database di un'istanza.
gcloud alloydb instances update INSTANCE_ID \
--database-flags FLAGS_LIST \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_IDPer applicare più rapidamente gli aggiornamenti dei flag, 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 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, 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 si trova l'istanza.PROJECT_ID: l'ID del progetto in cui si trova il cluster. ciclo di manutenzione con tempi di inattività bassi o nulli, dopo aver modificato i flag di 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