Ce document explique comment utiliser Gemini dans les bases de données pour une utilisation optimisée par l'IA vous avez besoin d'aide pour effectuer les opérations suivantes dans Spanner:
- Générez des requêtes SQL à l'aide de requêtes en langage naturel.
- Instructions SQL complètes dans l'éditeur de requête
- 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 s'adresse aux administrateurs de bases de données et aux ingénieurs de données qui maîtrisez Spanner, SQL et l'analyse de données. Si vous ne connaissez pas Spanner, consultez la section Créer et interroger une base de données à l'aide de la console Google Cloud.
Avant de commencer
- Assurez-vous d'avoir configuré Gemini dans les bases de données.
- Pour effectuer les tâches décrites dans ce document, assurez-vous de disposer des autorisations Identity and Access Management (IAM) nécessaires.
Dans la console Google Cloud, accédez à la page Spanner.
Sélectionnez une instance dans la liste.
Sélectionnez une base de données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Dans la barre des tâches, cliquez sur pen_spark Gemini pour afficher les fonctionnalités de Gemini dans Spanner.
Sélectionnez les fonctionnalités Gemini que vous souhaitez activer exemple : Complétion SQL et Génération de commentaires sur une requête : Vous pouvez sélectionner et tester des fonctionnalités sans affecter les autres travailler dans votre projet.
Facultatif: Si vous souhaitez suivre les exemples de ce document, créez d'abord la table
Singers
comme décrit dans Créez un schéma pour votre base de données.
Pour désactiver les fonctionnalités de Gemini dans Spanner, répétez suivez ces étapes, puis désélectionnez les fonctionnalités de Gemini pour la désactiver.
Rôles requis
Pour obtenir les autorisations dont vous avez
besoin pour effectuer les tâches de ce document,
demandez à votre administrateur de vous accorder le
Lecteur de bases de données Spanner (roles/spanner.databaseReader
) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
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 ?"
Générer du code SQL dans Spanner avec Gemini , procédez comme suit:
Dans la console Google Cloud, accédez à la page Spanner.
Sélectionnez une instance dans la liste.
Sélectionnez une base de données.
Dans le volet de navigation, cliquez sur Spanner Studio. L'explorateur affiche la liste des objets de votre base de données.
Pour interroger votre base de données, cliquez sur génération SQL est activée.
Nouvel onglet de l'éditeur SQL. Assurez-vous que laPour générer du code SQL, saisissez un commentaire dans l'éditeur de requête avec
--
suivi d'un commentaire sur une seule ligne, puis appuyez surReturn
.Par exemple, si vous saisissez l'invite
-- add a row to table singers
et appuyez surReturn
, puis 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 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'
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.
- Pour accepter le code SQL généré par Gemini, appuyez sur
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 semi-automatique de code assistée par l'IA. Si Gemini est activé, lorsque vous saisissez du texte dans l'éditeur de requête Spanner Studio, Gemini prédit et saisit automatiquement le code SQL.
Suggestions de code intégré
Pour utiliser les suggestions de code intégrées, procédez comme suit :
Dans la console Google Cloud, accédez à la page Spanner.
Sélectionnez une instance dans la liste.
Sélectionnez une base de données.
Dans le volet de navigation, cliquez sur Spanner Studio.
Pour interroger votre base de données, cliquez sur complétion SQL est activée.
Nouvel onglet de l'éditeur SQL. Assurez-vous que laSaisissez 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 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')
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 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.
- Pour accepter le code SQL généré par Gemini, appuyez sur
Outil "m'aider à coder"
Pour utiliser l'outil M'aider à coder, procédez comme suit :
Dans la console Google Cloud, accédez à la page Spanner.
Sélectionnez une instance dans la liste.
Sélectionnez une base de données.
Dans le volet de navigation, cliquez sur Spanner Studio.
Pour interroger votre base de données, cliquez sur
Nouvel onglet.Cliquez sur pen_spark M'aider à coder à côté de l'éditeur de requête.
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');
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 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.
Dans la console Google Cloud, accédez à la page Spanner.
Sélectionnez une instance dans la liste.
Sélectionnez une base de données.
Dans le volet de navigation, cliquez sur Spanner Studio.
Pour interroger votre base de données, cliquez sur
Nouvel onglet.Dans l'éditeur de requête, collez la requête.
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 apparaît dans le volet Gemini.
Étape suivante
- Consultez la Présentation de Gemini pour Google Cloud.
- Découvrez comment Gemini utilise vos données.