Présentation de l'IDE Looker

L'IDE (environnement de développement intégré) de Looker permet d'accéder à vos fichiers de projet LookML et aux paramètres de votre projet LookML.

Accéder à l'IDE Looker

Pour afficher un projet LookML, vous devez disposer de l'autorisation develop pour au moins un modèle du projet. Vous pouvez accéder à l'IDE Looker via le panneau Développer du menu de navigation principal de Looker :

  1. Sélectionnez Develop (Développer) dans le panneau de navigation pour ouvrir le panneau Develop (Développer).
  2. Dans le panneau Develop (Développer), sélectionnez le nom du projet auquel vous souhaitez accéder.

Looker ouvre l'IDE avec le projet LookML que vous avez sélectionné.

Vous pouvez également ouvrir l'IDE à des objets LookML spécifiques à partir d'une exploration ou depuis le navigateur d'objets. Pour plus d'informations et d'autres options, consultez la section Accéder aux fichiers du projet.

Éléments de l'IDE Looker

L'IDE Looker contient les éléments suivants:

  1. Bannière Mode Développement: cette bannière indique que vous êtes en mode Développement, où vous pouvez modifier les fichiers LookML et prévisualiser leur impact sur le contenu de votre instance. Vous pouvez cliquer sur le lien Quitter le mode Développement dans la bannière pour passer en mode Production.
  2. Barre de navigation de l'IDE: utilisez la barre de navigation pour accéder à différentes fonctionnalités de l'IDE Looker. Certaines fonctionnalités ne sont disponibles que lorsque vous êtes en mode Développement. Après avoir sélectionné une fonctionnalité dans la barre de navigation de l'IDE, vous pouvez sélectionner l'élément de la barre de navigation une deuxième fois pour réduire le panneau des fonctionnalités. La barre de navigation de l'IDE permet d'accéder aux fonctionnalités suivantes :
    • File Browser (Explorateur de fichiers) : ouvre l'explorateur de fichiers, qui vous permet d'accéder aux fichiers et aux dossiers de votre projet LookML.
    • Navigateur d'objets: ouvre le navigateur d'objets, qui affiche les objets LookML de votre projet, ainsi que les relations hiérarchiques entre ces objets.
    • Rechercher et remplacer : affiche la page Rechercher et remplacer dans le projet, qui vous permet de rechercher du texte dans tous les fichiers de votre projet, puis de remplacer toutes les instances ou des instances sélectionnées dans une opération groupée.
    • Actions Git (visible en mode développement uniquement) : affiche les branches Git de votre projet et les commandes Git disponibles pour votre branche Git du projet. Pour en savoir plus sur l'utilisation de Git avec votre projet LookML, consultez la page de documentation Utiliser le contrôle des versions et le déploiement.
    • Settings (Paramètres) (visible en mode Développement uniquement) affiche les pages de paramètres de votre projet sur lesquelles vous pouvez configurer les options de contrôle des versions du projet, les identifiants d'authentification pour les projets importés, les branches Git utilisées par votre projet et les paramètres de l'IDE.
    • Déployer (visible en mode développement uniquement) : pour les projets configurés avec le mode de déploiement avancé, ouvre Deployment Manager, dans lequel les développeurs disposant de l'autorisation deploy peuvent déployer un commit ou une balise dans leur environnement de production Looker.
  3. Panneau de fonctionnalités: permet de naviguer dans les fichiers et objets LookML pour l'explorateur de fichiers et le navigateur d'objets, les paramètres de recherche pour la fonction "Rechercher et remplacer", les commandes Git disponibles pour le panneau Actions Git et les onglets permettant d'accéder à différents paramètres du panneau des paramètres du projet.
  4. Panneau de l'éditeur IDE : éditeur des fichiers LookML. L'éditeur s'affiche lorsque File Browser (Navigateur de fichiers) ou Object Browser (Navigateur d'objets) sont sélectionnés dans la barre de navigation de l'IDE. Pour en savoir plus sur l'éditeur, consultez Fonctionnalités d'édition dans l'IDE Looker.
  5. Sélecteur du panneau latéral: cliquez sur une option pour ouvrir les fonctionnalités du panneau latéral de l'IDE:
    • Project Health (État du projet) : ouvre le panneau Project Health (État du projet).
    • Aide rapide : ouvre le panneau Aide rapide, qui comprend un onglet permettant d'accéder au panneau Métadonnées.
    • M'aider à coder: (pour les instances Looker (Google Cloud Core) avec Gemini activé) ouvre le panneau M'aider à coder. Cliquez une deuxième fois sur l'option de sélecteur de panneau latéral pour masquer le panneau latéral de l'IDE.
  6. Panneau latéral de l'IDE : affiche la fonctionnalité du panneau latéral sélectionné :
  7. Bouton Git : en fonction de l'état de votre projet, le bouton indique l'action suivante à effectuer pour le mettre en production, par exemple Valider LookML, Transférer la branche vers un dépôt distant ou Effectuer un commit. Cliquez sur le bouton pour effectuer l'action. Consultez la documentation de référence sur les commandes Git pour connaître les commandes possibles que le bouton peut afficher et exécuter.

