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.

Cloud SQL Studio valide automatiquement la syntaxe lorsque vous saisissez une requête ou sélectionnez une partie d'une requête.

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 Utilisateur Cloud SQL Studio (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 pour 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 :

• Authentification IAM à la base de données. Ce type d'authentification vous permet de vous connecter à votre base de données et à Cloud SQL Studio sans avoir à gérer un mot de passe supplémentaire. Vous pouvez également profiter de l'authentification de groupe IAM et gérer l'accès à la base de données et les droits de plusieurs utilisateurs de votre organisation en même temps.

• Authentification intégrée à la base de données : Vous vous connectez à la base de données dans Cloud SQL Studio à l'aide de votre compte utilisateur et de vos identifiants PostgreSQL.

Explorer des données

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

1. Dans la console Google Cloud , 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 la console Google Cloud , 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 add.
     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. Il n'est pas possible de définir un délai avant expiration de requête plus long à l'aide de SET STATEMENT_TIMEOUT.
• 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.

• Si vous exécutez simultanément plusieurs instructions dans l'éditeur de requête et qu'une ou plusieurs instructions génèrent une erreur, l'exécution de toutes les instructions est annulée et la première erreur rencontrée s'affiche.
• Lorsque Cloud SQL Studio détecte une syntaxe de requête non valide, il génère un journal dans postgres.log. Ces entrées apparaissent sous la forme d'entrées cloudsqladmin et contiennent la requête non valide, la position de l'erreur de syntaxe et un message d'erreur correspondant. Pour supprimer ces journaux de votre vue, configurez des filtres de journaux afin d'exclure la base de données cloudsqladmin, l'utilisateur cloudsqladmin ou les deux.