Ce document explique comment utiliser Gemini, un collaborateur optimisé par l'IA dans Google Cloud, pour vous aider à effectuer les opérations suivantes dans Cloud SQL Studio :
- Générer des requêtes SQL à l'aide de requêtes en langage naturel
- Saisir des instructions SQL dans l'éditeur de requête
- Expliquer les requêtes SQL dans l'éditeur de requête
Découvrez comment et quand Gemini pour Google Cloud utilise vos données.
Ce document est destiné aux administrateurs de bases de données et aux ingénieurs de données qui connaissent bien SQL, l'analyse de données et Cloud SQL. Si vous débutez avec Cloud SQL, consultez la page Présentation de Cloud SQL.
Avant de commencer
- Assurez-vous d'avoir configuré Gemini dans les bases de données.
- Pour effectuer les tâches décrites dans ce document, assurez-vous de disposer des autorisations Identity and Access Management (IAM) nécessaires.
- Confirmez l'accès à Cloud SQL Studio. Si vous n'avez pas accès à Cloud SQL Studio, consultez la section Rôles et autorisations requis pour Cloud SQL Studio.
Facultatif : pour suivre les exemples de ce document, créez une table
Singers
à l'aide du schéma suivant :CREATE TABLE Singers ( SingerId BIGINT PRIMARY KEY, FirstName VARCHAR(1024), LastName VARCHAR(1024), SingerInfo MEDIUMBLOB, BirthDate DATETIME );
Après avoir créé la table
Singers
, cliquez sur actualiserActualiser pour mettre à jour le schéma de votre base de données.
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.admin
) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Vous devez également disposer de l'autorisation cloudaicompanion.companions.generateChat
pour utiliser Expliquer les instructions SQL dans l'éditeur de requête et cloudaicompanion.companions.generateCode
pour utiliser M'aider à coder.
Générer des requêtes SQL à l'aide de requêtes en langage naturel
Vous pouvez envoyer des commentaires (ou des requêtes) Gemini en langage naturel pour générer des requêtes basées sur votre schéma. Par exemple, vous pouvez inviter Gemini à générer du code SQL en réponse aux requêtes suivantes :
- "Créez une table qui suit les résultats de l'enquête de satisfaction client."
- "Ajoutez une colonne de date appelée "Date de naissance" à la table "Chanteurs"."
- "Combien de chanteurs sont nés dans les années 1990 ?"
Si votre schéma change, par exemple en ajoutant une nouvelle table ou une nouvelle colonne, cliquez sur actualiserActualiser pour mettre à jour votre schéma avant d'utiliser Gemini.
Pour générer du code SQL dans Cloud SQL avec l'assistance de Gemini, procédez comme suit :
Dans la console Google Cloud, accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
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 Explorer affiche la liste des objets de votre base de données.
Dans la barre des tâches, cliquez sur pen_sparkGemini pour afficher les fonctionnalités de Gemini dans Cloud SQL.
Assurez-vous que la génération de commentaires sur une requête est activée.
Pour interroger votre base de données, cliquez sur
Nouvel onglet de l'éditeur SQL.Pour générer du code SQL, saisissez un commentaire dans l'éditeur de requête commençant par
--
suivi d'un commentaire sur une seule ligne, puis appuyez sur Retour ou Entrée.Par exemple, saisissez la requête suivante :
-- add a row to table singers
Appuyez sur la touche Retour ou Entrée. Gemini génère un code SQL semblable à celui-ci :
INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate) VALUES (1, 'Alex', 'M.', '1977-10-16');
Pour continuer l'exemple à l'aide de la table
Singers
, saisissez la requête suivante :-- show all singers born in the 70s
Gemini génère un code SQL semblable à celui-ci :
SELECT * FROM Singers WHERE Singers.BirthDate BETWEEN '1970-01-01' AND '1979-12-31'
Examinez la suggestion SQL et effectuez l'une des actions suivantes :
- Pour afficher les options permettant d'accepter le code SQL généré par Gemini, maintenez le pointeur sur la requête. Les options suivantes s'affichent :
- Accepter : pour accepter la requête suggérée, appuyez sur
Tab
, puis cliquez sur Exécuter. - Accepter le mot : pour accepter partiellement la requête suggérée, appuyez sur
Control
+Right arrow
(ouCommand
+Right arrow
sous macOS), puis cliquez sur Exécuter.
- Accepter : pour accepter la requête suggérée, appuyez sur
- Pour modifier le code SQL d'origine, appuyez sur
Tab
, modifiez le code SQL, puis cliquez sur Exécuter. - Pour ignorer la suggestion, appuyez sur
Esc
ou poursuivez la saisie.
- Pour afficher les options permettant d'accepter le code SQL généré par Gemini, maintenez le pointeur sur la requête. Les options suivantes s'affichent :
Outil "m'aider à coder"
Pour utiliser l'outil M'aider à coder, procédez comme suit :
Dans la console Google Cloud, accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
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 Explorer affiche la liste des objets de votre base de données.
Pour interroger votre base de données, cliquez sur
Nouvel onglet.Cliquez sur pen_spark M'aider à coder à côté de l'éditeur de requête.
Dans la fenêtre M'aider à coder, saisissez une invite de commande. Par exemple, saisissez
add a row to table singers
et cliquez sur Générer.Gemini génère un code SQL semblable à celui-ci :
INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate) VALUES (1, Alex, 'M.', '1977-10-16');
Examinez le code SQL généré et effectuez l'une des actions suivantes :
- Pour accepter le code SQL généré par Gemini, cliquez sur Insérer pour insérer l'instruction dans l'éditeur de requête. Cliquez ensuite sur Exécuter pour exécuter le code SQL suggéré.
- Pour demander à Gemini de générer une nouvelle requête, cliquez sur Modifier. Une fois que vous avez modifié votre invite de commande, cliquez sur Mettre à jour. Vous pouvez ensuite décider d'accepter la nouvelle instruction générée ou d'ignorer la suggestion.
- Pour ignorer la suggestion, fermez la fenêtre M'aider à coder.
Saisir des instructions SQL dans l'éditeur de requête
Pour vous aider à écrire du code SQL, Gemini dans Cloud SQL vous fournit des suggestions de saisie de code assistées par l'IA. Si Gemini est activé, lorsque vous saisissez du texte dans l'éditeur de requête Cloud SQL Studio, Gemini prédit et saisit automatiquement le code SQL.
Pour utiliser les suggestions de code intégrées, procédez comme suit :
Dans la console Google Cloud, accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
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 Explorer affiche la liste des objets de votre base de données.
Dans la barre des tâches, cliquez sur pen_sparkGemini pour afficher les fonctionnalités de Gemini dans Cloud SQL.
Sélectionnez Complétion SQL.
Pour interroger votre base de données, cliquez sur
Nouvel onglet de l'éditeur SQL.Saisissez une requête, et un espace ou un saut de ligne à la fin de la ligne. À mesure que vous saisissez du texte, Gemini affiche des suggestions SQL basées sur les objets compatibles du schéma de la base de données sélectionnée.
Par exemple, pour ajouter une ligne à la table
Singers
, commencez à écrire la requête suivante :INSERT INTO Singers
Gemini suggère un code SQL semblable à celui-ci :
INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate) VALUES (1, 'Marc', 'Singer', '1970-03-24')
Examinez la suggestion SQL et effectuez l'une des actions suivantes :
- Pour afficher les options permettant d'accepter le code SQL généré par Gemini, maintenez le pointeur sur la requête. Les options suivantes s'affichent :
- Accepter : pour accepter la requête suggérée, appuyez sur
Tab
, puis cliquez sur Exécuter. - Accepter le mot : pour accepter partiellement la requête suggérée, appuyez sur
Control
+Right arrow
(ouCommand
+Right arrow
sous macOS), puis cliquez sur Exécuter.
- Accepter : pour accepter la requête suggérée, appuyez sur
- Pour modifier le code SQL d'origine, appuyez sur
Tab
, modifiez le code SQL, puis cliquez sur Exécuter. - Pour ignorer la suggestion, appuyez sur
Esc
ou poursuivez la saisie.
- Pour afficher les options permettant d'accepter le code SQL généré par Gemini, maintenez le pointeur sur la requête. Les options suivantes s'affichent :
Expliquer des instructions SQL dans l'éditeur de requête
Vous pouvez utiliser Gemini dans Cloud SQL pour expliquer les requêtes SQL en langage naturel. Cette explication peut vous aider à comprendre la syntaxe, le schéma sous-jacent et le contexte commercial des requêtes complexes ou longues.
Dans la console Google Cloud, accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
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 Explorer affiche la liste des objets de votre base de données.
Pour interroger votre base de données, cliquez sur
Nouvel onglet.Dans l'éditeur de requête, collez la requête pour laquelle vous souhaitez obtenir des explications.
Mettez en surbrillance la requête que vous souhaitez voire expliquée par Gemini, puis cliquez sur spark Expliquer cette requête.
L'explication de la requête SQL s'affiche dans la fenêtre Chat de Gemini.
Étape suivante
- Consultez la Présentation de Gemini pour Google Cloud.
- Découvrez comment Gemini utilise vos données.
- Découvrez comment analyser vos données dans Google Cloud à l'aide de Gemini.