Configurer l'IDE Looker

Vous pouvez personnaliser l'IDE Looker comme suit:

Modes de l'éditeur de texte

L'IDE Looker prend en charge trois modes d'éditeur de texte:

  • Éditeur Looker IDE (par défaut)
  • Vim
  • Emacs

Pour modifier le mode de l'éditeur de texte :

  1. Sélectionnez l'icône Settings (Paramètres) dans le volet de navigation de gauche de l'IDE Looker.
  2. Sélectionnez l'onglet Éditeur dans les paramètres de l'IDE.
  3. Utilisez le menu déroulant Mode Éditeur de texte pour sélectionner votre option.

Une fois que vous avez sélectionné une option dans le menu déroulant, l'IDE Looker est immédiatement mis à jour pour utiliser le mode d'éditeur de texte sélectionné.

Mode de renvoi à la ligne

Par défaut, le retour à la ligne est activé dans l'IDE Looker.

Pour activer ou désactiver le retour à la ligne :

  1. Sélectionnez l'icône Settings (Paramètres) dans le volet de navigation de gauche de l'IDE Looker.
  2. Sélectionnez l'onglet Éditeur dans les paramètres de l'IDE.
  3. Utilisez le bouton Mode Renvoi à la ligne pour activer ou désactiver le retour à la ligne dans l'IDE.

Une fois le bouton d'activation modifié, la mise à jour est appliquée à l'IDE Looker.

Redimensionner les panneaux latéraux de l'IDE

Vous pouvez modifier la largeur des panneaux dans l'IDE, à la fois dans le panneau de fonctionnalités (qui contient les panneaux File Browser, Object Browser et Git Actions) et dans le panneau latéral (qui contient les panneaux Project Health, Quick Help et Metadata).

Pour redimensionner les panneaux IDE, maintenez votre curseur sur la bordure du panneau, puis faites-le glisser pour le redimensionner:

Si vous êtes en mode développement, l'IDE conservera la taille des panneaux latéraux entre les connexions et les actualisations.

Réduire les panneaux latéraux de l'IDE

Si vous souhaitez maximiser la largeur du panneau de configuration de l'IDE, vous pouvez les réduire:

  • Pour afficher ou masquer le panneau des fonctionnalités de l'IDE, utilisez le raccourci clavier Cmd+B (Mac) ou Ctrl+B (Windows), ou cliquez sur une icône déjà sélectionnée dans la barre de navigation de l'IDE.
  • Pour afficher ou masquer le panneau latéral de l'IDE, cliquez sur une icône déjà sélectionnée dans le sélecteur du panneau latéral.

Fonctionnalités d'édition dans l'IDE Looker

Les sections suivantes décrivent certaines des fonctionnalités d'édition dans l'IDE Looker qui peuvent vous aider à développer en LookML:

Suggestions automatiques

