Le panneau du navigateur d'objets dans l'IDE Looker vous permet d'afficher tous les objets de votre projet au même endroit, ainsi que les relations hiérarchiques entre ces objets. Il peut s'agir d'une alternative utile à la navigation dans votre projet par fichier ou par dossier.
Afficher les objets d'un projet
Ce panneau affiche les modèles, explorations, vues et champs définis dans votre projet, ainsi que la hiérarchie des objets et le type de chaque objet. Si votre projet inclut également des fichiers importés, vous trouverez plus d'informations sur l'affichage de ces objets plus loin sur cette page.
Pour utiliser le panneau du navigateur d'objets, cliquez sur l'icône du navigateur d'objets dans la barre de navigation de l'IDE.
Le panneau du navigateur d'objets regroupe les objets par type, et les objets sont triés par ordre alphabétique dans chaque type. À l'aide du panneau du navigateur d'objets, vous pouvez afficher ou masquer la hiérarchie des objets en développant ou en réduisant les objets.
Vous pouvez réduire et développer les modèles, les explorations et les vues pour afficher ou masquer les objets qu'ils contiennent. Sélectionnez la flèche située à gauche du nom d'un objet dans le panneau de l'explorateur d'objets pour réduire ou développer l'objet. N'importe quel modèle d'un projet est développé par défaut dans le panneau du navigateur d'objets. La liste des explorations définies dans le modèle s'affiche alors.
Afficher le type d'un objet
Le panneau du navigateur d'objets répertorie les types d'objets suivants:
Vous pouvez afficher le type d'un objet dans votre projet en pointant sur son nom dans le panneau de l'explorateur d'objets.
Le panneau du navigateur d'objets affiche à la fois une icône et un libellé de texte qui identifient le type d'objet:
- – Modèle
- – Explorer
- – Afficher
- – Dimension
- : groupe de dimensions
- – Mesure
- – Filtre
- : Paramètre
Pointez sur le nom d'un champ du panneau du navigateur d'objets pour afficher la valeur du sous-paramètre type du champ. Dans l'exemple suivant, l'icône à gauche de l'objet id indique qu'il s'agit d'une dimension. Pointez sur la dimension id pour afficher qu'il s'agit d'une dimension type: number:
Accéder au code LookML d'un objet
Vous pouvez utiliser l'une des méthodes suivantes pour accéder directement au code LookML d'un objet à partir du panneau du navigateur d'objets:
Cliquer sur le nom de l'objet
Pour accéder au code LookML d'un objet, procédez comme suit:
- Dans le panneau du navigateur d'objets, cliquez sur le nom de l'objet.
- L'IDE ouvre le fichier dans lequel l'objet est défini et positionne votre curseur sur la première ligne de la déclaration de l'objet.
Recherche de l'objet...
Pour rechercher un objet ou un fichier, procédez comme suit:
Dans le panneau de l'explorateur d'objets, cliquez sur l'icône Accéder à un objet ou à un fichier .
Vous pouvez également utiliser le raccourci clavier Commande-J (Mac) ou Ctrl+J (Windows).
Saisissez le terme que vous recherchez. Looker affiche une liste d'objets et de fichiers correspondant à votre terme de recherche.
Situations particulières
Afficher les objets importés dans le panneau du navigateur d'objets
Lorsque vous importez des fichiers d'un autre projet et incluez ces fichiers importés dans votre projet actif, vous pouvez également utiliser le panneau du navigateur d'objets pour afficher les objets importés.
Par exemple, supposons que vous ayez utilisé le paramètre local_dependency dans le fichier manifeste de votre projet pour importer un projet local appelé e_redlook, qui contient une vue appelée product_facts:
# Your project
project_name: "e_thelook"
# The project to import
local_dependency: {
project: "e_redlook"
}
Pour rendre la vue product_facts disponible pour votre modèle, vous pouvez l'inclure et créer une exploration product_facts:
include: "//e_redlook/views/product_facts.view"
explore: product_facts {}
Vous pouvez ensuite afficher l'exploration product_facts dans le panneau du navigateur d'objets et la développer pour afficher les vues et les champs qu'elle contient.
Lorsque vous sélectionnez un objet dans un projet importé, Looker ouvre le fichier dans lequel l'objet est défini. Le fichier sera en lecture seule, car il s'agit d'un fichier de projet importé.
Afficher des objets étendus dans le panneau du navigateur d'objets
Si votre projet comprend une vue ou une exploration qui extends une autre vue ou une autre exploration, vous pouvez utiliser le panneau du navigateur d'objets pour afficher le code LookML de l'objet d'extension et y accéder. Lorsque vous développez une vue qui en étend une autre, le panneau du navigateur d'objets affiche les champs de la vue de base, ainsi que tous ceux que vous avez ajoutés dans la vue d'extension.
Par exemple, le fichier de vue suivant définit une vue appelée user_with_age_extension qui étend une autre vue appelée users_extended et ajoute de nouveaux champs:
include: "/views/users_extended.view"
view: user_with_age_extension {
extends: [users_extended]
dimension: age {
type: number
sql: ${TABLE}.age ;;
}
dimension: zip {
type: zipcode
sql: ${TABLE}.zip ;;
}
}
Le panneau du navigateur d'objets affiche désormais les champs définis dans la vue users_extended de base et les nouveaux champs définis dans la vue user_with_age_extension.
Vous pouvez accéder au code LookML de l'objet d'extension en sélectionnant son nom dans le panneau du navigateur d'objets.
Afficher des objets affinés dans le panneau du navigateur d'objets
Vous pouvez utiliser le panneau du navigateur d'objets pour afficher le contenu d'une vue affinée ou d'une exploration, ou accéder au code LookML pour effectuer les améliorations dans votre projet.
Le panneau de l'explorateur d'objets liste les perfectionnements et les explorations ou vues sur lesquelles ils s'appuient en tant qu'objets uniques, au lieu d'afficher séparément les filtres et leurs objets de base. Si vous utilisez des filtres pour ajouter des champs à une vue ou pour joindre des vues à une exploration, les champs ou vues que vous ajoutez seront affichés avec le contenu de la vue d'origine.
Lorsque vous cliquez sur le nom d'une vue affinée ou d'une exploration affinée dans le panneau du navigateur d'objets, l'IDE s'ouvre sur la ligne de votre code LookML où le filtre est défini. Si une vue ou une exploration a été affinée plusieurs fois, l'IDE accède au dernier affinement de cet objet par ordre d'inclusion.
Par exemple, supposons que vous souhaitiez ajouter une nouvelle dimension, country, à la vue appelée user_with_age_extension sans modifier le code LookML d'origine de la vue. Pour affiner la vue user_with_age_extension, utilisez le paramètre view et ajoutez le signe plus (+) devant le nom de la vue:
view: +user_with_age_extension {
dimension: country {
type: string
map_layer_name: countries
sql: ${TABLE}.country ;;
}
}
Lorsque vous développez la vue user_with_age_extension dans le panneau du navigateur d'objets, le champ country s'affiche désormais avec les champs d'origine de la vue.
Lorsque vous ajoutez des filtres à votre projet, tenez compte de l'ordre dans lequel ils sont appliqués. Les filtres sont appliqués ligne par ligne vers le bas dans un même fichier, et selon l'ordre dans lequel leurs fichiers sont inclus si un objet est affiné plusieurs fois dans plusieurs fichiers. Consultez la page de documentation Filtres LookML pour en savoir plus sur l'ordre dans lequel les filtres sont appliqués.