Écrire du code SQL avec l'assistance de Gemini

Aperçu — Gemini dans Bigtable

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 utiliser Gemini Code Assist pour obtenir une assistance optimisée par l'IA afin de générer des requêtes SQL à l'aide de requêtes en langage naturel dans Bigtable.

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 Bigtable, SQL et l'analyse de données. Si vous ne connaissez pas Bigtable, consultez le guide de démarrage rapide Créer une instance Bigtable à l'aide de la console. Google Cloud

Remarque : L'assistance au codage 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'assistance au codage dans Bigtable Studio.

Limites

• Vous ne pouvez pas utiliser Gemini dans Bigtable pour expliquer les requêtes SQL en langage naturel.

• Gemini dans Bigtable peut générer des requêtes qui ne sont pas valides dans GoogleSQL pour Bigtable ou des requêtes qui utilisent les instructions ou la syntaxe non compatibles suivantes :

  • Instructions LMD (langage de manipulation de données) autres que SELECT (par exemple, INSERT, UPDATE ou DELETE).
  • Instructions LDD (langage de définition de données) (par exemple, CREATE, ALTER ou DROP).
  • Instructions de contrôle des accès aux données.
  • Syntaxe de requête pour les sous-requêtes, JOIN, UNION et les expressions de table communes.

  Pour en savoir plus, consultez la présentation de GoogleSQL pour Bigtable.

Avant de commencer

1. Activez l'API Gemini for Google Cloud dans un Google Cloud projet.

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. Facultatif : Si vous souhaitez suivre les exemples de ce document, créez et remplissez test-table comme décrit dans Créer une table de test.

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 :

• "Comptez le nombre d'appareils disposant d'un forfait de données de 1 Go."
• "Répertoriez tous les téléphones connectés au Wi-Fi le 1er mai 2019."
• "Quelles tablettes disposent du forfait de données de 10 Go ?"

Remarque : Lorsque vous saisissez une requête pour Gemini dans Bigtable, 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 Bigtable et ne sont pas envoyés à Gemini.

Pour générer du code SQL dans Bigtable avec Gemini, procédez comme suit :

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

   Accéder à Bigtable

2. Sélectionnez une instance dans la liste.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Ouvrez un nouvel onglet en cliquant sur , puis sélectionnez Éditeur.

5. Cliquez sur Generate SQL (Générer SQL).

6. Dans la boîte de dialogue Help me code (M'aider à coder), saisissez votre requête, puis cliquez sur Generate (Générer).

   Par exemple, si vous saisissez la requête Count the number of devices that have a 1GB data plan. (Comptez le nombre d'appareils disposant d'un forfait de données de 1 Go), Gemini génère un code SQL semblable à celui-ci :

   SELECT
       count(*)
   FROM
       `test_table`
   WHERE
       cell_plan['data_plan_01gb'] = 'true'
   

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

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

   • Pour exécuter le code SQL suggéré, cliquez sur Insert (Insérer), puis sur Run (Exécuter).
   • Pour modifier la requête, cliquez sur Edit (Modifier), puis sur Update (Mettre à jour).
   • Pour modifier le code SQL suggéré, cliquez sur Insert (Insérer). Dans le générateur de requêtes, modifiez manuellement la requête, puis cliquez sur Run (Exécuter).

8. Facultatif : Pour continuer l'exemple test_table, si vous saisissez la requête Show all data for phones from May 2019. (Afficher toutes les données des téléphones de mai 2019), Gemini génère un code SQL semblable à celui-ci :

   SELECT
       *
   FROM
       `test_table`
   WHERE
       _key LIKE 'phone#%#201905%'
   

Étape suivante

• Consultez la présentation de Gemini pour Google Cloud overview.