À mesure que vous saisissez du texte, l'IDE suggère des paramètres et des valeurs possibles, sensibles au contexte de ce que vous saisissez. Par exemple, les suggestions pour le paramètre type d'une dimension n'incluent que les options valides pour ce paramètre. De plus, les champs des paramètres sql doivent être marqués avec ${...}. L'IDE ajoute donc cette syntaxe lorsqu'il suggère des champs.

La saisie semi-automatique s'affiche automatiquement partout où elle peut être présentée. Pour le fermer, appuyez sur la touche Échap de votre clavier. Pour l'afficher à tout moment, appuyez sur Ctrl+Espace (Windows) ou Ctrl+Espace (Mac).

Vérification ad hoc des erreurs

L'IDE détecte les erreurs de syntaxe au fur et à mesure que vous saisissez du texte. Un X rouge dans la marge indique une erreur de syntaxe, soulignée en rouge. Lorsque vous maintenez le curseur sur le X rouge, une brève description du problème s'affiche. Par exemple, si vous saisissez par erreur avrage au lieu de average comme valeur du paramètre type d'une mesure, l'IDE affiche l'erreur Invalid value for "type":avrage.

Le validateur LookML est toujours nécessaire pour effectuer une validation complète du modèle. Certaines erreurs, comme une référence de champ non valide causée par une jointure manquante, nécessitent un examen global du modèle et ne s'affichent donc que lorsque l'outil de validation LookML est exécuté.

Mise en forme automatique

En mode Développement, vous pouvez utiliser le raccourci clavier de mise en forme du fichier pour mettre automatiquement votre fichier LookML en retrait. Le retrait indique la hiérarchie des paramètres et sous-paramètres, ce qui rend votre LookML plus facile à lire et à comprendre.

Pliables

Une petite flèche apparaît dans la marge à côté du début de chaque paramètre LookML de niveau supérieur dans le fichier. Si vous sélectionnez cette flèche, cette section de LookML se développera ou se réduira pour que vous puissiez vous concentrer sur des sections spécifiques.

Le menu Afficher les actions du fichier du fichier LookML propose également les options Déplier le code LookML et Réplier le code LookML pour développer ou réduire toutes les sections LookML jusqu'au paramètre de niveau supérieur dans le fichier actuel.

Vous pouvez également utiliser des raccourcis clavier pour plier et déplier LookML.

Ajout de commentaires

Vous pouvez ajouter des commentaires à votre code LookML pour le rendre plus lisible. Pour ajouter un seul commentaire, utilisez le caractère # :

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

Pour mettre en commentaire un bloc de code entier à l'aide des raccourcis clavier, procédez comme suit:

  1. Sélectionnez les lignes que vous souhaitez commenter.
  2. Appuyez sur Commande+ / (Mac) ou Ctrl+ / (Windows).

L'IDE ajoute le caractère # à chacune des lignes sélectionnées.

Commenter des blocs SQL

Si vous commentez des lignes qui se trouvent entièrement dans un bloc de code SQL, ajoutez manuellement la notation de commentaire SQL.

Lorsque vous utilisez le bloc de commentaire SQL, les sections commentées sont toujours interprétées comme du code LookML. Par conséquent, vous verrez vos commentaires dans le code SQL généré par LookML, mais ils n'affecteront pas les résultats de la requête.

Afficher les ajouts, les modifications et les suppressions

Dans l'IDE LookML, plusieurs indicateurs sont toujours affichés lorsque vous êtes en mode Développement et que vous effectuez des modifications non validées.

  • Le nom du fichier est affiché avec un point bleu dans la partie gauche de la fenêtre pour indiquer que le fichier a été nouveau, modifié ou renommé.
  • Lorsque vous ouvrez un nouveau fichier ou un fichier modifié, les numéros des lignes qu'il contient sont surlignés en vert afin d'afficher les nouvelles lignes ou celles qui ont été modifiées. Une ligne horizontale rouge indique les lignes supprimées.

Persistance de l'état de l'IDE

