Écrire du code LookML avec l'aide de Gemini

Cette page de documentation explique comment utiliser l'assistance Gemini pour créer des dimensions, des groupes de dimensions et des mesures dans un projet LookML. La génération de suggestions de code LookML en réponse à des requêtes écrites est une fonctionnalité Gemini dans Looker disponible dans les instances Looker (version initiale) et Looker (Google Cloud Core).

Gemini dans Looker fournit une assistance optimisée par l'IA générative pour vous aider à exploiter vos données.

Découvrez comment et quand Gemini pour Google Cloud utilise vos données.

Cette page est destinée aux développeurs Looker.

Avant de commencer

Pour utiliser Gemini dans l'IDE Looker, vous devez remplir les conditions suivantes :

  • Gemini dans Looker doit être activé pour votre instance Looker :
  • Vous devez disposer d'un rôle Looker incluant l'autorisation develop pour au moins un modèle dans un projet LookML.
  • Vous devez disposer du rôle Looker Gemini.

Utiliser Gemini dans l'IDE Looker

Pour utiliser Gemini afin de créer du code LookML dans votre projet Looker, procédez comme suit :

  1. Sur votre instance Looker, activez le mode Développement.
  2. Ouvrez votre projet dans l'IDE Looker.
  3. Utilisez l'explorateur de fichiers de l'IDE pour ouvrir un fichier d'affichage LookML dans lequel vous souhaitez insérer du code LookML.

  4. Sélectionnez l'icône M'aider à coder dans le sélecteur du panneau latéral.

    IDE Looker avec l'icône M'aider à coder mise en évidence.

  5. Une fois le panneau M'aider à coder ouvert, cliquez pour placer votre curseur sur une ligne de votre fichier de vue LookML. En fonction du type de fichier LookML et de l'emplacement du curseur dans le fichier, Gemini fournit des options appropriées pour vous guider, telles que Créer une dimension ou Créer une mesure.

  6. Sélectionnez l'une des options suivantes dans le panneau M'aider à coder :

    • Créer un groupe de dimensions
    • Créer une dimension
    • Créer une mesure
    • Autre suggestion de code : vous pouvez utiliser l'option Autre suggestion de code si vous souhaitez essayer différents éléments LookML. N'oubliez pas que Gemini est une technologie qui en est encore à un stade précoce. Validez et testez donc tous les résultats avant de les déployer.

  7. Dans le champ de texte du panneau M'aider à coder, utilisez un langage conversationnel pour décrire la dimension, le groupe de dimensions ou la mesure que vous souhaitez créer. Pour obtenir de l'aide, consultez les sections Conseils pour utiliser Gemini dans l'IDE Looker et Exemples de requêtes sur cette page.

  8. Appuyez sur Entrée ou cliquez sur l'icône Envoyer pour envoyer votre requête à Gemini. Gemini répondra en suggérant du code.

  9. Le code suggéré vous permet d'effectuer les actions suivantes :

    • Pointez sur le bouton Insérer pour prévisualiser le code LookML suggéré dans votre fichier. Vous pouvez déplacer votre curseur sur une autre ligne de votre fichier pour prévisualiser le LookML à un autre emplacement avant de l'insérer dans le fichier.
    • Cliquez sur le bouton Modifier pour modifier manuellement le code LookML suggéré.
    • Cliquez sur le bouton Insérer pour insérer le code LookML dans votre fichier, à l'emplacement de votre curseur.
    • Pour nous faire part de vos commentaires sur le code suggéré, sélectionnez l'icône J'aime (Cette réponse m'a été utile) ou Je n'aime pas (Cette réponse ne correspond pas à mes attentes).
    • Cliquez sur le lien Nouvelle suggestion de code pour recommencer et saisir une nouvelle requête pour Gemini.

    Gemini affiche un aperçu de l'emplacement du code lorsque le curseur pointe sur le bouton "Insérer".

  10. Cliquez sur Enregistrer les modifications dans votre fichier LookML.

  11. Vérifiez le code LookML en procédant comme suit :

Conseils pour utiliser Gemini dans l'IDE Looker

Voici quelques conseils pour utiliser Gemini dans l'IDE Looker :

  • Pour de meilleurs résultats, rédigez vos requêtes en anglais américain. Pour en savoir plus, consultez la documentation sur les limites de Gemini pour Google Cloud .
  • Le panneau M'aider à coder ne conserve pas le contexte d'une invite précédente dans la conversation, ni les invites lors des connexions et des actualisations.
  • Lorsque vous utilisez du code LookML suggéré par Gemini, validez-le toujours avec le validateur LookML et testez vos nouveaux champs dans une exploration.
  • En fonction de votre demande, Gemini peut suggérer du code LookML qui fait référence à des champs dans d'autres fichiers de vue. Lorsque vous ajoutez du code LookML suggéré à votre fichier, enregistrez-le et exécutez le validateur LookML. Le validateur LookML affichera des erreurs si vous devez ajouter des instructions include à votre fichier de modèle.

Exemples de requêtes

Pour vous donner quelques idées, voici des exemples de requêtes et leurs résultats :

Créer une dimension à l'aide de la longitude et de la latitude

Voici une requête utilisant l'option Créer une dimension qui demande à Gemini de créer une dimension basée sur les champs longitude et latitude définis dans le fichier de vue :

show coordinates with longitude and latitude

Gemini renvoie le code suggéré suivant :

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

Vous pouvez vérifier ce code LookML dans une exploration en sélectionnant le nouveau champ coordinates, ainsi que les champs longitude et latitude sur lesquels il est basé. Étant donné que Gemini a créé la dimension à l'aide de type:location, les résultats de l'exploration incluent un lien hypertexte permettant d'afficher les coordonnées sur une carte :

Exploration Looker affichant les champs de latitude et de longitude, avec le nouveau champ de coordonnées dont les valeurs correspondent à celles de la latitude et de la longitude.

Créer une mesure pour le total des ventes du jour

Voici une requête utilisant l'option Créer une mesure qui demande à Gemini de créer une mesure pour la somme de toutes les commandes du jour :

show the total sale price of today's orders

Gemini renvoie le code suggéré suivant :

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

Fournir des commentaires

Vous pouvez envoyer des commentaires sur le code LookML généré dans le panneau M'aider à coder. Si le code LookML généré semble correct, cliquez sur l'icône thumb_up J'aime. Si le code LookML généré semble incorrect ou ne correspond pas à ce que vous attendiez, cliquez sur l'icône thumb_down Je n'aime pas.