Écrire du code SQL avec l'assistance de Gemini

Aperçu — Gemini dans Spanner

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

Ce document explique comment obtenir une aide optimisée par l'IA avec Gemini Code Assist pour les opérations suivantes dans Spanner :

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

Remarque : L'aide à la programmation fait partie de Gemini Code Assist et est disponible sans frais jusqu'à ce qu'elle soit incluse dans l'édition Gemini Code Assist Standard. Cette modification sera communiquée ultérieurement. À ce moment-là, vous devrez acquérir une licence pour l'édition Gemini Code Assist Standard afin de continuer à utiliser l'aide à la programmation dans Spanner Studio.

Avant de commencer

1. Facultatif : configurez Gemini Code Assist.

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 Google Cloud console, 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 Spanner Studio, cliquez sur le settings_suggestion Gemini Code Assist bouton pour afficher les fonctionnalités Gemini dans Spanner.

8. Sélectionnez les fonctionnalités Gemini que vous souhaitez activer, par exemple, Génération de requêtes à partir de commentaires. Vous pouvez sélectionner et essayer des fonctionnalités sans affecter les autres personnes travaillant 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 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 que vous souhaitez désactiver.

Rôles 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 Gemini for Google Cloud User (roles/cloudaicompanion.user) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec 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

Cette technologie étant à un stade précoce, 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 vérifier tous les résultats des produits Gemini pour Google Cloud avant de les utiliser. Pour en savoir plus, consultez la page Gemini pouret l'IA responsable. Google Cloud

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 avec la requête. 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 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 Google Cloud console, 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 le Nouvel onglet. Assurez-vous que la génération de code SQL est activée.

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

   Par exemple, si vous saisissez la requête -- add a row to table singers et appuyez sur Return, Gemini génère du code SQL semblable à ce qui suit :

   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 la requête -- show all singers born in the 70s, Gemini génère du code SQL semblable à ce qui suit :

   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 le même prompt.

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 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 poursuivez la saisie.

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 Google Cloud console, 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 voire expliquée par Gemini, et 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 — Gemini Code Assist

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 permet de corriger les erreurs dans vos requêtes Spanner sans avoir à quitter l'éditeur de requête.

Les fonctionnalités optimisées par l'IA de Gemini sont intégrées à Spanner Studio 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 surbrillance les segments de la requête d'origine qui peuvent être à l'origine du problème et fournit un résumé des modifications en langage naturel.
• 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 le besoin de s'appuyer sur des LLM tiers à usage général qui peuvent fournir une aide moins nuancée et exposer vos données à des risques de sécurité potentiels.
• Fournit un dépannage plus rapide et plus efficace pour 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 rôles décrits dans Rôles requis.
• 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 l'éditeur de requête, exécutez votre requête.

   Si la requête contient une erreur, un message d'erreur s'affiche dans une bannière d'erreur en bas de l'éditeur.

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

3. Examinez les modifications suggérées dans la requête et mettez-la à jour si nécessaire.

4. 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 Spanner Studio de la console Google Cloud .
• Les limites actuelles de la fenêtre de contexte de Gemini s'appliquent.

Étape suivante

• Consultez la présentation de Gemini pour Google Cloud overview.
• Découvrez comment Gemini utilise vos données.