Écrire du code SQL avec l'assistance de Gemini

Preview — Gemini in Spanner

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

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

Ce document explique comment utiliser Gemini, un collaborateur de Google Cloud basé sur l'IA, pour vous aider à effectuer les opérations suivantes dans Spanner:

• Générez des requêtes SQL à l'aide d'invites en langage naturel.
• Exécutez les instructions SQL dans l'éditeur de requête.
• Expliquer les requêtes SQL dans l'éditeur de requête

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 Spanner, SQL et l'analyse de données. Si vous débutez avec Spanner, consultez la page Créer et interroger une base de données à l'aide de la console Google Cloud.

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. Dans la console Google Cloud, accédez à la page Spanner.

   Accéder à Spanner

4. Sélectionnez une instance dans la liste.

5. Sélectionnez une base de données.

6. Dans le menu de navigation, cliquez sur Spanner Studio.

7. Dans la barre des tâches, cliquez sur pen_spark Gemini pour afficher les fonctionnalités Gemini dans Spanner.

8. Sélectionnez les fonctionnalités Gemini que vous souhaitez activer, par exemple la complétion SQL et la génération de commentaires sur une requête. Vous pouvez sélectionner et essayer des fonctionnalités sans affecter les autres personnes qui travaillent sur votre projet.

9. Facultatif: Si vous souhaitez suivre les exemples de ce document, commencez par créer la table Singers, comme décrit dans la section Créer un schéma pour votre base de données.

Pour désactiver les fonctionnalités Gemini dans Spanner, répétez ces étapes, puis désélectionnez les fonctionnalités Gemini à désactiver.

Rôles requis

Afin d'obtenir les autorisations nécessaires pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous attribuer le rôle IAM Lecteur de base de données Spanner (roles/spanner.databaseReader) 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.

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 ?"

Remarque :Lorsque vous saisissez une requête pour Gemini dans Spanner, des informations sur le schéma de votre base de données sont incluses dans l'invite. Il peut s'agir de noms de tables et de colonnes, de types de données et de descriptions de colonnes. Votre schéma et vos données de base de données restent dans Spanner et ne sont pas envoyés à Gemini.

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

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

   Accéder à Spanner

2. Sélectionnez une instance dans la liste.

3. Sélectionnez une base de données.

4. Dans le volet de navigation, cliquez sur Spanner Studio. 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 de l'éditeur SQL. Assurez-vous que la génération SQL est activée.

6. Pour générer du code SQL, saisissez un commentaire dans l'éditeur de requête en commençant par -- suivi d'un commentaire sur une seule ligne, puis appuyez sur Return.

   Par exemple, si vous saisissez l'invite -- add a row to table singers et appuyez sur Return, Gemini génère une requête SQL semblable à celle-ci:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Pour poursuivre l'exemple à l'aide de la table Singers, si vous saisissez l'invite -- show all singers born in the 70s, Gemini génère une requête SQL semblable à celle-ci:

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   
   

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

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

   • Pour accepter le code SQL généré par Gemini, appuyez sur Tab, puis cliquez sur Run (Exécuter) pour exécuter le code SQL suggéré.
   • Pour modifier le code SQL généré par Gemini, appuyez sur Tab, modifiez le code SQL, puis cliquez sur Exécuter.
   • Pour ignorer la suggestion, appuyez sur Esc ou continuez de saisir votre texte.

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

Pour vous aider à écrire du code SQL, Gemini dans Spanner fournit des suggestions de saisie automatique assistée par IA. Lorsque Gemini est activé, lorsque vous saisissez du texte dans l'éditeur de requête Spanner Studio, Gemini prédise le code SQL et le remplit automatiquement.

Suggestions de code intégrées

Pour utiliser les suggestions de code intégrées, procédez comme suit :

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

   Accéder à Spanner

2. Sélectionnez une instance dans la liste.

3. Sélectionnez une base de données.

4. Dans le volet de navigation, cliquez sur Spanner Studio.

5. Pour interroger votre base de données, cliquez sur  Nouvel onglet de l'éditeur SQL. Assurez-vous que la complétion SQL est activée.

6. 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 le code SQL suivant: 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 une syntaxe SQL différente chaque fois que vous saisissez la même instruction SQL.

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

   • Pour accepter le code SQL généré par Gemini, appuyez sur Tab, puis cliquez sur Run (Exécuter) pour exécuter le code SQL suggéré.
   • Pour modifier le code SQL généré par Gemini, appuyez sur Tab, modifiez le code SQL, puis cliquez sur Exécuter.
   • Pour ignorer la suggestion, appuyez sur Esc ou continuez de saisir votre texte.

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

   Accéder à Spanner

2. Sélectionnez une instance dans la liste.

3. Sélectionnez une base de données.

4. Dans le volet de navigation, cliquez sur Spanner Studio.

5. Pour interroger votre base de données, cliquez sur le 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, cliquez sur add a row to table singers, puis 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 invite.

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 accepter la nouvelle instruction générée ou 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 utiliser Gemini dans Spanner 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 Spanner.

   Accéder à Spanner

2. Sélectionnez une instance dans la liste.

3. Sélectionnez une base de données.

4. Dans le volet de navigation, cliquez sur Spanner Studio.

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

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

7. Mettez en surbrillance la requête que vous souhaitez expliquer par Gemini, puis cliquez sur spark Expliquer cette requête.

   L'explication SQL s'affiche dans le volet Gemini.

Étapes suivantes

• Consultez la Présentation de Gemini dans Google Cloud.
• Découvrez comment Gemini utilise vos données.
• Découvrez comment analyser vos données dans Google Cloud à l'aide de Gemini.