Scegliere come connettersi a Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina fornisce una panoramica dei modi in cui puoi connetterti alla tua istanza Cloud SQL.

Prima di poterti connettere a un'istanza Cloud SQL, devi decidere come eseguire il deployment e configurare l'istanza Cloud SQL e le risorse di networking di supporto. Se l'istanza Cloud SQL è già configurata e ne è stato eseguito il deployment, questa pagina può aiutarti a comprendere i diversi modi in cui puoi connettere i client all'istanza esistente.

Tipo di indirizzo IP: privato o pubblico

Quando crei per la prima volta l'istanza Cloud SQL, puoi scegliere se configurarla con un indirizzo IP pubblico, un indirizzo IP privato o una combinazione di entrambi.

Scegli la configurazione dell'indirizzo IP dell'istanza in base ai requisiti della tua applicazione. Dopo aver configurato l'istanza, specifichi un indirizzo IP pubblico, un indirizzo IP privato o, in alcuni casi, un nome DNS nella stringa di connessione del client.

	Indirizzo IP privato	Indirizzo IP pubblico
Descrizione	Indirizzo IP interno, solo per la rete Virtual Private Cloud (VPC) (privato)	Un indirizzo IP esterno (pubblico) accessibile da internet
Punti decisionali	Devi connetterti da client ospitati su reti VPC all'interno di Google Cloud o da client che hanno accesso a queste reti VPC? In questo caso, scegli un indirizzo IP privato per l'istanza.	Devi connetterti da client esterni alla rete VPC Google Cloudtramite la rete internet pubblica? In caso affermativo, scegli un indirizzo IP pubblico per l'istanza.
Opzioni di configurazione	Sono supportati i seguenti tipi di configurazioni di networking privato: Private Service Connect: connettiti alle istanze Cloud SQL da più reti VPC appartenenti a gruppi, progetti o organizzazioni diversi. Private Service Connect è l'opzione di connettività con IP privato predefinita per i nuovi progetti. Accesso privato ai servizi: connettiti alle istanze Cloud SQL da una singola rete VPC basata sul peering di rete VPC. Per saperne di più sulla scelta di una configurazione di rete privata, consulta Opzioni di configurazione dell'IP privato.	Quando ti connetti direttamente a un'istanza utilizzando un indirizzo IP pubblico, devi configurare le reti autorizzate. Un'altra alternativa più sicura per connettersi a un'istanza Cloud SQL che utilizza un IP pubblico è utilizzare un connettore Cloud SQL (ad esempio il Cloud SQL Auth Proxy o uno dei connettori dei linguaggi di Cloud SQL). Per istruzioni su come aggiungere un IP pubblico alla tua istanza, consulta Configura l'IP pubblico. Per connetterti a un'istanza Cloud SQL utilizzando un indirizzo IP pubblico, puoi utilizzare il client mysql o un altro client disponibile.
Riepilogo	Suggerimento: per una maggiore sicurezza, ti consigliamo di configurare l'istanza con un tipo di indirizzo IP privato, a meno che tu non abbia requisiti specifici per un'istanza Cloud SQL accessibile da internet o se ti connetti da un client che non soddisfa i requisiti per un VPC.

Tipo di connessione: connettore Cloud SQL o diretta

Quando stabilisci la connessione a un'istanza Cloud SQL, puoi utilizzare un connettore Cloud SQL o stabilire una connessione diretta.

Un connettore Cloud SQL è il Cloud SQL Auth Proxy o uno dei connettori dei linguaggi di Cloud SQL.

	Connettore Cloud SQL	Collegamento diretto
