Se connecter à une base de données Cloud SQL

Cloud Code permet d'exécuter le proxy d'authentification Cloud SQL pour se connecter à une base de données Cloud SQL, afficher des instances Cloud SQL et créer des sources de données.

Avant de commencer

  • Installez Cloud Code si ce n'est pas déjà fait.

  • Pour créer une source de données, vous pouvez utiliser l'un des IDE JetBrains premium suivants:

  • Vous pouvez également utiliser d'autres outils de base de données de votre choix (tels que DBeaver, MySQL Workbench et SQL Server Management Studio) pour vous connecter aux instances Cloud SQL à l'aide du port local fourni par Cloud Code.

Se connecter à une base de données Cloud SQL à l'aide du proxy d'authentification Cloud SQL

Vous pouvez vous connecter à une base de données Cloud SQL et afficher la liste des instances Cloud SQL dans IntelliJ ou d'autres IDE JetBrains compatibles avec Cloud Code.

Pour vous connecter à une base de données Cloud SQL avec Cloud Code, procédez comme suit:

  1. Dans votre IDE, cliquez sur Google Cloud Databases (Bases de données Google Cloud) dans la barre latérale ou sur View > Tool Windows > Google Cloud Databases (Vue > Fenêtres d'outil > Bases de données Google Cloud).

  2. Si un projet Google Cloud n'est pas déjà sélectionné, cliquez sur Sélectionner un projet Google Cloud et suivez les instructions pour charger votre projet Google Cloud.

    Les instances Cloud SQL de votre Google Cloud projet apparaissent sous Cloud SQL.

    Fenêtre des outils Cloud SQL

  3. Pour vous connecter à une instance Cloud SQL, cliquez avec le bouton droit sur une instance, puis sélectionnez Se connecter à l'aide du proxy Cloud SQL. Vous pouvez également choisir d'utiliser une adresse IP privée en sélectionnant Se connecter à l'aide du proxy Cloud SQL (adresse IP privée).

Pour en savoir plus sur la connexion aux instances SQL, consultez la section À propos des options de connexion.

Créer une source de données

Une fois une connexion via le proxy d'authentification Cloud SQL établie, la boîte de dialogue Instance Cloud SQL connectée s'affiche. Elle vous permet de créer une source de données pour la base de données disponible localement ou d'afficher les sources de données existantes.

  1. Pour créer une source de données, sélectionnez Créer une source de données.

    Vous pouvez également faire un clic droit sur une instance, puis sélectionner Créer une source de données.

    Boîte de dialogue "Sources de données et pilotes"

  2. Dans le champ Authentification, sélectionnez une méthode (par défaut, il s'agit d'un nom d'utilisateur et d'un mot de passe).

  3. Enregistrez la configuration.

    Cloud Code crée une connexion de source de données avec un nom au format suivant:

    gcp-project:location:db-instance-name

    Vous pouvez commencer à utiliser l'instance de base de données via les outils de base de données et les fonctionnalités de plug-in SQL de JetBrains, ou DataGrip.

  4. (Facultatif) Pour afficher la liste des sources de données dans votre IDE, cliquez sur Database (Base de données) dans la barre latérale ou sur View (Affichage) > Tool Windows (Fenêtres d'outils) > Database (Base de données). Effectuer un clic droit sur une source de données vous permet d'afficher une liste d'options, telles que l'affichage de schémas, de tables et d'autres opérations de base de données.

    Options des outils de base de données

    Pour en savoir plus sur l'utilisation des bases de données dans DataGrip, consultez Démarrage rapide avec DataGrip.

Déconnecter le proxy d'authentification Cloud SQL

Pour arrêter le processus de proxy et libérer le port de la base de données locale, dans le terminal, appuyez sur Ctrl+C.

Problèmes connus

Cette section répertorie les problèmes connus et les solutions actuellement disponibles.

Définir un port différent pour se connecter à plusieurs bases de données

Le proxy d'authentification Cloud SQL ne sélectionne pas automatiquement les ports s'ils sont occupés et dépend toujours d'un port, ce qui vous limite à une seule instance connectée d'un certain type de base de données.

Cloud Code exécute le proxy d'authentification Cloud SQL dans le terminal. En cas de conflit de port, vous pouvez définir un port différent pour vous connecter à une base de données en exécutant la même commande dans le terminal avec un indicateur --port personnalisé. Exemple :

--port=PORT_NUMBER

Vous pouvez ensuite utiliser ce port dans votre connexion à la base de données. La commande sera générée automatiquement. Exemple :

path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING

Obtenir de l'aide

Pour envoyer des commentaires ou signaler un problème dans votre IDE IntelliJ, accédez à Outils > Cloud Code > Aide / À propos > Envoyer des commentaires ou signaler un problème pour signaler un problème sur GitHub.