Connettiti utilizzando un client MySQL

MySQL   |  PostgreSQL   |  SQL Server

Puoi utilizzare il client a riga di comando MySQL per connetterti a Cloud SQL. In questa pagina viene descritto come connettere un client mysql alla tua istanza Cloud SQL, in esecuzione localmente sulla tua macchina client, su una VM Compute Engine o in Cloud Shell.

Nota: per informazioni su come connettere un client a un'istanza Cloud SQL utilizzando il proxy di autenticazione Cloud SQL, consulta Collegarsi utilizzando il proxy di autenticazione Cloud SQL. Per informazioni sulla connessione tramite IP privato, consulta Configurare l'IP privato.

Prima di iniziare

Prima di poter utilizzare un client mysql per connetterti all'istanza Cloud SQL, segui questi passaggi:

• Crea un'istanza Cloud SQL, inclusa la configurazione dell'utente predefinito.

  Consulta Creare istanze e Impostare la password per l'account utente predefinito.

• Se vuoi, crea un'istanza VM Compute Engine e connettiti all'istanza tramite SSH.

  Consulta Creare e avviare un'istanza VM, Informazioni sulle connessioni SSH o Connettersi alle VM Windows utilizzando RDP.

• Determina come ti connetterai all'istanza.

  Per le opzioni di connessione e come sceglierle, consulta Informazioni sulle opzioni di connessione.

Utilizzare un client MySQL su una macchina locale o su una VM Compute Engine

L'utilizzo di un client mysql per connettersi all'istanza Cloud SQL comporta tre attività di alto livello:

1. Installa il client.
2. Configura l'accesso all'istanza Cloud SQL.
3. Connettiti all'istanza Cloud SQL.

Installa il client

Per installare il client mysql:

1. Scarica MySQL Community Server per la tua piattaforma dalla pagina di download di MySQL Community Server.
   Il server della community include il client MySQL.
2. Installa Community Server seguendo le istruzioni riportate nella pagina di download.

Per ulteriori informazioni sull'installazione di MySQL, consulta Installazione e upgrade di MySQL.

Configurare l'accesso all'istanza Cloud SQL

Per configurare l'accesso all'istanza:

1. Dalla macchina client o dall'istanza VM Compute Engine, utilizza Qual è il mio indirizzo IP per visualizzare l'indirizzo IP della macchina client.
2. Copia l'indirizzo IP.

3. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

4. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
5. Seleziona Connessioni dal menu di navigazione SQL.
6. Seleziona la scheda Networking.
7. Nella sezione Reti autorizzate, fai clic su Aggiungi rete e inserisci l'indirizzo IP del computer su cui è installato il client.
   Nota: l'indirizzo IP dell'istanza e l'indirizzo IP del cliente mysql che autorizzi devono avere la stessa versione IP: IPv4 o IPv6.
8. Fai clic su Fine. Poi fai clic su Salva in fondo alla pagina per salvare le modifiche.
9. Connettiti all'istanza utilizzando SSL/TLS o senza crittografia (senza utilizzare SSL/TLS).

Connettiti all'istanza Cloud SQL senza crittografia

Attenzione: questa procedura configura una connessione non criptata al database. Se il database contiene dati sensibili, connettiti all'istanza utilizzando SSL/TLS.

Per consentirti di connetterti senza crittografia, la modalità SSL dell'istanza deve essere impostata su ALLOW_UNENCRYPTED_AND_ENCRYPTED. Nella console Google Cloud, la configurazione equivalente è Consenti traffico di rete non criptato.

Per ulteriori informazioni sulla configurazione SSL/TLS dell'istanza, consulta Configurare i certificati SSL/TLS.

Per connetterti all'istanza:

1. Verifica di aver installato il client e configurato l'accesso all'istanza.
2. Avvia il client mysql:

   mysql --ssl-mode=DISABLED --host=INSTANCE_IP_ADDRESS --user=root --password

3. Inserisci la password.
4. Viene visualizzato il prompt mysql.

Connettiti all'istanza Cloud SQL utilizzando SSL/TLS