Descrizione	Cloud SQL Auth Proxy, un proxy lato client, e i connettori dei linguaggi di Cloud SQL, librerie lato client, forniscono un accesso semplificato e sicuro alle tue istanze Cloud SQL, soprattutto quando ti connetti a un'istanza utilizzando un indirizzo IP pubblico.	Una connessione diretta da un client a un'istanza Cloud SQL fornisce una connessione a latenza inferiore. È possibile stabilire una connessione diretta da un indirizzo IP pubblico o privato.
Punti decisionali	I connettori Cloud SQL sono utili nei seguenti scenari: Quando vuoi connetterti a un'istanza Cloud SQL utilizzando un indirizzo IP pubblico senza dover configurare reti autorizzate. Quando vuoi criptare automaticamente il traffico da e verso il database con la verifica dell'identità del server e del client senza dover gestire i certificati SSL. Quando utilizzi l'autenticazione del database IAM e vuoi aggiornare automaticamente i token di accesso OAuth 2.0. Quando ti connetti da un client o un'applicazione che utilizza un indirizzo IP assegnato dinamicamente o temporaneo. La configurazione IP dinamica può essere comune per le applicazioni Platform as a Service (PaaS).	L'utilizzo di una connessione diretta offre i seguenti vantaggi: Latenza inferiore rispetto alle connessioni che utilizzano i connettori Cloud SQL. Nessuna dipendenza aggiuntiva da pacchetti o librerie, a differenza dei connettori Cloud SQL. Quando utilizzi una connessione diretta, sei responsabile della configurazione delle impostazioni SSL/TLS.
Opzioni di configurazione	Cloud SQL Auth Proxy o Connettori di linguaggio Cloud SQL, tra cui Connettore Java di Cloud SQL Connettore Python di Cloud SQL Connettore Go di Cloud SQL Connettore Node.js di Cloud SQL I seguenti servizi Google Cloud utilizzano un Cloud SQL Auth Proxy incorporato quando ti connetti a un'istanza Cloud SQL tramite un indirizzo IP pubblico: Cloud Run ambiente standard App Engine Ambiente flessibile di App Engine	Per configurare i certificati SSL/TLS sull'istanza Cloud SQL e per il client, segui questi passaggi: Scegli una modalità CA server per l'istanza. Configura l'istanza in modo da applicare la crittografia SSL/TLS per le connessioni nell'istanza. Crea certificati client. Scarica i certificati del server e del client.
Riepilogo	Quando ti connetti a un'istanza Cloud SQL, puoi utilizzare un connettore Cloud SQL o connetterti direttamente dai client. Suggerimento generale: se ti connetti a un'istanza tramite un indirizzo IP privato, utilizza una connessione diretta. Ti consigliamo inoltre di applicare SSL e configurare i certificati SSL/TLS per la tua connessione. Se ti connetti a un'istanza tramite un indirizzo IP pubblico, utilizza un connettore Cloud SQL (il Cloud SQL Auth Proxy o uno dei connettori dei linguaggi di Cloud SQL).

Tipo di autenticazione del database: IAM o integrata

Quando ti connetti a un'istanza, devi eseguire l'autenticazione come utente del database. Puoi scegliere tra l'autenticazione integrata o l'autenticazione IAM del database.

	Autenticazione database IAM	Autenticazione integrata
Descrizione	L'autenticazione IAM dei database consente di autenticarsi ai database con gli account utente e di servizio IAM Google Cloud utilizzando token di accesso di breve durata anziché password. Puoi gestire i privilegi del database utilizzando entità IAM come utenti, service account e gruppi.	L'autenticazione integrata utilizza nomi utente e password locali del database per autenticare gli utenti del database.
Punti decisionali	Preferisci centralizzare la gestione degli utenti nei servizi Google Cloudutilizzando IAM in Google Cloud? In caso affermativo, utilizza l'autenticazione IAM del database.	Hai applicazioni o workflow che dipendono dall'autenticazione del database integrata? In caso affermativo, utilizza l'autenticazione integrata.
Opzioni di configurazione	Puoi utilizzare l'autenticazione del database IAM per singoli utenti IAM, singoli service account e gruppi. Per saperne di più, consulta Gestisci gli utenti con l'autenticazione IAM del database . Se utilizzi un connettore Cloud SQL, questo gestisce l'aggiornamento automatico dei token di accesso IAM. Per saperne di più, consulta Autenticazione automatica del database IAM.	Puoi utilizzare l'autenticazione del database integrata e configurare le policy relative alle password a livello di istanza e di utente. Per saperne di più, consulta Autenticazione integrata.
Riepilogo	Suggerimento: a meno che tu non abbia applicazioni o flussi di lavoro che dipendono dall'autenticazione del database integrata, utilizza l'autenticazione IAM dei database, se possibile.

