Messaggi di errore di Cloud SQL per PostgreSQL

Questa pagina descrive 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 di database stessi, altri dal servizio Cloud SQL, altri ancora dalle applicazioni client e alcuni 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 o il messaggio di errore che stai cercando, puoi consultare il materiale di riferimento della fonte qui:

Se non trovi il materiale di riferimento per il messaggio di errore che visualizzi, puoi anche cercare in questi luoghi in cui altri utenti potrebbero avere esperienze pertinenti:

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 --force:

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ò essere causato da diversi motivi. Illegal Argument è uno dei più comuni. In questo caso, la richiesta utilizza l'argomento errato o un valore non valido per l'argomento. Per le molte altre cause, il messaggio di errore potrebbe contenere un suggerimento utile.

Per Illegal Argument, controlla la richiesta per assicurarti che ogni argomento sia consentito e che ogni valore dell'argomento sia valido. Per tutte le altre cause, controlla i file di log per vedere se contengono ulteriori informazioni.

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 --force:

gcloud services vpc-peerings update \
--network=VPC_NETWORK \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force
Connessione reimpostata 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 un'esportazione manuale utilizzando pg_dump.

Constraints/sql.restrictAuthorizedNetworks. L'operazione di clonazione è bloccata dalla configurazione Authorized Networks. Authorized Networks sono configurati per indirizzi IP pubblici nella sezione Connettività della console Google Cloud e la clonazione non è consentita per motivi di sicurezza.

Se possibile, rimuovi tutte le voci Authorized Networks dall'istanza Cloud SQL. In caso contrario, crea una replica senza voci Authorized Networks.

Messaggio di errore Risoluzione dei problemi
Il database user non esiste. gcloud sql connect --user funziona solo con l'utente postgres predefinito.

Connettiti all'utente predefinito e poi cambia utente.

Lo spazio sul disco è esaurito. La dimensione del disco dell'istanza principale può esaurirsi durante la creazione della replica.

Modifica l'istanza principale per eseguire l'upgrade a una dimensione del disco maggiore.

Messaggio di errore Risoluzione dei problemi
Impossibile creare la subnet. Non sono disponibili altri indirizzi nell'intervallo IP.

Impossibile trovare blocchi liberi negli intervalli IP allocati. Assegna nuovi intervalli per questo fornitore di servizi.

Non sono disponibili altri indirizzi nell'intervallo IP allocato.

Considera questi possibili scenari:

  • La dimensione dell'intervallo IP allocato per la connessione al servizio privato è inferiore a /24.
  • La dimensione dell'intervallo IP allocato per la connessione di servizio privato è troppo piccola per il numero di istanze Cloud SQL.
  • Il requisito relativo alle dimensioni dell'intervallo IP allocato sarà maggiore se le istanze vengono create in più regioni. Vedi dimensione dell'intervallo allocato

Per ciascuno degli scenari precedenti, puoi scegliere di espandere l'intervallo esistente o allocare un intervallo IP aggiuntivo alla connessione al servizio privato.

Se stai allocando un nuovo intervallo, fai attenzione a non creare un'allocazione che si sovrapponga 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, fai attenzione ad aumentare solo l'intervallo di allocazione e non a diminuirlo. Ad esempio, se l'allocazione originale era 10.0.10.0/24, la nuova allocazione deve essere almeno 10.0.10.0/23.

In generale, se si parte da un'allocazione /24, diminuire la maschera di 1 per ogni condizione (gruppo di tipi di istanza aggiuntivo, regione aggiuntiva) è una buona regola pratica. Ad esempio, se provi a creare entrambi i gruppi di tipi di istanza 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) Sembra che il tuo client non abbia connettività IPv6 e l'istanza del database non abbia un indirizzo IPv4. Stai tentando di connetterti all'istanza IP privato utilizzando Cloud Shell.

La connessione da Cloud Shell a un'istanza con solo un indirizzo IP privato non è attualmente supportata.

Messaggio di errore Risoluzione dei problemi
Errore interno. Al progetto potrebbe mancare il account di servizio Service Networking necessario per questa funzionalità.