Nota: se utilizzi l'autenticazione IAM dei database per accedere all'istanza, utilizza la procedura descritta in Accedere a un database con l'autenticazione IAM dei database.

Per connetterti all'istanza utilizzando SSL/TLS e l'autenticazione integrata:

Prima di iniziare, verifica di aver installato il client e di aver configurato l'accesso all'istanza.

1. Avvia il client mysql:

   mysql --ssl-mode=REQUIRED \
      --host=INSTANCE_IP_ADDRESS \
      --user=root --password

   Attenzione: non includere il flag --ssl-mode nel comando se utilizzi un client MariaDB per connetterti all'istanza MySQL. Utilizza il client del server della community MySQL.
2. Inserisci la password.
3. Al prompt di MySQL, inserisci il comando \s per verificare che la connessione utilizzi SSL/TLS.
4. Cerca la riga di output con SSL:.

   ...
   SSL:                     Cipher in use is DHE-RSA-AES256-SHA
   ...
   

   Avviso: le versioni client MySQL precedenti alla 5.7.3 considerano le opzioni --ssl come consigliate e ricorrono silenziosamente alle connessioni non criptate se il server non accetta una connessione criptata. Per ulteriori informazioni, consulta Utilizzo delle connessioni criptate nel Manuale di riferimento di MySQL. Per evitare questo problema, puoi configurare l'istanza in modo che solo le connessioni SSL/TLS possano connettersi (per ulteriori informazioni, consulta Configurazione di SSL per le istanze).

   Per informazioni sulla risoluzione dei problemi di connessione, consulta Eseguire il debug dei problemi di connessione.

Connettiti all'istanza Cloud SQL utilizzando SSL/TLS e la verifica del certificato client

Se ssl_mode nell'istanza Cloud SQL è configurato su TRUSTED_CLIENT_CERTIFICATE_REQUIRED, devi fornire anche un'identità client verificata quando accedi.

Per connetterti utilizzando i certificati SSL/TLS con verifica del client, devi disporre di quanto segue:

• Un certificato di chiave pubblica del client in un file client-cert.pem.
• Una chiave privata del client in un file client-key.pem.

Inoltre, per consentire al client di verificare l'identità del server per l'autenticazione reciproca, specifica il certificato del server server-ca.pem.

Ad esempio, per avviare il client mysql:

    mysql --ssl-mode=VERIFY_CA \
      --ssl-ca=server-ca.pem \
      --ssl-cert=client-cert.pem \
      --ssl-key=client-key.pem \
      --host=INSTANCE_IP_ADDRESS \
      --user=root --password
   

Se non disponi di un certificato client e di una corrispondente chiave privata, crea un nuovo certificato client.

Utilizzo del client in Cloud Shell

Per connetterti a un'istanza Cloud SQL (solo IP pubblico):

1. Vai alla console Google Cloud.

   Vai alla console Google Cloud

2. Fai clic sull'icona Cloud Shell verso destra nella barra degli strumenti.

   L'inizializzazione di Cloud Shell richiede alcuni istanti.

3. Al prompt di Cloud Shell, utilizza il client integrato per connetterti all'istanza Cloud SQL:

   gcloud sql connect INSTANCE_ID \
   --user=root

4. Inserisci la password.

Il comando gcloud sql connect non supporta la connessione a un'istanza Cloud SQL utilizzando un IP privato o SSL/TLS. Per connetterti con crittografia, installa e utilizza il proxy in Cloud Shell:

1. Installa il proxy (Linux a 64 bit) nella directory /home/USER.
2. Avvia il proxy utilizzando l'autenticazione gcloud CLI:

   ./cloud-sql-proxy INSTANCE_CONNECTION_NAME &

3. Connettiti al database utilizzando la connessione TCP:

   mysql -u USERNAME -p --host=127.0.0.1

Passaggi successivi

• Scopri come configurare un'istanza con un indirizzo IP privato.
• Scopri le opzioni per connetterti all'istanza dalla tua applicazione.
• Scopri di più sul mysql client.

Provalo

Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud SQL in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Cloud SQL gratuitamente