Lorsque vous êtes en mode Développement, l'IDE Looker conserve votre état lors des actualisations et des connexions. L'état de votre IDE inclut les éléments suivants :

  • Élément sélectionné dans la barre de navigation de l'IDE (par exemple, l'explorateur de fichiers, les actions Git, le navigateur d'objets ou les paramètres du projet)
  • Ouvrir le fichier LookML affiché dans l'explorateur de fichiers
  • État développé ou réduit des éléments dans le navigateur de fichiers et le navigateur d'objets
  • Largeur des panneaux latéraux de l'IDE
  • Élément sélectionné dans la barre latérale droite de l'IDE (par exemple, les panneaux "Quick Help" (Aide rapide), les panneaux "Metadata" (Métadonnées) et le panneau "Project Health" (État du projet)
  • Mode de retour à la ligne de l'éditeur

Pour rétablir les valeurs par défaut de l'IDE, sélectionnez l'icône Settings (Paramètres) dans le volet de navigation de gauche de l'IDE Looker, sélectionnez l'onglet Editor (Éditeur) dans la section IDE Settings (Paramètres de l'IDE), puis cliquez sur le bouton Reset IDE Layout (Réinitialiser la mise en page de l'IDE). L'IDE conserve à nouveau votre état tant que vous continuez à ouvrir des fichiers et à effectuer des sélections.

Accéder à un objet ou à un fichier

Dans l'IDE Looker, vous pouvez effectuer une recherche rapide pour accéder directement aux objets LookML et aux fichiers de projet à l'aide de la fonctionnalité Accéder à un objet ou à un fichier. Cliquez sur l'icône Accéder à un objet ou à un fichier dans le navigateur de fichiers ou le navigateur d'objets, ou utilisez le raccourci clavier Cmd+J (Mac) ou Ctrl+J (Windows).

Pour en savoir plus, consultez la page de documentation Accéder aux fichiers de projet LookML.

Panneau "Aide rapide"

Sélectionnez l'icône Aide rapide pour ouvrir le panneau Aide rapide, qui fournit des explications et des options pour l'emplacement actuel dans le code. Sélectionnez un nom de paramètre dans la barre latérale pour ouvrir la page de documentation Looker correspondante.

Panneau "M'aider à coder"

Si vous disposez d'une instance Looker (Google Cloud Core) avec Gemini activé, vous pouvez utiliser Gemini dans Looker pour écrire du code LookML:

IDE Looker avec l'icône "M'aider à coder" mise en surbrillance.

Pour en savoir plus, consultez la documentation Écrire du code LookML avec l'aide de Gemini dans Looker.

Menus d'options pour les fichiers et les dossiers

Dans l'explorateur de fichiers, chaque fichier ou dossier du panneau de gauche est associé à un menu qui affiche les actions disponibles pour cet élément. Pointez sur un fichier ou un dossier, puis sélectionnez le menu à trois points Options de dossier (pour les dossiers) ou Options de fichier (pour les fichiers) pour l'ouvrir. Pour un élément dont le nom est long ou qui est imbriqué dans plusieurs dossiers, vous pouvez accéder au menu en faisant défiler le panneau du navigateur de fichiers.

Dans les menus d'options, vous pouvez créer des dossiers et des fichiers, importer des fichiers, et supprimer et déplacer des fichiers et des dossiers à l'aide du navigateur de fichiers. Pour en savoir plus, consultez la page de documentation Gérer les fichiers et les dossiers LookML.

Lorsque vous organisez vos fichiers LookML dans des dossiers, vous devez valider vos modifications et les déployer en production avant que les autres développeurs Looker puissent les voir. Cette opération s'apparente à toute modification apportée à votre projet LookML.

Rechercher et remplacer du texte dans votre projet

L'IDE Looker dispose d'une fonction de recherche et de remplacement. Vous pouvez l'utiliser pour rechercher du texte dans tous les fichiers de votre projet, puis remplacer toutes les instances ou des instances sélectionnées dans une opération groupée.

