Connettiti utilizzando un client MySQL

MySQL   |  PostgreSQL   |  SQL Server

Puoi utilizzare il client a riga di comando MySQL per connetterti a Cloud SQL. Questa pagina descrive come connettere un mysql client alla tua istanza Cloud SQL, sia che sia 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 Connessione tramite il proxy di autenticazione Cloud SQL. Per informazioni sulla connessione tramite IP privato, consulta Configura l'IP privato.

Prima di iniziare

Prima di poter utilizzare un client mysql per connetterti alla tua istanza Cloud SQL:

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

  Consulta Crea istanze e Imposta la password per l'account utente predefinito.

• (Facoltativo) Crea un'istanza VM Compute Engine e poi connettiti all'istanza utilizzando SSH.

  Consulta Crea e avvia un'istanza VM, Informazioni sulle connessioni SSH, o Connettiti alle VM Windows utilizzando RDP.

• Determina come ti connetterai all'istanza.

  Per le opzioni di connessione e su come scegliere tra queste, consulta Informazioni sulle opzioni di connessione.

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

L'utilizzo di un client mysql per connetterti alla tua istanza Cloud SQL comporta tre attività di alto livello:

1. Installa il client.
2. Configura l'accesso alla tua istanza Cloud SQL.
3. Connettiti alla tua 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.
   Community Server 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.

Configura l'accesso alla tua istanza Cloud SQL

Per configurare l'accesso all'istanza:

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

3. Nella Google Cloud console, 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 della macchina in cui è installato il client.
   Nota: l'indirizzo IP dell'istanza e l' indirizzo IP del client mysql che autorizzi devono essere della stessa versione IP: IPv4 o IPv6.
8. Fai clic su Fine. Quindi 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 alla tua istanza Cloud SQL senza crittografia

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

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

Per ulteriori informazioni sulla configurazione SSL/TLS della tua istanza, consulta Configura 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 alla tua istanza Cloud SQL utilizzando SSL/TLS

Nota: se utilizzi l'autenticazione IAM dei database per accedere all'istanza, utilizza la procedura descritta in Accedi 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 configurato l'accesso all'istanza.

1. Avvia il client mysql:

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

   Avviso: non includere il --ssl-mode flag nel comando se utilizzi un client MariaDB per connetterti all'istanza MySQL. Utilizza invece il client del server della community MySQL.
2. Inserisci la password.
3. Al prompt 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 del client MySQL precedenti alla 5.7.3 considerano le opzioni --ssl come consigliate e tornano 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 Risolvere i problemi di connessione.

Connettiti alla tua istanza Cloud SQL utilizzando SSL/TLS e la verifica del certificato client

Se ssl_mode nella tua 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 la verifica del client, hai bisogno di:

• Un certificato di chiave pubblica client in un file client-cert.pem.
• Una chiave privata 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 hai un certificato client e una chiave privata corrispondente, allora crea un nuovo certificato client.

Utilizzare il client in Cloud Shell

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

1. Vai alla Google Cloud console.

   Vai alla console Google Cloud

2. Fai clic sull'icona di Cloud Shell a 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 alla tua 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 l'IP privato o SSL/TLS. Per connetterti con la 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 senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Cloud SQL senza costi