Gérer vos données à l'aide de Cloud SQL Studio

Cette page explique comment explorer et gérer vos données Cloud SQL à l'aide de Cloud SQL Studio dans la console Google Cloud.

Cloud SQL Studio permet aux utilisateurs autorisés d'interagir directement avec la base de données SQL et d'exécuter des requêtes SQL à partir de la console Google Cloud pour accéder aux données et les manipuler. Vous pouvez effectuer diverses actions, comme vous le feriez sur un client de ligne de commande SQL, telles que la création de tables et d'index, la modification de tables ou la configuration de vues.

Cloud SQL Studio comprend un volet Explorateur qui s'intègre à un éditeur de requêtes et à une table de résultats de requête SQL. Vous pouvez exécuter des instructions LDD, LMD et DQL à partir de cette interface. Par exemple, au lieu de configurer un éditeur de requêtes de base de données tiers, vous pouvez créer une table et interroger vos données à l'aide de l'éditeur de requête dans Cloud SQL Studio.

Vous pouvez utiliser le volet Explorateur pour afficher les objets de votre base de données et interagir avec eux. Vous créez, modifiez et supprimez les objets de base de données, tels que les suivants :

  • Tables
  • Colonnes
  • Index et clés
  • Fonctions

Vous pouvez également utiliser le volet Explorateur afin d'alimenter les requêtes SELECT pour les tables.

Si vous débutez avec Cloud SQL, consultez la page Présentation de Cloud SQL.

Rôles et autorisations requis

Pour obtenir les autorisations nécessaires pour effectuer les tâches de ce document, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Cloud SQL (roles/cloudsql.studioUser) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Pour utiliser Cloud SQL Studio, vous devez disposer des autorisations suivantes :

  • cloudsql.databases.list
  • cloudsql.instances.executeSql
  • cloudsql.instances.get
  • cloudsql.instances.login (obligatoire uniquement si vous utilisez l'authentification IAM pour les bases de données)
  • cloudsql.users.list

En outre, assurez-vous de disposer des autorisations au niveau de la base de données que vous utilisez pour l'authentification, ainsi que du mot de passe de l'utilisateur de base de données privilégié que vous utiliserez.

S'authentifier auprès de Cloud SQL Studio

Avant de pouvoir accéder à une base de données dans Cloud SQL Studio, vous devez d'abord sélectionner une méthode d'authentification de la base de données. Pour vous connecter à votre base de données à l'aide de Cloud SQL Studio, vous pouvez utiliser l'un des types d'authentification suivants:

Explorer des données

Pour accéder au volet Explorateur, procédez comme suit :

  1. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Sélectionnez une instance dans la liste.
  3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.
  4. Connectez-vous à Cloud SQL Studio à l'aide du nom de votre base de données, de votre nom d'utilisateur et de votre mot de passe. Le volet Explorateur affiche la liste des objets de votre base de données.

Créer, modifier et interroger vos données

L'éditeur SQL vous permet d'exécuter une combinaison d'instructions LDD, LMD et DQL. Vous pouvez composer une requête vous-même ou insérer un modèle dans l'éditeur de requête à l'aide de l'explorateur.

Pour structurer, modifier ou interroger vos données, procédez comme suit :

  1. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Sélectionnez une instance dans la liste.
  3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.
  4. Connectez-vous à Cloud SQL Studio à l'aide du nom de votre base de données, de votre nom d'utilisateur et de votre mot de passe.
  5. Rédigez une requête en utilisant l'une des méthodes suivantes :
    • Pour composer votre propre requête, procédez comme suit :
      1. Ouvrir un nouvel onglet en cliquant sur .
      2. Lorsque l'éditeur de requête s'affiche, rédigez votre requête.
    • Pour composer une requête à partir d'un modèle, procédez comme suit :
      1. Dans le volet Explorateur, à côté d'un objet ou d'une collection de base de données, cliquez sur more_vert Afficher les actions. Une ou plusieurs actions disponibles s'affichent.
      2. Cliquez sur une action. Un modèle est inséré dans l'éditeur de requête.
      3. Remplacez tous les espaces réservés dans le modèle.
  6. Exécutez vos requêtes en utilisant l'une des approches suivantes :
    • Pour exécuter toutes les instructions de l'éditeur de requête, cliquez sur Exécuter.
    • Pour exécuter des instructions spécifiques, sélectionnez-en une ou plusieurs, puis cliquez sur Exécuter la sélection.
  7. Les résultats de vos requêtes s'affichent dans l'onglet Résultats. Si plusieurs ensembles de résultats sont disponibles, sélectionnez un résultat dans la liste déroulante Tous les résultats.

Limites

  • Cloud SQL Studio accepte les requêtes légères. Les réponses de plus de 8 Mo peuvent être tronquées. Cloud SQL Studio indique à quel moment les résultats partiels sont renvoyés.
  • Vous ne pouvez exécuter des requêtes que pour des instances Cloud SQL en cours d'exécution.
  • Cloud SQL Studio n'est pas compatible avec les serveurs externes.
  • Les requêtes qui prennent plus de cinq minutes sont annulées. Pour Cloud SQL pour MySQL 5.6 et 5.7, l'expiration du délai des instructions LDD de longue durée peut entraîner un rollback en toute sécurité de fichiers ou de tables orphelins. Faites preuve de prudence avec des requêtes telles que ALTER TABLE sur de grandes tables.
  • Cloud SQL Studio ne maintient pas de connexion à une base de données ouverte une fois l'exécution d'un script SQL terminée. De même, les onglets de l'éditeur ne partagent pas de session commune, et chaque exécution démarre une nouvelle session.
  • Lorsque vous exécutez une combinaison d'instructions LMD, DQL et LDD, seuls les résultats des requêtes DQL sont affichés.
  • La fermeture de votre navigateur ou de votre onglet de navigateur n'interrompt pas l'exécution de la requête dans Cloud SQL Studio. La requête est exécutée jusqu'à ce qu'elle soit terminée ou qu'elle expire.
  • Cloud SQL Studio n'est pas compatible avec l'exécution de requêtes SELECT sur des données BLOB. Si le script SQL génère une colonne BLOB dans la sortie, le script SQL échoue avec une erreur.
  • Les commandes client Cloud SQL pour MySQL ne sont pas compatibles et ne peuvent pas être exécutées dans Cloud SQL Studio.
  • L'utilisateur root n'est pas compatible avec Cloud SQL Studio.
  • Cloud SQL Studio nécessite toujours une base de données, même si Cloud SQL pour MySQL ne nécessite pas de base de données pour se connecter.
  • Les utilisateurs dont les mots de passe sont vides ne sont pas acceptés dans Cloud SQL Studio.
  • USE database n'est avec état que pour l'exécution de la requête active et ne fonctionne pas de la même manière que dans la gcloud CLI.
  • L'utilisateur de la base de données doit être autorisé à se connecter à partir de l'hôte local.

  • Lorsque vous exécutez plusieurs requêtes et que l'une d'elles échoue, la première erreur rencontrée est renvoyée. Certaines instructions du lot avant l'erreur peuvent s'être exécutées correctement. Vous pouvez encapsuler plusieurs requêtes dans une instruction transaction pour éviter ce problème :

    START TRANSACTION;
    YOUR_SQL_STATEMENTS
COMMIT;

    Remplacez les éléments suivants :

    • YOUR_SQL_STATEMENTS : instructions que vous souhaitez exécuter dans le cadre de cette requête