Rimuovi le opzioni di networking da un'istanza

Cloud SQL supporta la rimozione delle seguenti opzioni di networking da un'istanza:

• IP pubblico da un'istanza con accesso privato ai servizi e IP pubblico
• IP pubblico da un'istanza con IP pubblico, accesso privato ai servizi e Private Service Connect
• Private Service Connect da un'istanza con Private Service Connect e accesso privato ai servizi
• Private Service Connect da un'istanza con Private Service Connect, accesso privato ai servizi e IP pubblico

Attiva le opzioni di networking per un'istanza

Cloud SQL supporta l'attivazione delle seguenti opzioni di connessione per le istanze:

• Accesso privato ai servizi su un'istanza con solo IP pubblico
• Private Service Connect su un'istanza con accesso solo ai servizi privati
• Private Service Connect su un'istanza con accesso privato ai servizi e IP pubblico
• IP pubblico su un'istanza con solo accesso privato ai servizi

Limitazioni

• Non puoi creare un'istanza con un indirizzo IP pubblico e Private Service Connect.
• Non puoi rimuovere l'accesso privato ai servizi da un'istanza con accesso privato ai servizi e Private Service Connect.
• Non puoi rimuovere l'accesso privato ai servizi da un'istanza con accesso privato ai servizi e IP pubblico.
• Se hai un'istanza che utilizza solo un IP pubblico, non puoi abilitare contemporaneamente l'accesso privato ai servizi e Private Service Connect. Innanzitutto, abilita l'accesso privato ai servizi, quindi abilita Private Service Connect.
• Non puoi utilizzare le reti autorizzate per creare una lista consentita basata su indirizzi IP per le istanze Private Service Connect.

Strumenti per la connessione a Cloud SQL

La tabella seguente contiene alcune opzioni per la connessione a Cloud SQL:

Opzione di connessione	Ulteriori informazioni
Cloud SQL Auth Proxy	Informazioni su Cloud SQL Auth Proxy Connessione tramite il proxy di autenticazione Cloud SQL Connessione tramite l'immagine Docker del Cloud SQL Auth Proxy
gcloud CLI	gcloud sql connect
Connettori dei linguaggi di Cloud SQL	Connettiti utilizzando i connettori Cloud SQL per Java, Python e Go.
Cloud Shell	Connessione tramite Cloud Shell
Apps Script	Connessioni esterne con Apps Script Pagina GitHub di esempio di Apps Script
Cloud Code	Connessione tramite Cloud Code nell'IDE JetBrains
Google Cloud Data Agent Kit	Esegui query sui dati
Connettiti utilizzando strumenti di amministrazione di database di terze parti
MySQL Workbench	Connessione con MySQL Workbench
Toad for MySQL	Connessione con Toad for MySQL
SQuirrel SQL	Connessione con SQuirrel SQL
phpMyAdmin	Utilizzo di phpMyAdmin con Cloud SQL su App Engine

Risoluzione dei problemi

Se hai problemi di connessione, consulta le seguenti pagine per assistenza con il debug o per trovare soluzioni a problemi noti:

• Debug dei problemi di connessione
• Errori di connettività noti
• Risoluzione dei problemi di connessione del Cloud SQL Auth Proxy
• Problemi di connessione comuni

Passaggi successivi

• Scopri come connetterti con la guida rapida per Cloud SQL per MySQL.
• Scopri le best practice per la gestione delle connessioni ai database.
• Scopri di più sull'autenticazione IAM del database.
• Scopri come connetterti utilizzando un client mysql da una macchina locale o da Compute Engine.
• Scopri di più sulla configurazione della connettività IP.
• Scopri di più sulla connessione con altri strumenti MySQL.
• Scopri di più sui connettori MySQL.
• Scopri di più sul proxy di autenticazione Cloud SQL.
• Scopri di più sulle opzioni di assistenza.