Diagnostica dei problemi

Questa pagina contiene un elenco dei problemi più frequenti che potresti riscontrare quando lavori con le istanze Cloud SQL e i passaggi che puoi seguire per risolverli. Consulta anche le pagine Problemi noti, Risoluzione dei problemi e Pagina di assistenza.

Visualizza i log

Per visualizzare informazioni sulle operazioni recenti, puoi visualizzare i log delle operazioni dell'istanza Cloud SQL o i log degli errori di PostgreSQL.

Problemi di connessione

Per assistenza in caso di problemi di connessione, consulta la pagina Debug dei problemi di connessione o la sezione Connettività nella pagina di risoluzione dei problemi.

Problemi dell'istanza

Backup

Per ottenere le migliori prestazioni per i backup, mantieni un numero ragionevole di tabelle.

Per altri problemi relativi ai backup, consulta la sezione Backup nella pagina di risoluzione dei problemi.

Importazione ed esportazione

Le importazioni in Cloud SQL e le esportazioni da Cloud SQL possono richiedere molto tempo, a seconda delle dimensioni dei dati in fase di elaborazione. Questa operazione può avere i seguenti impatti:

  • Non puoi arrestare un'operazione 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 durante l'esecuzione di 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 la tua istanza raggiunge la quantità massima di spazio di archiviazione consentita, le operazioni di scrittura nel database non vanno a buon fine. Se elimini i dati, ad esempio eliminando una tabella, lo spazio viene liberato, ma non viene visualizzato nella sezione Spazio di archiviazione utilizzato dell'istanza. Puoi eseguire il comando VACUUM FULL per recuperare lo spazio inutilizzato. Tieni presente che le operazioni di scrittura sono bloccate durante l'esecuzione del comando vacuum. Scopri di più.

Stato sospeso

Esistono vari motivi per cui Cloud SQL potrebbe sospendere un'istanza, tra cui:

  • Problemi di fatturazione

    Ad esempio, se la carta di credito dell'account di fatturazione del progetto è scaduta, l'istanza potrebbe essere sospesa. Puoi controllare le informazioni di fatturazione di un progetto andando alla pagina di fatturazione della console Google Cloud , selezionando il progetto e visualizzando le informazioni dell'account di fatturazione utilizzato per il progetto. Dopo aver risolto il problema di fatturazione, l'istanza torna allo stato eseguibile entro qualche ora.

  • Problemi principali relativi a Cloud Key Management Service

    Ad esempio, se la versione della chiave di Cloud KMS utilizzata per criptare i dati utente nell'istanza Cloud SQL non è presente, l'accesso alla chiave viene revocato o se la chiave viene disattivata o eliminata. Per saperne di più, consulta Utilizzo delle chiavi di crittografia gestite dal cliente (CMEK).

  • Problemi legali

    Ad esempio, una violazione delle Google Cloud Norme di utilizzo accettabile può causare la sospensione dell'istanza. Per ulteriori informazioni, consulta la sezione "Sospensioni e rimozioni" dei Google Cloud Termini di servizio.

  • Problemi operativi

    Ad esempio, se un'istanza è bloccata in un ciclo di arresto anomalo (si arresta durante l'avvio o subito dopo l'avvio), Cloud SQL potrebbe sospenderla.

Mentre un'istanza è sospesa, puoi continuare a visualizzare le informazioni relative all'istanza oppure puoi eliminarla, se i problemi di fatturazione hanno attivato la sospensione.

Gli utenti 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,fino a 60.000 IOPS e senza costi aggiuntivi per I/O. Le prestazioni in termini di IOPS e throughput dipendono, tra gli altri fattori, dalle dimensioni del disco, dal numero di vCPU dell'istanza e dalle dimensioni dei blocchi di I/O.

Le prestazioni dell'istanza dipendono anche dalla scelta del tipo di archiviazione e dal carico di lavoro.

Scopri di più su:

Mantieni un numero ragionevole di tabelle di database

Le tabelle del database consumano risorse di sistema. Un numero elevato può influire sulle prestazioni e sulla disponibilità dell'istanza e causare la perdita della copertura dello SLA (accordo sul livello del servizio). Scopri di più.

Abilita i log delle query

Puoi registrare le query lente per Cloud SQL per PostgreSQL impostando il flag log_min_duration_statement. Le query eseguite per almeno il periodo di tempo specificato verranno registrate. Se questo valore viene specificato senza unità, viene considerato in millisecondi. Vai a Operations Logging per visualizzare i log.

Suggerimenti generali per il rendimento

