Écrire du code SQL avec l'assistance de Gemini

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 :

Gemini n'utilise pas vos requêtes ni ses réponses comme données pour entraîner ses modèles. Pour en savoir plus, consultez la section Utilisation de vos données par Gemini pour Google Cloud.

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

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

Étapes suivantes