Écrire du code SQL avec l'assistance de Gemini

MySQL | PostgreSQL | SQL Server

Preview — Gemini Code Assist

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Vous pouvez traiter les données à caractère personnel pour cette fonctionnalité comme indiqué dans l'Avenant relatif au traitement des données dans le cloud, sous réserve des obligations et restrictions décrites dans le contrat en vertu duquel vous accédez à Google Cloud. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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

1. Assurez-vous d'avoir configuré Gemini dans les bases de données.
2. Pour effectuer les tâches décrites dans ce document, assurez-vous de disposer des autorisations Identity and Access Management (IAM) nécessaires.
3. 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.

4. 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 VARBINARY(MAX),
     BirthDate  DATETIMEOFFSET
   );
   

   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

Attention : les utilisateurs disposant d'un accès étendu à la base de données peuvent perdre des données lors de l'utilisation de Gemini dans des bases de données. Nous vous recommandons d'utiliser un compte disposant de moins de privilèges sur la base de données lors de l'utilisation de Gemini dans des bases de données.

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

En tant que nouvelle technologie, il se peut que les produits Gemini pour Google Cloud génèrent des résultats qui semblent plausibles, mais qui sont en fait incorrects. Nous vous recommandons de valider toutes les sorties des produits Gemini pour Google Cloud avant de les utiliser. Pour en savoir plus, consultez la page Gemini pour Google Cloud et l'IA responsable.

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.

Remarque : Lorsque vous saisissez une requête pour Gemini dans Cloud SQL, des informations sur le schéma de votre base de données sont incluses avec la requête. Ces métadonnées peuvent inclure des noms de tables et de colonnes, de types de données et de descriptions de colonnes. Les données de votre base de données restent dans Cloud SQL et ne sont pas envoyées à Gemini.

Pour générer du code SQL dans Cloud SQL avec l'assistance de Gemini, procédez comme suit :

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

   Accéder à 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 Explorer affiche la liste des objets de votre base de données.

5. Dans la barre des tâches, cliquez sur pen_sparkGemini pour afficher les fonctionnalités de Gemini dans Cloud SQL.

6. Assurez-vous que la génération de commentaires sur une requête est activée.

7. Pour interroger votre base de données, cliquez sur  Nouvel onglet de l'éditeur SQL.

8. 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'
   
   

   Remarque : Gemini peut suggérer des requêtes différentes chaque fois que vous saisissez la même requête.

9. 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 (ou Command+Right arrow sous macOS), puis cliquez sur Exécuter.
   • 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.

Outil "m'aider à coder"

Pour utiliser l'outil M'aider à coder, procédez comme suit :

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

   Accéder à 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 Explorer affiche la liste des objets de votre base de données.

5. Pour interroger votre base de données, cliquez sur Nouvel onglet.

6. Cliquez sur pen_spark M'aider à coder à côté de l'éditeur de requête.

7. 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');
   

   Remarque : Gemini peut suggérer une syntaxe différente chaque fois que vous saisissez la même requête.

8. 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 :

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

   Accéder à 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 Explorer affiche la liste des objets de votre base de données.

5. Dans la barre des tâches, cliquez sur pen_sparkGemini pour afficher les fonctionnalités de Gemini dans Cloud SQL.

6. Sélectionnez Complétion SQL.

7. Pour interroger votre base de données, cliquez sur  Nouvel onglet de l'éditeur SQL.

8. 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')
   

   Remarque : Gemini peut suggérer des requêtes différentes chaque fois que vous saisissez la même instruction.

9. 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 (ou Command+Right arrow sous macOS), puis cliquez sur Exécuter.
   • 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.

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.

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

   Accéder à 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 Explorer affiche la liste des objets de votre base de données.

5. Pour interroger votre base de données, cliquez sur Nouvel onglet.

6. Dans l'éditeur de requête, collez la requête pour laquelle vous souhaitez obtenir des explications.

7. 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.