Pour utiliser la fonction de recherche de l'IDE Looker :

  1. Accédez au panneau de recherche dans l'IDE.
  2. Saisissez un terme dans le champ Rechercher.
  3. Vous pouvez également sélectionner Sensible à la casse pour rechercher uniquement les instances qui correspondent à la casse que vous avez saisie dans le champ Rechercher, ou sélectionner Expression régulière pour effectuer une recherche avec des expressions régulières.
  4. Sélectionnez Rechercher.
  5. Vous pouvez éventuellement sélectionner le nom d'un fichier pour l'ouvrir dans l'IDE.

Si vous êtes en mode Développement, le champ Remplacer par s'affiche également. Pour remplacer du texte dans votre projet, procédez comme suit:

  1. Saisissez le texte de remplacement dans le champ Remplacer par. Vous pouvez laisser le champ Remplacer par vide si vous souhaitez supprimer le texte du champ Rechercher au lieu de le remplacer.

  2. Sélectionnez Sélectionner et Remplacer pour afficher un aperçu de la manière dont le texte sera remplacé dans votre projet.

  3. Les résultats affichent toutes les instances de votre projet mises en surbrillance à des fins de remplacement. Vous pouvez utiliser les options suivantes pour personnaliser les instances à remplacer:

    • Cochez ou décochez la case située à côté du récapitulatif des résultats pour sélectionner ou désélectionner toutes les instances de l'ensemble de votre projet.
    • Pour sélectionner ou désélectionner une instance, cochez ou décochez la case correspondante.

  4. Sélectionnez le bouton Replace Selected (Remplacer les éléments sélectionnés) pour appliquer le remplacement aux instances que vous avez sélectionnées. L'IDE affiche les modifications apportées.

Créer et tester de nouveaux champs

À titre d'exemple de modification de LookML, nous allons ajouter plusieurs champs et les tester.

Créer une dimension

Tout d'abord, nous allons ajouter une dimension à la vue users qui détermine si un utilisateur se trouve en Californie ou à New York. La dimension sera type: yesno, ce qui signifie qu'elle affichera Oui si l'utilisateur se trouve en Californie ou à New York, et Non dans le cas contraire.

Le code LookML de notre nouvelle dimension se présente comme suit :

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

Ajoutez cette dimension au fichier de vue user, puis cliquez sur le bouton Enregistrer les modifications dans le fichier.

Pour en savoir plus sur ${TABLE}.state, découvrez les opérateurs de substitution.

Créer une mesure

Nous allons ensuite ajouter une mesure à la vue user, qui représente la moyenne de l'âge de nos utilisateurs. Cette mesure sera type: average et sera agrégée sur la colonne age.

Le code LookML de cette nouvelle mesure se présente comme suit :

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

Ajoutez cette mesure au fichier de vue user, puis cliquez sur le bouton Save Changes (Enregistrer les modifications) dans le fichier.

Tester les champs de l'exploration

Vous pouvez tester votre nouvelle dimension et mesurer ses performances en les interrogeant. Une fois les modifications enregistrées, ces champs apparaîtront dans le sélecteur de champs de l'exploration. Utilisez le menu déroulant Afficher les actions sur les fichiers situé à côté du nom de la vue pour accéder à l'exploration de la vue actuelle. Le menu déroulant Afficher les actions sur les fichiers liste toutes les explorations basées sur la vue, y compris celles auxquelles elle est associée. Par exemple, pour accéder à l'exploration d'une vue appelée users, vous pouvez sélectionner l'option Explorer les utilisateurs dans le menu déroulant Afficher les actions sur les fichiers.

Dans l'exploration Users (Utilisateurs), vous pouvez sélectionner les nouveaux champs pour les ajouter à une requête. Par exemple, vous pouvez créer une requête avec les deux nouveaux champs pour afficher l'âge moyen des utilisateurs situés en Californie ou à New York, et l'âge moyen des utilisateurs qui ne le sont pas :

Tableau de données d'un exemple d'exploration "Utilisateurs" avec les champs "Utilisateurs situés en Californie ou à New York (oui/non)" et "Âge moyen des utilisateurs" sélectionnés.