Risoluzione dei problemi

Esegui il comando gcloud sql operations list per elencare tutte le operazioni per l'istanza Cloud SQL specificata.

Cerca nei log e filtra per testo per trovare l'utente. Potresti dover utilizzare i log di controllo per informazioni private. I file di log pertinenti includono:

• cloudsql.googleapis.com/postgres.log
• Se Cloud Audit Logs è abilitato e disponi delle autorizzazioni necessarie per visualizzarli, potrebbe essere disponibile anche cloudaudit.googleapis.com/activity.

Se elimini un'istanza senza eseguire un backup finale dei dati, non è possibile alcun recupero dei dati. Tuttavia, se ripristini l'istanza, Cloud SQL ripristina anche i backup. Per ulteriori informazioni sul recupero di un'istanza eliminata, consulta Conservare i backup dopo l'eliminazione dell'istanza.

Se hai eseguito un'operazione di esportazione, crea una nuova istanza e poi esegui un'operazione di importazione per ricreare il database. Le esportazioni vengono scritte in Cloud Storage e le importazioni vengono lette da lì.

Se hai davvero bisogno di annullare l'operazione, puoi chiedere all' assistenza clienti di force restart l'istanza.

Crea gli utenti del database prima di ripristinare il dump SQL.

Per conservare i backup a tempo indeterminato, puoi creare un backup on demand, in quanto non vengono eliminati come i backup automatici. I backup on demand vengono conservati a tempo indeterminato. ovvero rimangono finché non vengono eliminati o finché non viene eliminata l'istanza a cui appartengono. Poiché questo tipo di backup non viene eliminato automaticamente, può influire sulla fatturazione.

• Potrebbero esserci troppe connessioni aperte. Un numero eccessivo di connessioni può derivare da errori che si verificano nel mezzo di una connessione in cui non sono presenti impostazioni autovacuum per eliminare le connessioni inattive.
• Il ciclo può verificarsi se un codice personalizzato utilizza una logica di ripetizione che non si interrompe dopo alcuni errori.
• Il traffico potrebbe essere troppo elevato. Utilizza il pooling delle connessioni e altre best practice per la connettività.

Tentativi da effettuare

1. Verifica che il database sia configurato per autovacuum.
2. Controlla se nel codice personalizzato è configurata una logica di ripetizione della connessione.
3. Riduci il traffico finché il database non viene ripristinato, poi aumentalo lentamente.

CREATE UNLOGGED TABLE ....

Queste tabelle non sono incluse in un ripristino da un backup:

• I contenuti delle tabelle non registrate non sopravvivono al failover su un'istanza HA.
• Le tabelle non registrate non sopravvivono agli arresti anomali di Postgres.
• Le tabelle non registrate non vengono replicate nelle repliche di lettura.
• Le tabelle non registrate vengono cancellate automaticamente durante il ripristino del backup.

La soluzione è evitare di utilizzare tabelle non registrate se vuoi ripristinarle tramite un backup. Se esegui il ripristino da un database che contiene già tabelle non registrate, puoi eseguire il dump del database in un file e ricaricare i dati dopo aver modificato il file di dump impostando ALTER TABLE su SET LOGGED in queste tabelle.

• Imposta il valore di backup finale in modo che corrisponda alla configurazione di backup esistente dell'istanza.
• Lascia vuoto il campo del backup finale quando elimini l'istanza. Se lasci il campo vuoto, Cloud SQL utilizza la configurazione del backup finale impostata nelle impostazioni dell'istanza per eseguire un backup finale e definirne la conservazione.

Stai tentando di annullare un'operazione di importazione o esportazione completata, non riuscita o annullata. Se l'operazione è in esecuzione, puoi annullarla.

Cloud SQL non supporta l'annullamento dell'operazione perché ha un tipo di operazione diverso da IMPORT o EXPORT.

Al momento Cloud SQL non può annullare l'operazione di importazione o esportazione. Riprova tra qualche secondo. Se il problema persiste, contatta l'Google Cloud assistenza.

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

Stai tentando di utilizzare la console Google Cloud per clonare un'istanza con un indirizzo IP privato, ma non hai specificato l'intervallo IP allocato che vuoi utilizzare e l'istanza di origine non è stata creata con l'intervallo specificato. Di conseguenza, l'istanza clonata viene creata in un intervallo casuale.

Utilizza gcloud per clonare l'istanza e fornire un valore per il parametro
--allocated-ip-range-name. Per saperne di più, consulta Clonazione di un'istanza con un IP privato.

• Instabilità Networking.
• Nessuna risposta ai comandi TCP keep-alive (il client o il server non risponde, probabilmente sovraccarico)
• La durata della connessione del motore del database è stata superata e il server termina la connessione.

