Le panneau du navigateur d'objets de l'IDE Looker vous permet de consulter 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 dossier.
Afficher les objets d'un projet
Le panneau de navigation des objets affiche les modèles, les explorations, les vues et les champs définis dans votre projet, ainsi que la hiérarchie des objets et le type de chaque objet. Si votre projet comprend également des fichiers importés, consultez ci-dessous l'affichage de ces objets.
Pour utiliser le panneau du navigateur d'objets, sélectionnez l'icône Navigateur d'objets, située sous l'icône de dossier 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 au sein de chaque type. Dans le panneau de navigation des objets, vous pouvez afficher ou masquer les hiérarchies d'objets en les développant ou en les réduisant.
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 navigation de l'objet pour le réduire ou le développer. Tout modèle d'un projet est développé par défaut dans le panneau du navigateur d'objets, affichant une liste des explorations définies dans le modèle.
Afficher le type d'un objet
Le panneau de navigation de l'objet répertorie les types d'objets suivants:
Pour afficher le type d'un objet dans votre projet, pointez sur son nom dans le panneau du navigateur d'objets.
L'icône à gauche du nom de chaque objet identifie également le type d'objet:
: modèle
– Découvrir
– Afficher
: dimension
: groupe de dimensions
: mesure
: filtrer
: paramètre
Pointez sur le nom d'un champ dans le panneau du navigateur d'objets pour afficher la valeur du sous-paramètre type du champ. Dans l'exemple ci-dessous, l'icône à gauche de l'objet id indique qu'il s'agit d'une dimension. Pointez sur la dimension id pour découvrir qu'il s'agit d'une dimension type: number:
Accéder à LookML pour un objet
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 à l'objet ou au fichier dans le navigateur d'objets ou utilisez le raccourci clavier Commande-J (Mac) ou Ctrl+J (Windows):
Pour en savoir plus, consultez la page Accéder aux fichiers du projet LookML.
Vous pouvez également accéder à un objet en sélectionnant son nom dans le panneau du navigateur d'objets. Lorsque vous sélectionnez un objet, l'IDE affiche le fichier dans lequel l'objet est défini et place votre curseur sur la première ligne de la déclaration de l'objet.
Par exemple, sélectionner une exploration appelée events ouvre le fichier de modèle dans lequel cette exploration est définie dans l'IDE et positionne le curseur en haut de la déclaration explore pour events. Le panneau du navigateur d'objets affiche la définition de l'exploration events, y compris la vue users jointe.
Situations spéciales
Affichage des objets importés dans le panneau de navigation des objets
Lorsque vous importez des fichiers à partir d'un autre projet et que vous incluez ces fichiers importés dans votre projet actif, vous pouvez également utiliser le panneau de navigation de l'objet 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 que la vue product_facts soit disponible pour votre modèle, vous pouvez l'inclure et créer une product_facts exploration:
include: "//e_redlook/views/product_facts.view"
explore: product_facts {}
Vous pouvez ensuite afficher product_facts Explorer dans le panneau du navigateur d'objets et développer l'exploration 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 il est défini. Le fichier sera en lecture seule, car il s'agit d'un fichier de projet importé.
Afficher les objets étendus dans le panneau du navigateur d'objets
Si votre projet comprend une vue ou une fonction Explorer qui étend une autre vue ou Explorer, vous pouvez utiliser le panneau de navigation de l'objet pour afficher et accéder au LookML pour l'objet étendu. Lorsque vous développez une vue qui en développe une autre, le panneau de navigation de l'objet affiche les champs de la vue de base, ainsi que tous les champs que vous avez ajoutés dans la vue étendue.
Par exemple, le fichier de vue ci-dessous 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 de navigation de l'objet 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 à LookML pour l'objet étendu en sélectionnant son nom dans le panneau du navigateur d'objets.
Affichage d'objets raffinés dans le panneau de navigation des objets
Le panneau du navigateur d'objets permet d'afficher le contenu d'une vue sophistiquée ou d'une page Explorer, ou d'accéder à LookML pour trouver les filtres de votre projet.
Le panneau de navigation des objets liste les filtres et les explorations ou vues sur lesquelles ils s'appuient comme des objets uniques, au lieu d'afficher séparément des 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 les vues que vous ajoutez s'afficheront avec le contenu de la vue d'origine.
Lorsque vous sélectionnez le nom d'une vue affinée ou d'une fonction Explorer dans le panneau du navigateur d'objets, l'IDE s'ouvre sur la ligne de LookML où le filtre est défini. Si une vue ou une exploration ont été affinées plusieurs fois, l'IDE accède au dernier filtre de cet objet par ordre d'inclusion.
Par exemple, supposons que vous souhaitiez ajouter une dimension country à la vue user_with_age_extension sans modifier son LookML d'origine. Pour affiner la vue user_with_age_extension, utilisez le paramètre view et ajoutez un 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, soyez attentif à l'ordre dans lequel ils sont appliqués. Les filtres sont appliqués ligne par ligne vers le bas dans un seul 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 filtres LookML pour en savoir plus sur l'ordre dans lequel les filtres sont appliqués.