Per riparare le autorizzazioni del servizio, disattiva Service Networking API, attendi cinque minuti e poi riattivalo.

Richiesta non valida: configurazione di Service Networking errata per l'istanza. Service Networking API non è abilitata nel progetto.

Abilita Service Networking API nel tuo progetto. Se visualizzi questo errore quando tenti di assegnare un indirizzo IP privato a un'istanza Cloud SQL e utilizzi un VPC condiviso, devi anche attivare Service Networking API per il progetto host.

Messaggio di errore Risoluzione dei problemi
Associazione di rete non riuscita. Service Networking API non è abilitato nel progetto.

Abilita Service Networking API nel tuo progetto. Se visualizzi questo errore quando tenti di assegnare un indirizzo IP privato a un'istanza Cloud SQL e utilizzi un VPC condiviso, devi anche attivare Service Networking API 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 sono sincrone. Puoi eseguirne solo una alla volta.

Attendi il completamento dell'operazione precedente prima di iniziarne un'altra.

L'operazione non è valida per questa istanza. Questo errore viene restituito da una chiamata API a instances.restoreBackup, e significa che non puoi eseguire il ripristino dal backup a un'istanza con una dimensione dello spazio di archiviazione (XX GB) inferiore alla dimensione del backup (YY GB).

Modifica l'istanza di destinazione per aumentare le dimensioni dello spazio di archiviazione.

Messaggio di errore Risoluzione dei problemi
Autenticazione con password non riuscita per l'utente "postgres". Quando crei una nuova istanza di 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 Google Cloud console.

Messaggio di errore Risoluzione dei problemi
Gli slot di connessione rimanenti sono riservati. È stato raggiunto il numero massimo di connessioni consentite.

Aumenta il valore del flag max_connections. Consulta la sezione Configurazione dei flag di database.

La richiesta non contiene una chiave API valida. Potresti non avere un file JSON della chiave del account di servizio valido o potrebbe non essere archiviato nella posizione prevista.

Verifica di avere un file JSON della chiave account di servizio valido nella posizione archiviata nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS e che la variabile punti alla posizione corretta.

Messaggio di errore Risoluzione dei problemi
Errore SSL: spaziatura interna non valida. Errore del certificato del server.

Crea un nuovo certificato server e ruotalo.

Si è verificato un errore di sistema.
  • L'utente potrebbe non disporre di tutte le autorizzazioni Cloud Storage necessarie.
  • La tabella del database potrebbe non esistere.

Prova a fare queste cose…

  • Verifica di disporre almeno delle autorizzazioni WRITER sul bucket e delle autorizzazioni READER sul file di esportazione. Per saperne di più sulla configurazione del controllo dell'accesso in Cloud Storage, consulta Creare e gestire elenchi di controllo dell'accesso.
  • Assicurati che la tabella esista. Se la tabella esiste, verifica di disporre delle autorizzazioni corrette per il bucket di archiviazione.

Messaggio di errore Risoluzione dei problemi
Definizione della tabella modificata. Durante la procedura di esportazione si è verificata una modifica nella tabella.

L'operazione di dump può non riuscire se utilizzi le seguenti istruzioni durante l'operazione di esportazione:

  • ALTER TABLE
  • CREATE TABLE
  • DROP TABLE
  • RENAME TABLE
  • TRUNCATE TABLE

Rimuovi una qualsiasi di queste istruzioni dall'operazione di dump.

Le dimensioni del file temporaneo superano temp_file_limit. Il flag temp_file_limit è impostato su un valore troppo basso per l'utilizzo del database.

Aumenta le dimensioni di temp_file_limit. Consulta la sezione Configurazione dei flag di database.

