Se connecter à l'aide d'un client de base de données

Cette page explique comment connecter un client mysql, qui s'exécute localement sur votre machine cliente ou dans Cloud Shell, à votre instance Cloud SQL.

Besoin d'aide ? Pour obtenir de l'aide sur le dépannage du proxy, consultez la section Dépannage des connexions via le proxy Cloud SQL. Vous pouvez également consulter notre page Assistance Cloud SQL.

Avant de commencer

Pour pouvoir utiliser un client, vous devez avoir :

Utiliser un client local

L'utilisation d'un client local pour se connecter à votre instance Cloud SQL implique trois tâches de haut niveau :

  1. Installer le client
  2. Configurer l'accès à l'instance Cloud SQL
  3. Se connecter à l'instance Cloud SQL

Installer le client

Pour installer le client, procédez comme suit :

Debian/Ubuntu

Installez le client MySQL depuis le gestionnaire de packages :

sudo apt-get update
sudo apt-get install mariadb-server-10.3

CentOS/RHEL

Installez le client MySQL depuis le gestionnaire de packages :

sudo yum install mysql

openSUSE

Installez le client MySQL depuis le gestionnaire de packages :

sudo zypper install mysql-server

Autres plates-formes

  1. Téléchargez le serveur MySQL Community Server destiné à votre plate-forme sur la page de téléchargement de MySQL Community Server.
    Ce serveur inclut le client MySQL.
  2. Installez le serveur Community Server conformément aux instructions indiquées sur la page de téléchargement.

Pour en savoir plus sur l'installation de MySQL, consultez le chapitre Installing and Upgrading MySQL du manuel de référence MySQL.

Configurer l'accès à l'instance Cloud SQL

Pour configurer l'accès à l'instance :

  1. À partir de la machine cliente, accédez à la page d'identification d'adresse IP pour afficher l'adresse IP de la machine cliente.
  2. Copiez cette adresse IP.
  3. Accédez à la page "Instances Cloud SQL" dans Google Cloud Console.

    Accéder à la page Instances Cloud SQL

  4. Cliquez sur l'instance pour ouvrir la page Vue d'ensemble et notez son adresse IP.
  5. Sélectionnez l'onglet Connexions.
  6. Sous Réseaux autorisés, cliquez sur Ajouter un réseau et saisissez l'adresse IP de la machine sur laquelle le client est installé.
  7. Cliquez sur OK, puis sur Enregistrer en bas de la page pour enregistrer les modifications.
  8. Connectez-vous à l'instance, avec SSL ou sans SSL.

Se connecter à l'instance Cloud SQL sans chiffrement

Pour vous connecter à l'instance, procédez comme suit :

  1. Vérifiez que vous avez installé le client et configuré l'accès à votre instance.
  2. Lancez le client mysql :
    mysql --host=[INSTANCE_IP] --user=root --password
    
  3. Saisissez votre mot de passe.
  4. L'invite mysql s'affiche.

Se connecter à l'instance Cloud SQL à l'aide de SSL

Pour vous connecter avec SSL, vous avez besoin des éléments suivants :

  • Un certificat d'autorité de certification dans un fichier server-ca.pem
  • Un certificat de clé publique du client dans un fichier client-cert.pem
  • Une clé privée du client dans un fichier client-key.pem

Si vous ne disposez pas d'un certificat client et d'une clé privée correspondante, créez un certificat client.

Avant de commencer, vérifiez que vous avez installé le client et configuré l'accès à votre instance.

Pour vous connecter en SSL à l'instance :

  1. Lancez le client mysql :

    mysql --ssl-ca=server-ca.pem --ssl-cert=client-cert.pem --ssl-key=client-key.pem \
                 --host=[INSTANCE_IP] --user=root --password
    

  2. Saisissez le mot de passe.
  3. Lorsque MySQL vous y invite, saisissez la commande \s pour vérifier que votre connexion utilise SSL.
  4. Recherchez la ligne de sortie comprenant SSL:.
    ...
    SSL:                     Cipher in use is DHE-RSA-AES256-SHA
    ...
    

    Pour en savoir plus sur la résolution des problèmes de connexion via IP, consultez la page Diagnostiquer les problèmes liés aux instances Cloud SQL.

Utiliser le client dans Cloud Shell

Pour vous connecter à une instance Cloud SQL, procédez comme suit :

  1. Accédez à Google Cloud Console.

    Accéder à Google Cloud Console

  2. Cliquez sur l'icône Cloud Shell  située à droite dans la barre d'outils.

    L'initialisation de Cloud Shell prend quelques instants.

  3. Lorsque Cloud Shell vous y invite, connectez-vous à l'instance Cloud SQL à l'aide du client intégré.
    gcloud sql connect [INSTANCE_ID] --user=root
    
  4. Saisissez votre mot de passe.

La commande gcloud sql connect ne permet pas de se connecter à une instance Cloud SQL à l'aide de SSL/TLS. Pour vous connecter avec un chiffrement, installez et utilisez le proxy dans Cloud Shell :

  1. Installez le proxy (Linux 64 bits) dans le répertoire /home/USER.
  2. Démarrez le proxy en utilisant l'authentification via le SDK Cloud :

    ./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306 &

  3. Connectez-vous à la base de données à l'aide de la connexion TCP :

    mysql -u USERNAME -p --host 127.0.0.1

Étape suivante