Écrire du code SQL avec l'assistance de Gemini

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

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 la section Créer et interroger une base de données à l'aide de la console Google Cloud.

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 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 de Gemini dans Spanner.

  8. Sélectionnez les fonctionnalités Gemini que vous souhaitez activer, par exemple la génération de requêtes à partir de commentaires. Vous pouvez sélectionner et essayer des fonctionnalités pour vous-même sans affecter les autres personnes qui travaillent sur votre projet.

  9. Facultatif: Si vous souhaitez suivre les exemples de ce document, créez d'abord 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 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 Utilisateur de Gemini pour Google Cloud (roles/cloudaicompanion.user) 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 ?"

Pour générer du code SQL dans Spanner avec l'assistance 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 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 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'

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

  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, puis cliquez sur spark Expliquer cette requête.

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

Étape suivante