Questa pagina contiene un elenco dei problemi più frequenti che potresti riscontrare quando lavori con le istanze Cloud SQL, nonché i passaggi che puoi seguire per risolverli. Inoltre, esamina le pagine Problemi noti, Risoluzione dei problemi e Assistenza.
Visualizza i log
Per informazioni sulle operazioni recenti, puoi visualizzare i log delle operazioni delle istanze Cloud SQL o i log degli errori di PostgreSQL.
Problemi di connessione
Consulta la pagina Debug dei problemi di connessione o la sezione Connettività nella pagina di risoluzione dei problemi per assistenza in caso di problemi di connessione.
Problemi relativi all'istanza
Backup
Per ottenere prestazioni ottimali per i backup, limita il numero di tabelle a un numero ragionevole.
Per altri problemi relativi ai backup, consulta la sezione Backup nella pagina di risoluzione dei problemi.
Importazione ed esportazione
Il completamento delle importazioni in Cloud SQL e delle esportazioni da Cloud SQL può richiedere molto tempo, a seconda delle dimensioni dei dati in elaborazione. Ciò può avere i seguenti effetti:
- Non puoi arrestare un'operazione di un'istanza Cloud SQL a lunga esecuzione.
- Puoi eseguire una sola operazione di importazione o esportazione alla volta per ogni istanza e un'operazione di importazione o esportazione a lunga esecuzione blocca altre operazioni, come i backup automatici giornalieri. Le esportazioni serverless ti consentono di eseguire altre operazioni, tra cui la modifica delle istanze, l'importazione, il failover e lo sblocco dei backup automatici giornalieri.
Puoi ridurre il tempo necessario per completare ogni operazione utilizzando la funzionalità di importazione o esportazione di Cloud SQL con batch di dati più piccoli.
Per le esportazioni, puoi eseguire l'esportazione da una replica di lettura o utilizzare l'esportazione serverless per ridurre al minimo l'impatto sulle prestazioni del database e consentire l'esecuzione di altre operazioni sull'istanza mentre è in esecuzione un'esportazione.
Per altri problemi di importazione ed esportazione, consulta la sezione Importazione ed esportazione nella pagina di risoluzione dei problemi.
Spazio sul disco
Se l'istanza raggiunge la quantità massima di archiviazione consentita, le scritture sul database non riescono. Se elimini i dati, ad esempio eliminando una tabella, lo spazio viene liberato, ma non viene indicato nello spazio di archiviazione utilizzato indicato nei report dell'istanza. Puoi eseguire il comandoVACUUM FULL per recuperare lo spazio inutilizzato. Tieni presente che le operazioni di scrittura sono bloccate mentre il comando vacuum è in esecuzione. Scopri di più.
Stato sospeso
Esistono vari motivi per cui Cloud SQL può sospendere un'istanza, tra cui:
Problemi di fatturazione
Ad esempio, se la carta di credito per l'account di fatturazione del progetto è scaduta, l'istanza potrebbe essere sospesa. Per verificare i dati di fatturazione di un progetto, accedi alla pagina Fatturazione della console Google Cloud, seleziona il progetto e visualizza i dati dell'account di fatturazione utilizzati per il progetto. Dopo aver risolto il problema di fatturazione, l'istanza torna allo stato eseguibile entro alcune ore.
Problemi relativi alle chiavi KMS
Ad esempio, se la versione della chiave KMS utilizzata per criptare i dati utente nell'istanza Cloud SQL non è presente o se è stata disabilitata o eliminata. Vedi Utilizzo delle chiavi di crittografia gestite dal cliente (CMEK).
Problemi legali
Ad esempio, una violazione delle Norme di utilizzo accettabile di Google Cloud può comportare la sospensione dell'istanza. Per maggiori informazioni, consulta la sezione "Sospensioni e rimozioni" nei Termini di servizio di Google Cloud.
Problemi operativi
Ad esempio, se un'istanza è bloccata in un loop di arresto anomalo (si arresta in modo anomalo all'avvio o subito dopo l'avvio), Cloud SQL potrebbe sospenderla.
Mentre un'istanza è sospesa, puoi continuare a visualizzarne le relative informazioni o eliminarla, se la sospensione è stata attivata da problemi di fatturazione.
Gli utenti di Cloud SQL con pacchetti di assistenza Platinum, Gold o Silver possono contattare direttamente il nostro team di assistenza in merito alle istanze sospese. Tutti gli utenti possono utilizzare le indicazioni precedenti insieme al forum google-cloud-sql.
Prestazioni
Panoramica
Cloud SQL supporta i carichi di lavoro che richiedono alte prestazioni,con un massimo di 60.000 IOPS e senza costi aggiuntivi per I/O. Le prestazioni di IOPS e velocità effettiva dipendono, tra gli altri fattori, dalle dimensioni del disco, dal numero di vCPU delle istanze e dalla dimensione del blocco I/O.
Le prestazioni dell'istanza dipendono anche dalla scelta del tipo di archiviazione e dal carico di lavoro.
Scopri di più su:
- Dischi permanenti e prestazioni.
- Metriche relative a prestazioni e limitazione.
- Ottimizzazione delle prestazioni dei dischi.
- Altri fattori che influiscono sulle prestazioni.
Mantieni un numero ragionevole di tabelle di database
Le tabelle di database consumano risorse di sistema. Un numero elevato può influire sulle prestazioni e sulla disponibilità dell'istanza e causare la perdita della copertura SLA dell'istanza. Scopri di più.
Abilita log delle query
Puoi registrare le query lente per Cloud SQL per PostgreSQL impostando il flag log_min_duration_statement. Le query eseguite almeno per il periodo di tempo specificato verranno registrate. Se questo valore viene specificato senza unità, il valore è in millisecondi. Vai al Logging delle operazioni per visualizzare i log.
Suggerimenti generali per il rendimento
Assicurati che l'istanza non sia limitata di memoria o CPU. Per carichi di lavoro che richiedono prestazioni elevate, assicurati che l'istanza abbia almeno 60 GB di memoria. In caso di operazioni di inserimento, aggiornamento o eliminazione di database lenti, controlla le posizioni dello scrittore e del database; l'invio di dati a lunga distanza introduce latenza.Migliora le prestazioni delle query utilizzando Query Insights.
Per una selezione lenta dei database, considera quanto segue:
- La memorizzazione nella cache è importante per le prestazioni di lettura. Controlla i vari rapporti di
blks_hit / (blks_hit + blks_read)nel raccoglitore statistiche di PostgreSQL. Idealmente, il rapporto è superiore al 99%. In caso contrario, valuta la possibilità di aumentare la dimensione della RAM dell'istanza. - Se il carico di lavoro è costituito da query che utilizzano molta CPU (ordinamento, espressioni regolari, altre funzioni complesse), la tua istanza potrebbe essere limitata e dovrai aggiungere vCPU.
- Controlla la posizione del lettore e del database: la latenza influisce sulle prestazioni di lettura ancor più di quelle di scrittura.
- Esamina i miglioramenti delle prestazioni specifici non per Cloud SQL, come l'aggiunta di un'indicizzazione appropriata, la riduzione dei dati analizzati ed evitando ulteriori round trip.
EXPLAIN per identificare dove aggiungere indici alle tabelle per migliorare le prestazioni delle query. Ad esempio, assicurati che ogni campo che utilizzi come chiave JOIN abbia un indice in entrambe le tabelle.
Risolvere i problemi
Per altri problemi di Cloud SQL, consulta la pagina per la risoluzione dei problemi.
Messaggi di errore
Per messaggi di errore specifici relativi all'API, consulta la pagina di riferimento Messaggi di errore.
Risolvere i problemi relativi alle chiavi di crittografia gestite dal cliente (CMEK)
Le operazioni dell'amministratore di Cloud SQL, come la creazione, la clonazione o l'aggiornamento, potrebbero non riuscire a causa di errori di Cloud KMS e di ruoli o autorizzazioni mancanti. Le cause comuni degli errori includono una versione mancante della chiave Cloud KMS, una versione della chiave Cloud KMS disabilitata o eliminata, autorizzazioni IAM insufficienti per accedere alla versione della chiave Cloud KMS o la versione della chiave Cloud KMS si trova in una regione diversa rispetto all'istanza Cloud SQL. Utilizza la seguente tabella di risoluzione dei problemi per diagnosticare e risolvere i problemi più comuni.
Tabella per la risoluzione dei problemi relativi alle chiavi di crittografia gestite dal cliente
| Per questo errore... | Il problema potrebbe essere... | Prova questa procedura... |
|---|---|---|
| Account di servizio per prodotto e progetto non trovato | Il nome dell'account di servizio non è corretto. | Assicurati di aver creato un account di servizio per il progetto utente corretto.
|
| Impossibile concedere l'accesso all'account di servizio | L'account utente non dispone dell'autorizzazione per concedere l'accesso a questa versione della chiave. | Aggiungi il ruolo Amministratore organizzazione al tuo account utente o di servizio.
|
| La versione della chiave Cloud KMS è stata eliminata | La versione della chiave è stata eliminata. | Se la versione della chiave viene eliminata, non puoi utilizzarla per criptare o decriptare i dati. |
| La versione della chiave Cloud KMS è disabilitata | La versione della chiave è disabilitata. | Riattiva la versione della chiave Cloud KMS.
|
| Autorizzazione insufficiente per utilizzare la chiave Cloud KMS | Il ruolo cloudkms.cryptoKeyEncrypterDecrypter non è presente nell'account utente o
di servizio che stai utilizzando per eseguire operazioni sulle istanze Cloud SQL oppure la
versione della chiave Cloud KMS non esiste. |
Nel progetto Google Cloud che ospita la chiave, aggiungi il ruolo cloudkms.cryptoKeyEncrypterDecrypter al tuo account utente o di servizio.
Se il ruolo è già concesso al tuo account, consulta Creazione di una chiave per scoprire come creare una nuova versione della chiave. Vedi nota. |
| Chiave Cloud KMS non trovata | La versione della chiave non esiste. | Crea una nuova versione della chiave. Vedi Creazione di una chiave. Vedi nota. |
| L'istanza Cloud SQL e la versione della chiave Cloud KMS si trovano in regioni diverse | La versione della chiave Cloud KMS e l'istanza Cloud SQL devono trovarsi nella stessa regione. Non funziona se la versione della chiave Cloud KMS si trova in una regione globale o in più regioni. | Crea una versione della chiave nella stessa regione in cui vuoi creare le istanze. Consulta la sezione Creazione di una chiave. Vedi nota. |
| La versione della chiave Cloud KMS è stata ripristinata, ma l'istanza è ancora sospesa | La versione della chiave è disabilitata o non concede le autorizzazioni appropriate. | Riabilita la versione della chiave e concedi il ruolo cloudkms.cryptoKeyEncrypterDecrypter al tuo account utente o di servizio nel progetto Google Cloud che ospita la chiave. |
Tabella per la risoluzione dei problemi relativi alla ricrittografia
| Per questo errore... | Il problema potrebbe essere... | Prova questa procedura... |
|---|---|---|
| La ricrittografia della risorsa CMEK non è riuscita perché la chiave Cloud KMS non è accessibile. Assicurati che la versione della chiave primaria sia abilitata e l'autorizzazione sia stata concessa correttamente. | La versione della chiave è disabilitata o non concede le autorizzazioni appropriate. | Riattiva la versione della chiave Cloud KMS: Nel progetto Google Cloud che ospita la chiave, verifica che il ruolo |
| Ricrittografia della risorsa CMEK non riuscita a causa di un errore interno del server. Riprova più tardi | Si è verificato un errore interno del server. | Riprova a eseguire la ricrittografia. Per maggiori informazioni, consulta Ricriptare un'istanza o una replica abilitata per CMEK esistente |