Écrire du code SQL avec l'assistance de Gemini

Aperçu

Ce produit est couvert par les Conditions des offres pré-DG des Conditions d'utilisation de Google Cloud . Les produits pré-DG (avant disponibilité générale) sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces produits peuvent ne pas être compatibles avec d'autres versions avant disponibilité générale. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour écrire, affiner et comprendre plus rapidement les requêtes SQL dans AlloyDB pour PostgreSQL, vous pouvez utiliser Gemini, un collaborateur optimisé par l'IA dansGoogle Cloud, pour effectuer les tâches suivantes dans AlloyDB Studio :

• Générer des requêtes SQL à l'aide de requêtes en langage naturel
• 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 AlloyDB, et qui ont une certaine expérience 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 compte utilisateur et votre projet Google Cloud .

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 nécessaires

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

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
• cloudaicompanion.companions.generateCode
• cloudaicompanion.instances.generateCode
• serviceusage.services.get ou serviceusage.services.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 que vous utilisez pour l'authentification.

Générer des requêtes SQL à l'aide de requêtes en langage naturel

Cette technologie étant à un stade précoce, il se peut que les produits Gemini pour Google Cloudgénèrent des résultats qui semblent plausibles, mais qui sont en fait incorrects. Nous vous recommandons de vérifier tous les résultats 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, vous devez cliquer sur actualiserActualiser pour mettre à jour votre schéma avant d'utiliser Gemini.

Remarque : Lorsque vous saisissez un prompt, des informations sur le schéma de votre base de données sont incluses avec le prompt. Il peut s'agir de noms de tables et de colonnes, de types de données et de descriptions de colonnes. Le schéma et les données de votre base de données restent dans AlloyDB et ne sont pas envoyés à 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 le prompt -- 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 le prompt -- 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: emini peut suggérer une syntaxe différente chaque fois que vous saisissez le même prompt.

8. Examinez la suggestion SQL et effectuez l'une des actions suivantes :

   Attention : Étant donné que les requêtes en langage de manipulation de données (LMD) et en langage de définition de données (LDD) générées par Gemini peuvent écraser des données, nous vous recommandons de valider les requêtes SQL générées avant de les exécuter.
   • 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 Aide-moi à coder

Pour utiliser l'outil Aide-moi à 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 Aide-moi à coder à côté de l'éditeur de requête.

8. Dans la fenêtre Aide-moi à coder, saisissez un prompt. 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: emini peut suggérer une syntaxe différente chaque fois que vous saisissez le même prompt.

9. Examinez le code SQL généré et effectuez l'une des actions suivantes :

   Attention : Étant donné que les requêtes LMD (langage de manipulation de données) et LDD (langage de définition de données) générées par Gemini peuvent écraser des données, nous vous recommandons de valider les requêtes générées avant de les exécuter.
   • 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 Aide-moi à 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 des 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 astrophotography_mode Expliquer cette requête sélectionnée.

   L'explication de la requête SQL apparaît dans le volet Gemini Cloud Assist.

Utiliser Gemini pour corriger les erreurs dans les requêtes

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Vous pouvez traiter des données à caractère personnel lorsque vous utilisez cette fonctionnalité, comme indiqué dans l'Avenant relatif au traitement des données dans le cloud, sous réserve de respecter les 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 prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Gemini offre une fonctionnalité étendue qui vous aide à corriger les erreurs dans vos requêtes AlloyDB sans avoir à quitter l'éditeur de requête.

Les fonctionnalités optimisées par l'IA de Gemini sont intégrées à l'éditeur de requête pour offrir les avantages suivants :

• Fournit une comparaison ligne par ligne de la requête d'origine à côté d'une nouvelle requête avec les modifications recommandées à l'aide de l'éditeur de requête.
• Met en évidence les segments de la requête d'origine qui peuvent être à l'origine du problème et fournit un résumé en langage naturel des modifications.
• Il fait référence au message d'erreur exact et aux informations de schéma associées à la requête pour fournir des corrections précises et pertinentes.
• Élimine la nécessité de s'appuyer sur des LLM tiers à usage général qui pourraient fournir une aide moins nuancée et exposer vos données à des risques de sécurité potentiels.
• Permet de résoudre plus rapidement et plus efficacement les problèmes courants tels que les erreurs de syntaxe, de schéma et d'exécution.

Autorisations requises

Avant de commencer, vérifiez que vous disposez des autorisations suivantes :

• Les autorisations décrites dans la section Autorisations requises.
• L'autorisation de l'API Gemini pour Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Corriger votre requête à l'aide de Gemini

Pour utiliser les fonctionnalités de Gemini afin de corriger certaines erreurs dans une requête, procédez comme suit :

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

   Accéder à AlloyDB

2. Sélectionnez un cluster dans la liste.

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

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. Dans la barre des tâches, cliquez sur settings_suggestionGemini pour afficher les fonctionnalités de Gemini dans AlloyDB.

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

8. Dans l'éditeur de requête, saisissez une requête qui peut être incorrecte ou incomplète.

9. Cliquez sur Exécuter.

   Si la requête contient un problème, une erreur est renvoyée dans l'onglet Résultats.

10. Cliquez sur Corriger.

    Dans la fenêtre de requête, un éditeur de différences s'ouvre dans l'onglet, affichant une comparaison ligne par ligne de la requête existante avec les modifications recommandées. L'éditeur de requête fournit également un résumé des modifications suggérées.

11. Examinez les modifications suggérées pour la requête et modifiez-les si nécessaire.

12. Pour accepter les modifications et exécuter votre nouvelle requête, cliquez sur Accepter et exécuter.

Limites

• Cette fonctionnalité n'est accessible que dans l'éditeur de requête AlloyDB Studio de la consoleGoogle Cloud .
• Les limites actuelles de la fenêtre de contexte de Gemini s'appliquent.

Étapes suivantes

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