Introduzione
In genere, i problemi di connessione rientrano in una delle tre aree seguenti:
- Connessione in corso: riesci a raggiungere l'istanza tramite la rete?
- Autorizzazione in corso: hai l'autorizzazione per connetterti all'istanza?
- Autenticazione: il database accetta le credenziali del tuo database?
Ognuno di questi può essere ulteriormente suddiviso in diversi percorsi di indagine. La seguente sezione include esempi di domande che puoi porre per restringere ulteriormente il problema:
Elenco di controllo per i problemi di connessione
- Connessione in corso...
- IP privato
- Hai abilitato
Service Networking API
per il tuo progetto? - Stai utilizzando un VPC condiviso?
- Il tuo account utente o di servizio dispone delle autorizzazioni IAM necessarie per gestire una connessione di accesso privato ai servizi?
- Per il tuo progetto è configurata una connessione di accesso privato ai servizi?
- Hai allocato un intervallo di indirizzi IP per la connessione privata?
- Gli intervalli di indirizzi IP allocati contengono almeno uno spazio /24 per ogni regione in cui prevedi di creare istanze sqlserver?
- Se stai specificando un intervallo di indirizzi IP allocato per le tue istanze sqlserver, l'intervallo contiene almeno uno spazio /24 per ogni regione in cui prevedi di creare istanze sqlserver in questo intervallo?
- È stata creata la connessione privata?
- Se la connessione privata è stata modificata, sono state aggiornate le vpc-peerings?
- I log VPC indicano errori?
- L'IP della macchina di origine è un indirizzo non RFC 1918?
- IP pubblico
- Il tuo IP di origine è indicato come rete autorizzata?
- I certificati SSL/TLS sono obbligatori?
- Il tuo account utente o di servizio dispone delle autorizzazioni IAM necessarie per connettersi a un'istanza Cloud SQL?
- Autorizzazione in corso...
- Proxy di autenticazione Cloud SQL
- Il proxy di autenticazione Cloud SQL è aggiornato?
- Il proxy di autenticazione Cloud SQL è in esecuzione?
- Il nome di connessione dell'istanza è formato correttamente nel comando di connessione del proxy di autenticazione Cloud SQL?
- Hai controllato l'output del proxy di autenticazione Cloud SQL? Collega l'output a un file o osserva il terminale Cloud Shell da cui hai avviato il proxy di autenticazione Cloud SQL.
- Il tuo account utente o di servizio dispone delle autorizzazioni IAM necessarie per connettersi a un'istanza Cloud SQL?
- Hai abilitato
Cloud SQL Admin API
per il tuo progetto? - Se hai un criterio firewall in uscita, assicurati che consenta le connessioni alla porta 3307 sull'istanza Cloud SQL di destinazione.
- Se ti connetti utilizzando i socket di dominio UNIX, verifica che siano stati creati elencando la directory specificata con -dir quando hai avviato il proxy di autenticazione Cloud SQL.
- Connettori Cloud SQL e codice specifico per il linguaggio
- La stringa di connessione è formata correttamente?
- Hai confrontato il tuo codice con il codice campione per il tuo linguaggio di programmazione?
- Stai utilizzando un runtime o framework per il quale non abbiamo codice campione?
- Se sì, hai cercato nella community materiale di riferimento pertinente?
- Certificati SSL/TLS autogestiti
- Il certificato del server è ancora valido?
- Reti autorizzate
- L'indirizzo IP di origine è incluso?
- Utilizzi un indirizzo IP non RFC 1918?
- Stai utilizzando un indirizzo IP non supportato?
- Errori di connessione
- Sei autorizzato a connetterti?
- Visualizzi errori relativi al limite di connessione?
- L'applicazione chiude le connessioni correttamente?
- Autenticazione
- Autenticazione del database nativo (nome utente/password)
- Visualizzi errori
access denied
? - Il nome utente e la password sono corretti?
Messaggi di errore
Per i messaggi di errore specifici dell'API, consulta la pagina di riferimento Messaggi di errore.
Ulteriore risoluzione dei problemi di connettività
Per altri problemi, consulta la sezione Connettività nella pagina di risoluzione dei problemi.
Problemi di connessione comuni
Verifica che la tua applicazione chiuda correttamente le connessioni
Se vedi errori contenenti "Aborted connection nnnn to db:
", di solito significa che la tua applicazione non interrompe correttamente le connessioni. Anche i problemi di rete possono causare questo errore. L'errore non indica problemi con l'istanza Cloud SQL. Ti consigliamo inoltre di eseguire tcpdump
per ispezionare i pacchetti e individuare l'origine del problema.
Per esempi di best practice per la gestione delle connessioni, consulta Gestione delle connessioni ai database.
Verifica che i certificati non siano scaduti
Se l'istanza è configurata per l'utilizzo di SSL, vai alla pagina Istanze Cloud SQL nella console Google Cloud e apri l'istanza. Apri la pagina Connessioni, seleziona la scheda Sicurezza e assicurati che il certificato del server sia valido. Se è scaduto, devi aggiungere un nuovo certificato e ruotarlo.
Verifica di avere l'autorizzazione per connetterti
Se le connessioni non riescono, verifica di essere autorizzato a connetterti:
- Se hai difficoltà a connetterti utilizzando un indirizzo IP, ad esempio
ti stai connettendo dal tuo ambiente on-premise con il client sqlcmd,
assicurati che l'indirizzo IP da cui ti stai connettendo
sia autorizzato a connettersi
all'istanza Cloud SQL.
Le connessioni a un'istanza Cloud SQL che utilizzano un indirizzo IP privato vengono autorizzate automaticamente per gli intervalli di indirizzi RFC 1918. In questo modo, tutti i client privati possono accedere al database senza passare per il proxy di autenticazione Cloud SQL. Gli intervalli di indirizzi non RFC 1918 devono essere configurati come reti autorizzate.
Per impostazione predefinita, Cloud SQL non apprende le route di subnet non RFC 1918 dal VPC. Devi aggiornare il peering di rete a Cloud SQL per esportare eventuali route non RFC 1918. Ad esempio:
gcloud compute networks peerings update cloudsql-mysql-googleapis-com \ --network=NETWORK \ --export-subnet-routes-with-public-ip \ --project=PROJECT_ID
Ecco il tuo attuale indirizzo IP.
Determina la modalità di avvio delle connessioni
Per visualizzare le informazioni sulle connessioni attuali, connettiti al tuo database ed esegui questo comando:
sp_who go
Le connessioni che mostrano un indirizzo IP, come 1.2.3.4
, si connettono tramite IP.
Le connessioni con cloudsqlproxy~1.2.3.4
utilizzano il proxy di autenticazione Cloud SQL o hanno origine da App Engine. Le connessioni da localhost
possono essere
utilizzate da alcuni processi interni di Cloud SQL.
Limiti di connessione
Non sono previsti limiti QPS per le istanze Cloud SQL. Tuttavia, esistono limiti specifici per connessione, dimensioni e App Engine. Consulta Quote e limiti.
Le connessioni al database consumano risorse sul server e nell'applicazione che si connette. Utilizza sempre buone prassi di gestione delle connessioni per ridurre al minimo l'ingombro dell'applicazione e ridurre la probabilità di superare i limiti di connessione di Cloud SQL. Per ulteriori informazioni, consulta Gestione delle connessioni ai database.
Mostra connessioni e thread
Per vedere i processi in esecuzione sul tuo database, connettiti al database ed esegui questo comando:sp_who go
Per informazioni su come interpretare le colonne restituite da sp_who
, consulta la documentazione di riferimento su SQL Server.
Timeout delle connessioni (da Compute Engine)
Connessioni con timeout dell'istanza Compute Engine dopo 10 minuti di inattività, che può influire sulle connessioni inutilizzate di lunga durata tra la tua istanza Compute Engine e la tua istanza Cloud SQL. Per ulteriori informazioni, consulta Networking e firewall nella documentazione di Compute Engine.
Per mantenere attive le connessioni inutilizzate di lunga durata, puoi impostare il keepalive TCP. I seguenti comandi impostano il valore keepalive TCP su un minuto e rendono permanente la configurazione tra i riavvii delle istanze.
Visualizza il valore tcp_keepalive_time corrente.
cat /proc/sys/net/ipv4/tcp_keepalive_time
Imposta tcp_keepalive_time su 60 secondi e impostalo in modo permanente tra i riavvii.
echo 'net.ipv4.tcp_keepalive_time = 60' | sudo tee -a /etc/sysctl.conf
Applica la modifica.
sudo /sbin/sysctl --load=/etc/sysctl.conf
Visualizza il valore tcp_keepalive_time per verificare che la modifica sia stata applicata.
cat /proc/sys/net/ipv4/tcp_keepalive_time
Strumenti per il debug della connettività
tcpdump
tcpdump
è uno strumento per acquisire pacchetti. Ti consigliamo di eseguire tcpdump
per acquisire e ispezionare i pacchetti tra il tuo host e le istanze Cloud SQL durante il debug dei problemi di connettività.
Individuare l'indirizzo IP locale
Se non conosci l'indirizzo locale del tuo host, esegui il comando ip -br address show
. Su Linux, mostra l'interfaccia di rete,
lo stato dell'interfaccia, l'IP locale e gli indirizzi MAC. Ad esempio:
eth0 UP 10.128.0.7/32 fe80::4001:aff:fe80:7/64
.
In alternativa, puoi eseguire ipconfig
o ifconfig
per visualizzare
lo stato delle interfacce di rete.
Esegui test con Connectivity Tests
Il test di connettività è uno strumento di diagnostica che consente di verificare la connettività tra endpoint della rete. Analizza la tua configurazione e, in alcuni casi, esegue la verifica in fase di runtime. Ora supporta Cloud SQL. Segui queste istruzioni per eseguire test con le istanze Cloud SQL.
Esegui il test della connessione
Puoi utilizzare il client sqlcmd per verificare la tua capacità di connessione dal tuo ambiente locale. Per maggiori informazioni, consulta Connessione del client sqlcmd tramite indirizzi IP e Connessione del client sqlcmd mediante il proxy di autenticazione Cloud SQL.
Determina l'indirizzo IP per l'applicazione
Per determinare l'indirizzo IP di un computer che esegue la tua applicazione in modo da poter autorizzare l'accesso all'istanza Cloud SQL da quell'indirizzo, utilizza una delle seguenti opzioni:
- Se il computer non è protetto da un proxy o un firewall, accedi al computer e utilizza il campo Qual è il mio IP? sito per stabilirne l'indirizzo IP.
- Se il computer è protetto da un proxy o un firewall, accedi al computer e utilizza uno strumento o un servizio come whatismyipaddress.com per determinare il suo vero indirizzo IP.
Porte locali aperte
Per verificare che l'host sia in ascolto sulle porte che ritieni siano, esegui il comando ss -tunlp4
. che indica quali porte
sono aperte e per l'ascolto.
Tutte le attività relative alle porte locali
Utilizza il comando netstat
per visualizzare tutte le attività relative alle porte locali. Ad
esempio, netstat -lt
mostra tutte le porte attualmente attive.
Connettiti all'istanza Cloud SQL utilizzando Telnet
Per verificare se riesci a connetterti all'istanza Cloud SQL utilizzando TCP
, esegui il comando telnet
. Telnet tenta di connettersi all'indirizzo IP e
alla porta che hai fornito.
In caso di esito positivo, vedrai quanto segue:
Trying 35.193.198.159...
Connected to 35.193.198.159.
.
In caso di errore, telnet
si blocca fino a quando non forza la chiusura del tentativo:
Trying 35.193.198.159...
^C.
.
Cloud Logging
Cloud SQL e Cloud SQL utilizzano Cloud Logging. Per informazioni complete, consulta la documentazione di Cloud Logging ed esamina le query di esempio di Cloud SQL.
Visualizza i log
Puoi visualizzare i log per le istanze Cloud SQL e altri progetti Google Cloud, come Cloud VPN o Compute Engine. Per visualizzare i log per le voci di log dell'istanza Cloud SQL:
Console
-
Nella console Google Cloud, vai alla pagina Cloud Logging.
- Seleziona un progetto Cloud SQL esistente nella parte superiore della pagina.
- In Query Builder, aggiungi quanto segue:
- Risorsa: seleziona Database Cloud SQL. Nella finestra di dialogo, seleziona un'istanza Cloud SQL.
- Nomi di log: scorri fino alla sezione Cloud SQL e seleziona i file di log appropriati per la tua istanza. Ad esempio:
- Gravità: seleziona un livello di log.
- Intervallo di tempo: seleziona un intervallo di tempo preimpostato o creane uno personalizzato.
gcloud
Utilizza il comando gcloud logging
per visualizzare le voci di log. Nell'esempio seguente, sostituisci PROJECT_ID
.
Il flag limit
è un parametro facoltativo che indica il numero massimo di voci da restituire.
Indirizzi IP privati
Le connessioni a un'istanza Cloud SQL che utilizzano un indirizzo IP privato vengono autorizzate automaticamente per gli intervalli di indirizzi RFC 1918. Gli intervalli di indirizzi non RFC 1918 devono essere configurati in Cloud SQL come reti autorizzate. Devi inoltre aggiornare il peering di rete a Cloud SQL per esportare eventuali route non RFC 1918. Ad esempio:
gcloud compute networks peerings update cloudsql-sqlserver-googleapis-com
--network=NETWORK
--export-subnet-routes-with-public-ip
--project=PROJECT_ID
Risoluzione dei problemi relativi alla VPN
Consulta la pagina Risoluzione dei problemi di Cloud VPN.