(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 essere completato.

Utilizza il formato CSV ed esegui più job di esportazione più piccoli 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.

Abbassa il valore del flag max_connections o contatta l' assistenza clienti per richiedere la rimozione del flag seguita da un hard drain. In questo modo, l'istanza viene riavviata su un host diverso con una nuova configurazione, senza il flag o l'impostazione.

Messaggio di errore Risoluzione dei problemi
Autorizzazione di connessione non concessa. Le cause possono essere molteplici, perché l'autorizzazione avviene a molti livelli:
  • A livello di database, l'utente del database deve esistere e la password deve corrispondere
  • A livello di progetto, l'utente potrebbe non disporre delle autorizzazioni IAM corrette, incluse le autorizzazioni serviceusage.services.use o cloudsql.instances.connect.
  • A livello di rete, se l'istanza Cloud SQL utilizza un IP pubblico, l'IP di origine della connessione deve trovarsi in una rete autorizzata.

Prova a fare queste cose…

  • Assicurati che l'utente esista e che la password corrisponda.
  • Assegna il ruolo Service Usage Consumer all'account utente. Questo ruolo include l'autorizzazione serviceusage.services.use.
  • Se utilizzi l'IP pubblico, assicurati che l'IP di origine si trovi in una rete autorizzata.
Messaggio di errore Risoluzione dei problemi
x509: certificate isn't valid for any names. Problema noto: al momento, Cloud SQL Proxy Dialer non è compatibile con Go 1.15.

Fino alla correzione, consulta questa discussione su GitHub, che include una soluzione alternativa.

Errori sconosciuti

La seguente tabella mostra alcuni casi noti in cui può verificarsi un Unknown Error ed elenca rimedi specifici, ove applicabile. Tuttavia, questo non è un elenco esaustivo. Se non trovi la tua richiesta nella tabella, controlla lo strumento di monitoraggio 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... Cose da provare…
Aggiungi utente Se l'utente esiste già nel database, questo errore può verificarsi quando tenti di 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 una dimensione del disco maggiore.
Clona Ciò può verificarsi quando le risorse nella zona selezionata sono insufficienti. Prova un'altra zona nella regione oppure attendi e riprova più tardi.
Crea istanza
  • Ciò può verificarsi quando tenti di riutilizzare lo stesso nome di un'istanza eliminata di recente.
  • Può anche essere causato da problemi di connettività intermittenti.
  • I log potrebbero mostrare che l'API Service Networking non è abilitata per il progetto.
  • L'errore si è verificato anche durante il tentativo di creare più istanze in parallelo. Ad esempio, gli script Terraform rendono possibile questo tentativo.
  • Un'altra causa può essere l'esaurimento di una risorsa specifica o il superamento di un limite di quota. Cerca nei log una voce simile a Quota 'INTERNAL_FORWARDING_RULES_WITH_TARGET_INSTANCE_PER_NETWORK' exceeded. Limit: 100.0 globally
  • Questo errore può verificarsi se la creazione della subnet non riesce quando non sono disponibili altri indirizzi nell'intervallo IP.
  • I nomi delle istanze non possono essere riutilizzati fino a circa una settimana dopo l'eliminazione.
  • In caso di problemi di connettività intermittenti, l'unica soluzione è riprovare.
  • Abilita l'API Service Networking per il progetto.
  • Gli script di creazione di istanze parallele riusciranno a creare solo una delle istanze. Modifica lo script in modo che attenda il completamento di ogni operazione di creazione dell'istanza prima di passare alla successiva.
  • Alloca nuovi intervalli.
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 è set Service Networking service account as servicenetworking.serviceAgent role on consumer project, disattiva e riattiva Service Networking API. Questa azione crea il account di servizio necessario per continuare la procedura.

Se l'errore è The instance creation failed due to a permission error with the CMEK key defined, controlla le impostazioni della chiave e la posizione.

Esporta Se visualizzi questo messaggio mentre tenti di 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 risponde ancora. In questo caso non è possibile fare nulla. Il failover non si verifica perché non è necessario.
Importa Il file di importazione potrebbe contenere istruzioni che richiedono il ruolo di superutente. Modifica il file per rimuovere tutte le istruzioni che richiedono il ruolo di superutente.

Cloud SQL utilizza anche alcuni binari di terze parti (ad esempio, mysqld), che possono generare messaggi di errore sconosciuti. Questi errori sono interni ai 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.