Assicurati che la tua istanza non sia vincolata alla memoria o alla CPU. Per i carichi di lavoro che richiedono molte risorse, assicurati che l'istanza abbia almeno 60 GB di memoria. Per inserimenti, aggiornamenti o eliminazioni lenti del database, controlla le posizioni del writer e del database; l'invio di dati su lunghe distanze introduce latenza.

Migliora le prestazioni delle query utilizzando Query Insights.

Per le selezioni lente del database, considera quanto segue:

  • La memorizzazione nella cache è importante per le prestazioni di lettura. Controlla i vari rapporti blks_hit / (blks_hit + blks_read) dal PostgreSQL Statistics Collector. Idealmente, il rapporto è superiore al 99%. In caso contrario, valuta la possibilità di aumentare le dimensioni della RAM dell'istanza.
  • Se il tuo carico di lavoro è costituito da query che richiedono un uso intensivo della CPU (ordinamento, espressioni regolari, altre funzioni complesse), la tua istanza potrebbe essere limitata; aggiungi vCPU.
  • Controlla la posizione del lettore e del database: la latenza influisce sulle prestazioni di lettura ancora più che sulle prestazioni di scrittura.
  • Esamina i miglioramenti delle prestazioni non specifici di Cloud SQL, ad esempio l'aggiunta di un'indicizzazione appropriata, la riduzione dei dati scansionati e l'evitare round trip aggiuntivi.

Se noti un rendimento scarso durante l'esecuzione delle query, utilizza EXPLAIN per identificare dove aggiungere gli indici alle tabelle per migliorare il rendimento delle query. Ad esempio, assicurati che ogni campo che utilizzi come chiave JOIN abbia un indice in entrambe le tabelle.

Risoluzione dei problemi

Per altri problemi di Cloud SQL, consulta la pagina Risoluzione dei problemi.

Messaggi di errore

Per messaggi di errore API specifici, consulta la pagina di riferimento Messaggi di errore.

Risolvere i problemi relativi alle chiavi di crittografia gestite dal cliente (CMEK)

Le operazioni di amministratore 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. I motivi comuni di errore includono una versione della chiave Cloud KMS mancante, una versione della chiave Cloud KMS disattivata 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 dall'istanza Cloud SQL. Utilizza la seguente tabella per la risoluzione dei problemi per diagnosticare e risolvere i problemi 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 per progetto non trovato Il nome del account di servizio non è corretto. Assicurati di aver creato un account di servizio per il progetto utente corretto.

VAI ALLA PAGINA ACCOUNT DI SERVIZIO.

Impossibile concedere l'accesso al account di servizio L'account utente non dispone dell'autorizzazione per concedere l'accesso a questa versione della chiave. Aggiungi il ruolo Amministratore dell'organizzazione al tuo utente o account di servizio.

VAI ALLA PAGINA DEGLI ACCOUNT IAM

La versione della chiave Cloud KMS viene eliminata La versione della chiave viene 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.

VAI ALLA PAGINA CHIAVI CRITTOGRAFICHE

Autorizzazione insufficiente per utilizzare la chiave Cloud KMS Il ruolo cloudkms.cryptoKeyEncrypterDecrypter non è presente nell'utente o nelaccount di serviziot che utilizzi 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 utente o account di servizio.

VAI ALLA PAGINA DEGLI ACCOUNT IAM


Se il ruolo è già concesso al tuo account, consulta Creazione di una chiave per scoprire come creare una nuova versione della chiave. Vedi nota.
La chiave Cloud KMS non è stata 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 multiregionale. Crea una versione della chiave nella stessa regione in cui vuoi creare le istanze. Vedi Creazione di una chiave. Vedi nota.
La versione della chiave Cloud KMS viene ripristinata, ma l'istanza è ancora sospesa La versione della chiave è disattivata o non concede le autorizzazioni corrette. Riabilita la versione della chiave e concedi il ruolo cloudkms.cryptoKeyEncrypterDecrypter al tuo utente o account 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 ricriptografia della risorsa CMEK non è riuscita perché la chiave Cloud KMS non è accessibile. Assicurati che la versione della chiave primaria sia abilitata e che l'autorizzazione sia concessa correttamente. La versione della chiave è disattivata o non concede le autorizzazioni corrette.

Riattiva la versione della chiave Cloud KMS:

VAI ALLA PAGINA CHIAVI CRITTOGRAFICHE

Nel progetto Google Cloud che ospita la chiave, conferma che il ruolo cloudkms.cryptoKeyEncrypterDecrypter sia concesso al tuo utente o service account:

VAI ALLA PAGINA DEGLI ACCOUNT IAM
La nuova crittografia 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 crittografia. Per ulteriori informazioni, consulta Rieseguire la crittografia di un'istanza o una replica esistente abilitata per CMEK.