Questa pagina illustra alcuni dei messaggi di errore riscontrati in Cloud SQL.
Panoramica
I messaggi di errore in Cloud SQL provengono da molte fonti e vengono visualizzati in molti punti. Alcuni messaggi di errore provengono dai motori del database, altri dal servizio Cloud SQL, altri dalle applicazioni client e altri ancora vengono restituiti dalle chiamate all'API Cloud SQL Admin.
Questa pagina include alcuni degli errori più comuni riscontrati in Cloud SQL. Se non trovi il codice di errore o il messaggio che stai cercando qui, puoi consultare il materiale di riferimento di origine qui:
Se non trovi il materiale di riferimento per il messaggio di errore che visualizzi, puoi anche cercare in alcuni di questi luoghi in cui altri utenti potrebbero avere un'esperienza pertinente:
- Domande su Cloud SQL su Stack Overflow
- Issue Tracker pubblico per Cloud SQL
- DBA Stack Exchange
- Gruppo di discussione di Cloud SQL
- Google Cloud Community di Slack
- Google Cloud su Reddit
Errori operativi
A | B | C | D | E | F | G | I | L | M | N | O | P | Q | R | S | T | U | W
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Intervallo IP allocato non trovato nella rete. | I peering VPC non sono stati aggiornati dopo la modifica o la rimozione di un intervallo allocato.
Devi
modificare la connessione privata. Utilizza il seguente comando e assicurati di utilizzare l'argomento gcloud services vpc-peerings update \ --network=VPC_NETWORK \ --ranges=ALLOCATED_RANGES \ --service=servicenetworking.googleapis.com \ --force |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Richiesta errata. | Questo messaggio può avere molte cause. Illegal Argument è uno dei più comuni. In questo caso, la richiesta utilizza l'argomento sbagliato o un valore non valido per l'argomento. Per le molte altre cause, il messaggio di errore potrebbe contenere un suggerimento utile.
Per |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Impossibile modificare gli intervalli allocati in CreateConnection. Utilizza UpdateConnection. | I peering VPC non sono stati aggiornati dopo la modifica o la rimozione di un intervallo allocato.
Devi modificare la connessione privata.
Utilizza il seguente comando e assicurati di utilizzare l'argomento gcloud services vpc-peerings update \ --network=VPC_NETWORK \ --ranges=ALLOCATED_RANGES \ --service=servicenetworking.googleapis.com \ --force |
| Connessione ripristinata dal peer. | Se stai tentando di eseguire un'esportazione e Cloud Storage non riceve dati entro un determinato periodo di tempo, la connessione viene reimpostata. Prova a eseguire un'esportazione manuale utilizzando |
| constraints/sql.restrictAuthorizedNetworks. | L'operazione di clonazione è bloccata dalla configurazione Authorized Networks. Authorized Networks
sono configurati per gli indirizzi IP pubblici nella sezione Connettività della console Google Cloud e la clonazione non è consentita per considerazioni di sicurezza.
Se possibile, rimuovi tutte le voci |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
Il database user non esiste. |
gcloud sql connect --user funziona solo con l'utente postgres predefinito.
Connettiti con l'utente predefinito e poi cambia utente. |
| Lo spazio sul disco è esaurito. | Le dimensioni del disco dell'istanza principale possono raggiungere la capacità massima durante la creazione della replica.
Modifica l'istanza principale per eseguire l'upgrade a un disco di dimensioni maggiori. |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Impossibile creare la subnet. | Non sono più disponibili indirizzi nell'intervallo IP.
Impossibile trovare blocchi liberi negli intervalli IP allocati. Alloca nuovi intervalli per questo provider di servizi. Non sono più disponibili indirizzi nell'intervallo IP allocato. Prendi in considerazione questi possibili scenari:
Per ciascuno degli scenari elencati in precedenza, puoi scegliere di espandere l'intervallo esistente o di allocare un intervallo IP aggiuntivo alla connessione di servizi privati. Se stai allocando un nuovo intervallo, assicurati di non creare un'allocazione che si sovrappone a quelle esistenti. Dopo aver creato un nuovo intervallo IP, aggiorna il peering VPC con il seguente comando: gcloud services vpc-peerings update \ --service=servicenetworking.googleapis.com \ --ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \ --network=VPC_NETWORK \ --project=PROJECT_ID \ --force Se stai espandendo un'allocazione esistente, assicurati di aumentare solo l'intervallo di allocazione e non di diminuirlo. Ad esempio, se l'allocazione originale era 10.0.10.0/24, imposta la nuova allocazione almeno su 10.0.10.0/23. In generale, se inizi da un'allocazione /24, diminuire la /maschera di 1 per ogni condizione (gruppo di tipi di istanze aggiuntivo, regione aggiuntiva) è una buona regola generale. Ad esempio, se provi a creare entrambi i gruppi di tipi di istanze nella stessa allocazione, è sufficiente passare da /24 a /23. Dopo aver espanso un intervallo IP esistente, aggiorna il peering VPC con il seguente comando: gcloud services vpc-peerings update \ --service=servicenetworking.googleapis.com \ --ranges=RESERVED_RANGE_NAME \ --network=VPC_NETWORK \ --project=PROJECT_ID \ --force |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| (gcloud.sql.connect) It seems your client does not have ipv6 connectivity and the database instance does not have an ipv4 address. | Stai tentando di connetterti alla tua istanza con IP privato utilizzando Cloud Shell.
La connessione da Cloud Shell a un'istanza con un solo indirizzo IP privato non è supportata. |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Errore interno. | Nel progetto potrebbe mancare il service account Service Networking richiesto per questa funzionalità.
Puoi creare manualmente il account di servizio seguendo le istruzioni riportate in Crea e concedi ruoli agli agenti di servizio. |
| Richiesta non valida: configurazione di Service Networking non corretta per l'istanza. | L'API Service Networking non è abilitata nel progetto.
Abilita l'API Service Networking nel tuo progetto. Se visualizzi questo errore quando provi ad assegnare un indirizzo IP privato a un'istanza Cloud SQL e utilizzi un VPC condiviso, devi anche abilitare l'API Service Networking per il progetto host. |
| L'istanza non è idonea per la creazione di repliche. | L'istanza principale non soddisfa i requisiti necessari per la replica. Per un elenco dei requisiti, consulta Limitazioni della replica. |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Associazione di rete non riuscita. | L'API Service Networking non è abilitata nel progetto.
Abilita l'API Service Networking nel tuo progetto. Se visualizzi questo errore quando provi ad assegnare un indirizzo IP privato a un'istanza Cloud SQL e utilizzi un VPC condiviso, devi anche abilitare l'API Service Networking per il progetto host. |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Operazione non riuscita perché è già in corso un'altra operazione. | La maggior parte delle operazioni in Cloud SQL è sincrona. Puoi
eseguirne solo uno alla volta.
Attendi il completamento dell'operazione precedente prima di avviarne un'altra. |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Autenticazione tramite password non riuscita per l'utente "postgres". | Quando crei una nuova istanza Cloud SQL per PostgreSQL, viene creato l'utente amministratore predefinito postgres, ma non la password.
Devi impostare una password per questo utente prima che possa accedere. |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Quota superata. | Hai raggiunto il limite della quota al minuto o giornaliera. Esamina le quote e i limiti per Cloud SQL.
Richiedi un aumento delle quote dalla consoleGoogle Cloud . |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Gli slot di connessione rimanenti sono prenotati. | È stato raggiunto il numero massimo di connessioni consentite.
Aumenta il valore del flag |
| La richiesta non contiene una chiave API valida. | Potresti non avere un file JSON della chiave dell'account di servizio valido o potrebbe non essere archiviato nella posizione prevista.
Verifica di avere un file JSON della chiave dell'account di servizio valido nella posizione memorizzata nella variabile di ambiente |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Errore SSL: spaziatura interna non valida. | Errore del certificato del server.
Crea un nuovo certificato server ed esegui la rotazione. |
| Si è verificato un errore di sistema. |
Prova queste azioni…
|
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Definizione della tabella modificata. | Durante il processo di esportazione si è verificata una modifica nella tabella.
La transazione di dump può non riuscire se utilizzi le seguenti istruzioni durante l'operazione di esportazione:
Rimuovi una di queste istruzioni dall'operazione di dump. |
| Le dimensioni del file temporaneo superano il limite temp_file_limit. | Il flag temp_file_limit è impostato su un valore troppo basso per l'utilizzo del database.
Aumenta le dimensioni di |
| (Timeout) durante l'esportazione. | I formati CSV e SQL vengono esportati in modo diverso. Il formato SQL include l'intero database e probabilmente richiederà più tempo per il completamento.
Utilizza il formato CSV ed esegui più job di esportazione di dimensioni ridotte per ridurre le dimensioni e la durata di ogni operazione. |
| Troppe connessioni. | L'impostazione di un valore troppo alto per il flag max_connections può causare questo errore. Questo può anche essere causato dall'attivazione di un flag fuori sequenza.
Riduci il valore del flag |
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| Non hai l'autorizzazione per connetterti. | Le cause possono essere molte, perché l'autorizzazione avviene a molti livelli:
Prova queste azioni…
|
| Messaggio di errore | Risoluzione dei problemi |
|---|---|
| x509: il certificato non è valido per nessun nome. | Problema noto: il Cloud SQL Proxy Dialer non è attualmente compatibile con Go 1.15.
Fino alla risoluzione, consulta questa discussione su GitHub, che include una soluzione alternativa. |
Errori sconosciuti
La tabella seguente mostra alcuni casi noti in cui può verificarsi un Unknown Error ed elenca i rimedi specifici, se applicabili. Tuttavia, questo elenco non è esaustivo. Se non trovi il tuo caso nella tabella, consulta il tracker dei problemi pubblici per Cloud SQL.
Se non trovi il problema, valuta la possibilità di inviare una segnalazione o di esaminare altre opzioni di assistenza.
| Operazione | Il problema potrebbe essere… | Da provare… |
|---|---|---|
| Aggiungi utente | Se l'utente esiste già nel database, questo errore può verificarsi quando provi ad aggiungerlo. | Controlla che l'utente non esista già nel database. |
| Backup | Se visualizzi questo messaggio durante i backup automatici o manuali, è probabile che il disco dell'istanza sia pieno. | Se le dimensioni del file temporaneo occupano troppo spazio, puoi riavviare l'istanza per rimuovere il file e liberare spazio su disco. In caso contrario, potrebbe essere necessario eseguire l'upgrade dell'istanza a un disco di dimensioni maggiori. |
| Clona | Questo può accadere quando c'è una carenza di risorse nella zona selezionata. | Prova un'altra zona della regione o attendi e riprova più tardi. |
| Crea istanza |
|
|
| Crea replica | È probabile che nei file di log sia presente un errore più specifico. |
Esamina i log in Cloud Logging per trovare l'errore effettivo. Se l'errore è Se l'errore è |
| Esporta | Se visualizzi questo messaggio mentre provi a esportare un database in un bucket Cloud Storage, il trasferimento potrebbe non riuscire a causa di un problema di larghezza di banda. | L'istanza Cloud SQL potrebbe trovarsi in una regione diversa rispetto al bucket Cloud Storage. La lettura e la scrittura di dati da un continente all'altro comportano un utilizzo elevato della rete e possono causare problemi intermittenti come questo. |
| Failover (automatico) | Un'operazione di failover automatico può generare questo messaggio di errore quando il servizio rileva che l'istanza principale è ancora reattiva. | In questo caso non è necessario fare nulla. Il failover non verrà eseguito perché non è necessario. |
| Importa | Il file di importazione potrebbe contenere istruzioni che richiedono il ruolo di super utente. | Modifica il file per rimuovere eventuali istruzioni che richiedono il ruolo di super utente. |
Cloud SQL utilizza anche alcuni file binari di terze parti (ad esempio mysqld), che possono generare messaggi di errore sconosciuti. Questi errori sono interni ai file binari di terze parti e non rientrano nell'ambito di Cloud SQL.
Tuttavia, a volte è possibile trovare un errore più specifico nei file di log di Cloud SQL all'incirca nello stesso momento.
Inoltre, a volte si tratta di un codice di errore sconosciuto. In questo caso,
il messaggio completo può essere Unknown Error Code.