I connettori Cloud SQL sono librerie che forniscono la crittografia e l'autorizzazione basata su Identity and Access Management (IAM) quando ci si connette a un'istanza Cloud SQL. Non possono fornire un percorso di rete a un'istanza Cloud SQL se non ne è già presente uno.
Altri modi per connettersi a un'istanza Cloud SQL includono l'utilizzo di un client di database o del proxy di autenticazione Cloud SQL. Per saperne di più sulla connessione a un'istanza Cloud SQL, consulta la pagina Informazioni sulle opzioni di connessione.
Questa pagina descrive i seguenti connettori Cloud SQL:
- Connettore Java Cloud SQL
- Il connettore Python per Cloud SQL (apri in Colab)
- Connettore Go di Cloud SQL
- Connettore Node.js Cloud SQL
Vantaggi
L'utilizzo di un connettore Cloud SQL offre i seguenti vantaggi:
- Autorizzazione IAM:utilizza le autorizzazioni IAM per controllare chi o cosa può connettersi alle tue istanze Cloud SQL.
- Comodità:elimina l'obbligo di gestire i certificati SSL, configurare le regole firewall o attivare le reti autorizzate.
Prima di iniziare
- Abilita l'API Cloud SQL Admin.
- Crea un'istanza Cloud SQL, inclusa la configurazione dell'utente predefinito.
Per ulteriori informazioni sulla creazione di istanze, consulta Creare istanze.
Per saperne di più sulla configurazione dell'utente predefinito, vedi Impostare la password per l'account utente predefinito.
- Configura i ruoli e le autorizzazioni necessari per connettersi a un'istanza Cloud SQL.
Configurazione
Java
Il connettore Java Cloud SQL è una libreria che fornisce autorizzazione e crittografia basate su IAM quando ci si connette a un'istanza Cloud SQL. Non può fornire un percorso di rete a un'istanza Cloud SQL se non è già presente.
Installa
Per istruzioni sulla creazione e l'utilizzo dei driver per JDBC e R2DBC con Cloud SQL Java Connector, consulta i seguenti link:
Per esempi di utilizzo di questa libreria nel contesto di un'applicazione, consulta queste applicazioni di esempio.
Autentica
Questa libreria utilizza le credenziali predefinite dell'applicazione per autenticare la connessione al server Cloud SQL.
Per attivare le credenziali localmente, utilizza il seguente comando gcloud:
gcloud auth application-default login
Connettiti a IntelliJ
Per connettere IntelliJ all'istanza Cloud SQL, devi aggiungere la libreria come file JAR con dipendenze nella sezione File aggiuntivi della pagina delle impostazioni del driver. Ad esempio, i file JAR fat precompilati sono disponibili nella pagina Versioni del connettore Java Cloud SQL a questo scopo.
Python
Il connettore Python per Cloud SQL è una libreria che può essere utilizzata insieme a un driver di database per consentire agli utenti con autorizzazioni sufficienti di connettersi a un database Cloud SQL senza dover inserire manualmente gli IP nella lista consentita o gestire i certificati SSL.
Per esempi interattivi di utilizzo del connettore Python di Cloud SQL, apri il notebook del connettore Python di Cloud SQL.
Il driver supportato da MySQL è pymysql.
Installa
Per installare l'ultima release del connettore Python di Cloud SQL, utilizza il comando pip install
e specifica il driver pymysql
per il tuo database:
pip install "cloud-sql-python-connector[pymysql]"
Autentica
Questa libreria utilizza le credenziali predefinite dell'applicazione per autenticare la connessione al server Cloud SQL.
Per attivare le credenziali localmente, utilizza il seguente comando gcloud:
gcloud auth application-default login
Vai
Il connettore Cloud SQL Go è un connettore Cloud SQL progettato per l'utilizzo con il linguaggio Go. Per una maggiore sicurezza, questo connettore utilizza una crittografia TLS 1.3 solida e autenticata manualmente tra il connettore client e il proxy lato server, indipendentemente dal protocollo del database.
Installa
Puoi installare questo repository con go get
:
go get cloud.google.com/go/cloudsqlconn
Node.js
Il connettore Node.js è una libreria progettata per l'utilizzo con il runtime Node.js che consente di connettersi in modo sicuro all'istanza Cloud SQL.
Installa
Puoi installare la libreria con npm install
:
npm install @google-cloud/cloud-sql-connector
Utilizza
Java
Per visualizzare questo snippet nel contesto di un'applicazione web, consulta il file README su GitHub.
Python
Per istruzioni dettagliate sull'utilizzo della libreria, consulta Come utilizzare questo connettore. Visualizza il codice di test della connessione di esempio su GitHub.
Vai
Consulta la sezione Utilizzo per istruzioni dettagliate sull'utilizzo della libreria. Visualizza il codice di test della connessione di esempio su GitHub.
Node.js
Per istruzioni dettagliate sull'utilizzo della libreria, consulta Utilizzo.
Applica
Utilizzando l'applicazione del connettore, puoi forzare l'utilizzo solo del proxy di autenticazione Cloud SQL o dei connettori dei linguaggi di Cloud SQL per connetterti alle istanze Cloud SQL. Con l'applicazione del connettore, Cloud SQL rifiuta le connessioni dirette al database.
Se utilizzi un'istanza abilitata a Private Service Connect, esiste una limitazione. Se per l'istanza è abilitata l'applicazione del connettore, non puoi creare repliche di lettura per l'istanza. Allo stesso modo, se l'istanza ha repliche di lettura, non puoi abilitare l'applicazione del connettore per l'istanza.
gcloud
Per forzare l'utilizzo solo del proxy di autenticazione Cloud SQL o dei connettori dei linguaggi di Cloud SQL per connettersi a un'istanza, utilizza il comando gcloud sql instances patch
:
gcloud sql instances patch INSTANCE_NAME \ --connector-enforcement=REQUIRED
Sostituisci INSTANCE_NAME
con il nome della tua istanza Cloud SQL.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
- INSTANCE_NAME: il nome dell'istanza Cloud SQL
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Corpo JSON della richiesta:
{ "kind": "sql#instance", "name": INSTANCE_NAME, "project": PROJECT_ID, "settings": { "connectorEnforcement": "REQUIRED", "kind": "sql#settings" } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_NAME", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Risoluzione dei problemi
Versioni dei driver
Per evitare incompatibilità, assicurati di utilizzare la versione più recente di Cloud SQL Connectors e del driver del database. Alcune versioni precedenti dei driver non sono supportate.
Percorsi di connessione
I connettori Cloud SQL forniscono l'autorizzazione per le connessioni, ma non forniscono nuovi percorsi di connettività. Ad esempio, per connetterti a un'istanza Cloud SQL utilizzando un indirizzo IP privato, la tua applicazione deve già disporre dell'accesso VPC.
Debug dei problemi di connessione
Per ulteriore assistenza in caso di problemi di connessione, consulta le pagine Risoluzione dei problemi e Debug dei problemi di connessione.
Passaggi successivi
- Consulta la home page del connettore Java per Cloud SQL su GitHub.
- Consulta la home page del connettore Python di Cloud SQL su GitHub.
- Scopri di più sul proxy di autenticazione Cloud SQL.
- Scopri di più su IAM.
- Scopri di più sulle opzioni di assistenza.