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 che li rappresentano. Consulta anche le pagine Problemi noti, Risoluzione dei problemi e Pagina di assistenza.
Visualizza i log
Per informazioni sulle operazioni recenti, puoi visualizzare Log delle operazioni dell'istanza Cloud SQL o i log degli errori PostgreSQL.
Problemi di connessione
Vedi la sezione Debug della connessione dei problemi o la Connettività nella pagina di risoluzione dei problemi per ricevere assistenza in merito alla connessione per risolvere problemi di produzione e facilità d'uso.
Problemi dell'istanza
Backup
Per ottenere le migliori prestazioni per backups, mantieni 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
Le importazioni in Cloud SQL e le esportazioni da Cloud SQL possono richiedere molto tempo, a seconda delle dimensioni dei dati elaborati. Ciò può avere i seguenti effetti:
- Non puoi interrompere un'operazione dell'istanza Cloud SQL di lunga durata.
- Puoi eseguire una sola operazione di importazione o esportazione alla volta per ogni istanza e un'operazione di importazione o esportazione di lunga durata 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 esportazione serverless in minimizzare 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 Risoluzione dei problemi.
Spazio sul disco
Se l'istanza raggiunge la quantità massima di spazio di archiviazione consentita, scrive in l'errore del database. Se elimini dati, ad esempio eliminando un lo spazio viene liberato, ma non viene riportato Spazio di archiviazione utilizzato dell'istanza. Puoi eseguire il comandoVACUUM 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 diversi 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 nella pagina di fatturazione della console Google Cloud, selezionando il progetto e visualizzando i dati dell'account di fatturazione utilizzato per il progetto. Dopo la risoluzione a causa del problema di fatturazione, l'istanza torna allo stato eseguibile per alcune ore.
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 oppure 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 Norme di utilizzo accettabile di Google Cloud potrebbe causare la sospensione dell'istanza. Per ulteriori 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) durante l'avvio o subito dopo l'avvio), Cloud SQL potrebbe sospenderlo.
Mentre un'istanza è sospesa, puoi continuare a visualizzare le relative informazioni oppure puoi eliminarlo, se la sospensione è stata causata 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, oltre ai google-cloud-sql forum.
Prestazioni
Panoramica
Cloud SQL supporta i carichi di lavoro che richiedono alte prestazioni, fino a un massimo di 60.000 IOPS e senza costi aggiuntivi per l'I/O. Le prestazioni in termini di IOPS e velocità effettiva dipendono dalle dimensioni del disco, dal numero di vCPU dell'istanza e dalle dimensioni dei blocchi I/O, tra gli altri fattori.
Le prestazioni dell'istanza dipendono anche dalla scelta del tipo di archiviazione e dal caricamento di lavoro.
Scopri di più su:
- Dischi permanenti e prestazioni.
- Metriche sul rendimento e sulla limitazione.
- Ottimizzazione delle prestazioni del disco.
- Altri fattori che influiscono sul rendimento.
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 dello SLA (accordo sul livello del servizio). Scopri di più.
Abilita log delle query
Puoi registrare query lente per Cloud SQL per PostgreSQL impostando log_min_duration_statement flag. 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 Log delle operazioni per visualizzare i log.
Suggerimenti generali per le prestazioni
Assicurati che l'istanza non sia limitata in termini di memoria o CPU. Per i carichi di lavoro ad alte prestazioni, assicurati che l'istanza disponga di almeno 60 GB di memoria. Per inserimenti, aggiornamenti o eliminazioni del database lenti, controlla le posizioni dello scrittore e del database. L'invio di dati su lunghe distanze introduce latenza.Migliora le prestazioni delle query utilizzando Query Insights.
Per selezioni lente dei database, considera quanto segue:
- La memorizzazione nella cache è importante per le prestazioni di lettura. Controlla le varie
Proporzioni di
blks_hit / (blks_hit + blks_read)dal Raccoglitore delle statistiche PostgreSQL. Idealmente, il rapporto è superiore al 99%. In caso contrario, valuta la possibilità di aumentare la dimensione della RAM dell'istanza. - Se il tuo carico di lavoro è costituito da query che richiedono un'elevata intensità di 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 ancor più che su quelle di scrittura.
- Analizzare i miglioramenti delle prestazioni non specifici di Cloud SQL, ad esempio aggiungendo l'indicizzazione appropriata, riducendo i dati scansionati ed evitando rotazioni aggiuntive per i viaggi.
EXPLAIN per identificare dove aggiungere
a tabelle per migliorare le prestazioni delle query. Ad esempio, assicurati che
ogni campo che utilizzi come chiave JOIN ha un indice su entrambe le tabelle.
Risoluzione dei problemi
Per altri problemi relativi a Cloud SQL, consulta relativa alla risoluzione dei problemi.
Messaggi di errore
Per messaggi di errore API specifici, consulta la pagina di riferimento Messaggi di errore.
Risolvi i problemi relativi alle chiavi di crittografia gestite dal cliente (CMEK)
Le operazioni di amministrazione di Cloud SQL, come creazione, clonazione o aggiornamento, potrebbero non riuscire a causa di errori di Cloud KMS e di ruoli o autorizzazioni mancanti. Le cause comuni di errore includono: manca la versione della chiave Cloud KMS, è una versione della chiave Cloud KMS disabilitata o eliminata, autorizzazioni IAM insufficienti per accedere alla versione della chiave Cloud KMS oppure La versione della chiave Cloud KMS si trova in una regione diversa da quella dell'istanza Cloud SQL. Utilizza la tabella di risoluzione dei problemi che segue 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 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 dell'organizzazione al tuo account utente o di servizio.
|
| 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.
|
| Autorizzazione insufficiente per utilizzare la chiave Cloud KMS | Ruolo cloudkms.cryptoKeyEncrypterDecrypter mancante per l'utente o
l'account di servizio che stai utilizzando per eseguire operazioni sulle istanze Cloud SQL
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à stato 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. Consulta Creare 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. it 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 Creare 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 appropriate. | Riattiva la versione della chiave e concedi il ruolo cloudkms.cryptoKeyEncrypterDecrypter
all'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 a fare così… |
|---|---|---|
| La nuova crittografia 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 è disabilitata o non concede le autorizzazioni corrette. | Riattiva la versione della chiave Cloud KMS: Nel progetto Google Cloud che ospita la chiave, verifica che il ruolo |
| 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 Ricriptare un'istanza o una replica abilitata per CMEK esistente |