Le applicazioni devono tollerare gli errori di rete e seguire le best practice, come il pooling delle connessioni e i nuovi tentativi. La maggior parte dei pool di connessioni rileva questi errori, se possibile. In caso contrario, l'applicazione deve riprovare o non riuscire in modo controllato.

Per il nuovo tentativo di connessione, ti consigliamo i seguenti metodi:

1. Backoff esponenziale. Aumenta l'intervallo di tempo tra un nuovo tentativo e l'altro in modo esponenziale.
2. Aggiungi anche il backoff casuale.

La combinazione di questi metodi contribuisce a ridurre la limitazione.

I tentativi di connessione non riescono a causa di errori generici di timeout o di connessione senza dettagli diagnostici.

Procedura per la risoluzione del problema:

1. Esegui un test di connettività di Network Intelligence Center tra il client di origine e l'IP privato Cloud SQL sulla porta del database (3306 per MySQL, 5432 per PostgreSQL o 1433 per SQL Server). Il test traccia il percorso del pacchetto e identifica se il traffico viene eliminato da regole firewall, route mancanti o configurazioni di peering errate.
2. Verifica che lo stato della connessione di peering di rete VPC sia ACTIVE.
3. Verifica che le regole firewall nella rete VPC consentano il traffico in entrata sulla porta del database.
4. Se utilizzi intervalli di indirizzi non RFC 1918, verifica di aver aggiornato la configurazione di peering per esportare le route di subnet con IP pubblico.

Per ulteriori dettagli e comandi di diagnostica gcloud, consulta Diagnosticare gli errori di connessione IP privato e di rete VPC.

• Operazioni lente per creare accessi Microsoft Entra ID
• Impossibile creare accessi Microsoft Entra ID
• Impossibile connettersi all'istanza utilizzando l'autenticazione Microsoft Entra ID

Per saperne di più su come risolvere questi problemi, consulta la sezione Risoluzione dei problemi di integrazione di Microsoft Entra ID.

I certificati client sono scaduti o il percorso dei certificati non è corretto.

Rigenera i certificati ricreandoli.

La connessione a un'istanza Cloud SQL utilizzando l'autenticazione IAM dei database richiede diversi secondi o si verifica il timeout, mentre l'autenticazione integrata dei database si connette normalmente.

Causa: l'istanza utilizza un tipo di macchina con core condiviso (db-f1-micro o db-g1-small). In caso di limitazione della CPU, l'autenticazione IAM dei database richiede più tempo per essere completata rispetto all'autenticazione con password integrata perché richiede più risorse di calcolo.

Risoluzione:

• Utilizza il pooling delle connessioni o connettiti tramite il proxy di autenticazione Cloud SQL per riutilizzare le connessioni autenticate.
• Aumenta il timeout della connessione client (ad esempio, a 10-15 secondi).
• Modifica l'istanza in modo che utilizzi un tipo di macchina con core dedicati (ad esempio db-custom-* o db-n1-standard-*).

Per saperne di più, vedi Rendimento delle istanze con core condivisi.

Connettiti all'utente predefinito, poi cambia utente.

L'indirizzo host non corrisponde all'indirizzo nei nomi alternativi del certificato del server.

Se utilizzi Node.js con verify-full o il suo equivalente, utilizza il nome DNS per il parametro servername. Il nome DNS può essere trovato nel certificato del server utilizzando openssl. Ad esempio, openssl x509 -in server-cert.pem -noout -text |grep 'DNS:'.

 ssl: {
  rejectUnauthorized: true,
  ca: fs.readFileSync("/path/to/server/CA"),
  servername: 'N-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx.us-central1.sql.goog'
}

La zona selezionata non dispone della capacità per le risorse richieste o il tipo di VM al momento della richiesta di creazione dell'istanza. Al momento della richiesta, potrebbe esserci un'elevata domanda operativa simultanea in quella specifica posizione regionale.

Per risolvere il problema, riprova a creare l'istanza in un'altra zona o riprova a creare l'istanza nella stessa zona che ha ricevuto l'errore in un altro momento della giornata.

• La dimensione dell'intervallo IP allocato per la connessione di 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 dimensioni dell'intervallo allocato

Per risolvere il problema, puoi espandere l'intervallo IP allocato esistente o allocare un intervallo IP aggiuntivo alla connessione di servizio privato. Per saperne di più, consulta Allocare un intervallo di indirizzi IP.

Se hai utilizzato il flag --allocated-ip-range-name durante la creazione dell'istanza Cloud SQL, puoi espandere solo l'intervallo IP specificato.

Se stai allocando un nuovo intervallo, assicurati che l'allocazione non 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, ridurre 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
    

Abilita l'API Service Networking utilizzando il seguente comando e prova a creare di nuovo l'istanza Cloud SQL.

gcloud services enable servicenetworking.googleapis.com