Écrire du code SQL avec l'assistance de Gemini

Ce document explique comment utiliser Gemini, un collaborateur optimisé par l'IA dansGoogle Cloud, pour vous aider à effectuer les opérations suivantes dans AlloyDB pour PostgreSQL:

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 AlloyDB, et qui ont une certaine connaissance de SQL et de l'analyse de données. Si vous débutez avec AlloyDB, consultez la présentation d'AlloyDB.

Avant de commencer

  1. Assurez-vous que Gemini Cloud Assist est configuré pour votre Google Cloud compte utilisateur et votre projet.

  2. Facultatif: si vous souhaitez suivre les exemples de ce document, créez la table Singers à l'aide du schéma suivant:

    CREATE TABLE Singers (
  BirthDate  TIMESTAMPTZ,
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo BYTEA
);

    Après avoir créé la table Singers, cliquez sur actualiserActualiser pour mettre à jour le schéma de votre base de données.

Pour désactiver les fonctionnalités Gemini dans AlloyDB, répétez cette étape, puis désélectionnez les fonctionnalités Gemini que vous souhaitez désactiver.

Rôles et autorisations requis

Pour utiliser Gemini avec AlloyDB, vous devez disposer des autorisations suivantes:

  • alloydb.clusters.get
  • alloydb.databases.list
  • alloydb.instances.executeSql
  • alloydb.instances.list
  • alloydb.users.list

Vous pouvez obtenir cette autorisation via le rôle roles/alloydb.admin. Si vous ne disposez pas de ce rôle, contactez l'administrateur de votre organisation pour demander l'accès. Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

En outre, assurez-vous de disposer des autorisations au niveau de la base de données pour la base de données que vous utilisez pour l'authentification.

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, vous devez cliquer sur actualiserActualiser pour mettre à jour votre schéma avant d'utiliser Gemini.

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

  1. Dans la console Google Cloud, ouvrez la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB.

  4. Sélectionnez une base de données et un utilisateur, puis saisissez le mot de passe de l'utilisateur.

  5. Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de votre base de données.

  6. Pour interroger votre base de données, cliquez sur  Nouvel onglet de l'éditeur SQL. Assurez-vous que la génération SQL est activée.

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

    Par exemple, si vous saisissez l'invite -- add a row to table singers et appuyez sur 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, si vous saisissez l'invite -- 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'

  8. 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, ouvrez la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB.

  4. Sélectionnez une base de données et un utilisateur, puis saisissez le mot de passe de l'utilisateur.

  5. Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de votre base de données.

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

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

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

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

Expliquer des instructions SQL dans l'éditeur de requête

Vous pouvez saisir des requêtes en langage naturel pour demander des explications sur les requêtes SQL. Ces explications peuvent 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, ouvrez la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB.

  4. Sélectionnez une base de données et un utilisateur, puis saisissez le mot de passe de l'utilisateur.

  5. Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de votre base de données.

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

  7. Dans l'éditeur de requête, collez la requête.

  8. Mettez en surbrillance la requête que vous souhaitez voir expliquée par Gemini, puis cliquez sur pen_spark Expliquer cette requête.

    L'explication de la requête SQL s'affiche dans la fenêtre Chat de Gemini.

Étape suivante