Présentation de l'IDE Looker

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

Accéder à Looker IDE

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 Développer dans le panneau de navigation pour ouvrir le panneau Développer.
  2. Dans le panneau 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 pour afficher des objets LookML spécifiques à partir d'une exploration ou du navigateur d'objets. Pour en savoir plus et découvrir d'autres options, consultez Accéder aux fichiers de projet.

Éléments de l'IDE Looker

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

  1. Bannière du mode développement: cette bannière indique que vous êtes en mode développement, ce qui vous permet de modifier les fichiers LookML et de 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 aux différentes fonctionnalités de l'IDE Looker. Certaines fonctionnalités ne sont disponibles que lorsque vous êtes en mode Développement. Une fois que vous avez 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 seconde fois pour réduire le panneau de la fonctionnalité. 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 et les relations hiérarchiques entre eux.
    • 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. Consultez la page de documentation Utiliser le contrôle des versions et le déploiement pour en savoir plus sur l'utilisation de Git avec votre projet LookML.
    • Settings (Paramètres) : (visible en mode développement uniquement) affiche les pages de paramètres de votre projet, où vous pouvez configurer les options de contrôle des versions du projet, les identifiants d'authentification des 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. Volet des fonctionnalités: permet de naviguer dans les fichiers et objets LookML pour le navigateur de fichiers et le navigateur d'objets, les paramètres de recherche pour la fonction de recherche et de remplacement, les commandes Git disponibles pour le panneau Actions Git et les onglets permettant d'accéder à différents paramètres pour le 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) est sélectionné dans la barre de navigation de l'IDE. Pour en savoir plus sur l'éditeur, consultez la section Fonctionnalités de l'éditeur Looker IDE.
  5. Sélecteur du panneau latéral: cliquez sur une option pour ouvrir les fonctionnalités du panneau latéral de l'IDE :
    • État du projet: ouvre le panneau État du projet.
    • Aide rapide: ouvre le panneau Aide rapide, qui inclut 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 que le bouton peut afficher et exécuter.

Configurer l'IDE Looker

Vous pouvez personnaliser l'IDE Looker de différentes manières:

Modes de l'éditeur de texte

L'IDE Looker est compatible avec trois modes d'éditeur de texte:

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

Pour modifier le mode de l'éditeur de texte, procédez comme suit:

  1. Sélectionnez l'icône 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 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 bascule Mode retour à 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 de l'IDE, à la fois le panneau des fonctionnalités (qui contient les panneaux File Browser (Navigateur de fichiers), Object Browser (Navigateur d'objets) et Git Actions (Actions Git)) et le panneau latéral (qui contient les panneaux Project Health (État du projet), Quick Help (Aide rapide) et Metadata (Métadonnées)).

Pour redimensionner les panneaux de l'IDE, maintenez le 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 l'éditeur de l'IDE, vous pouvez réduire les panneaux latéraux de l'IDE:

  • 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 de l'IDE Looker

Les sections suivantes décrivent certaines des fonctionnalités d'édition de 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 qui sont 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 affichée. Pour la fermer, appuyez sur la touche Échap de votre clavier. Pour l'afficher à tout moment, appuyez sur Ctrl+Espace (Windows) ou Commande+Espace (Mac).

Vérification ad hoc des erreurs

L'IDE détecte les erreurs de syntaxe au fur et à mesure de la saisie. Un X rouge dans la marge indique une erreur de syntaxe, qui est 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 pour une mesure, l'IDE affiche l'erreur Invalid value for "type":avrage.

L'outil de validation 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

Lorsque vous êtes en mode développement, vous pouvez utiliser le raccourci clavier pour mettre en forme le fichier afin d'indenter automatiquement votre fichier LookML. L'indentation indique la hiérarchie des paramètres et sous-paramètres, ce qui facilite la lecture et la compréhension de votre code LookML.

Pliables

Une petite flèche s'affiche dans la marge à côté du début de chaque paramètre LookML de premier niveau du 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.

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
}

Vous pouvez commenter un bloc de code entier à l'aide de raccourcis clavier en procédant 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'auront aucune incidence sur les résultats de la requête.

Afficher les ajouts, les modifications et les suppressions

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

  • Le nom du fichier est affiché avec un point bleu sur le côté gauche de la fenêtre pour indiquer qu'il est nouveau, modifié ou renommé.
  • Lorsque vous ouvrez un fichier nouveau ou modifié, les numéros de ligne sont mis en surbrillance en vert pour indiquer les lignes nouvelles ou 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 l'état de l'IDE lors des actualisations et des connexions. L'état de votre IDE comprend les éléments suivants:

  • Élément sélectionné dans la barre de navigation de l'IDE (par exemple, le navigateur de fichiers, les actions Git, le navigateur d'objets ou les paramètres du projet)
  • Ouvrir le fichier LookML affiché dans le navigateur 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'élément sélectionné dans la barre latérale droite de l'IDE (par exemple, le panneau "Aide rapide", le panneau "Métadonnées" et le panneau "État du projet")
  • Mode de retour à la ligne de l'éditeur

Pour rétablir les paramètres 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 conservera à nouveau votre état à mesure que vous ouvrirez des fichiers et effectuerez 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"

Pour ouvrir le panneau Aide rapide, sélectionnez l'icône Aide rapide dans le navigateur de fichiers ou le navigateur d'objets:

Le panneau Aide rapide fournit des explications et des options pour l'emplacement actuel dans le code:

  • Dans le panneau de l'éditeur de l'IDE, vous pouvez cliquer sur les champs et les paramètres de vos fichiers LookML. Le panneau Aide rapide affiche alors les options et sous-paramètres compatibles pour cet élément LookML.
  • Dans le panneau Aide rapide, vous pouvez cliquer sur le nom d'un paramètre 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 vous aider à é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 committer vos modifications et les déployer en production avant que les autres développeurs Looker puissent les voir. C'est comme toute modification que vous apportez à votre projet LookML.

Rechercher et remplacer du texte dans votre projet

L'IDE Looker dispose d'une fonction de recherche et de remplacement, 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.

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 Expression régulière pour effectuer une recherche avec une expression régulière.
  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 prévisualiser le remplacement de votre texte dans votre projet.

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

    • Cochez ou décochez la case à côté du résumé des résultats pour sélectionner ou désélectionner toutes les instances de votre projet.
    • Cochez la case à côté d'une instance pour la sélectionner ou la désélectionner.

  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

Pour illustrer l'édition de LookML, nous allons ajouter plusieurs champs, puis les tester.

Créer une dimension

Nous allons d'abord ajouter une dimension à notre vue users qui détermine si un utilisateur est originaire de Californie ou de New York. La dimension sera type: yesno, ce qui signifie qu'elle renverra Oui si l'utilisateur est 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, consultez les opérateurs de substitution.

Créer une mesure

Nous allons ensuite ajouter une nouvelle mesure à la vue user qui calcule l'âge moyen 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 Enregistrer les modifications dans le fichier.

Tester les champs de l'exploration

Vous pouvez tester votre nouvelle dimension et votre nouvelle métrique en les interrogeant. Une fois vos 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 le fichier à côté du nom du fichier 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 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.