Le panneau de navigation de l'IDE Looker vous permet d'afficher tous les objets de votre projet au même endroit, ainsi que les relations hiérarchiques entre eux. Il peut s'agir d'une alternative utile à la navigation dans votre projet par fichier ou par dossier, car il peut être plus facile de trouver des objets LookML spécifiques et de comprendre les relations entre eux.
Afficher les objets d'un projet
Le panneau du navigateur d'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 la section Afficher ces objets ci-dessous pour en savoir plus.
Pour utiliser le panneau du navigateur d'objets, sélectionnez l'icône du 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 dans chaque type. Dans le panneau du navigateur d'objets, vous pouvez afficher ou masquer les hiérarchies d'objets en agrandissant ou en pliant des objets.
Vous pouvez réduire et développer des modèles, des explorations et des vues pour afficher ou masquer les objets qu'ils contiennent. Cliquez sur la flèche située à gauche du nom d'un objet dans le panneau du navigateur d'objets pour réduire ou développer l'objet. Tous les modèles d'un projet sont développés par défaut dans le panneau du navigateur d'objets, afin d'afficher la liste des explorations définies dans le modèle.
Afficher le type d'un objet
Le panneau "Navigateur d'objets" répertorie les types d'objets suivants:
Pour afficher le type d'un objet de votre projet, pointez sur son nom dans le panneau du navigateur d'objets:
L'icône située à gauche du nom de chaque objet identifie le type d'objet:
: modèle
— Explorer
– Afficher
: dimension
: groupe de dimensions
: mesure
: filtre
: 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 indiquer 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 et aux fichiers de projet LookML à 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 informations du projet et les modifier.
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 positionne le curseur sur la première ligne de la déclaration de l'objet.
Dans cet exemple, le fait de sélectionner events Explorer ouvre le fichier e_thelook.model 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
Afficher les objets importés dans le panneau du navigateur d'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 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 du 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 l'élément product_facts Explorer dans le panneau du navigateur d'objets et développer l'élément"Explorer"pour afficher toutes les vues et tous les champs qu'il contient:
Lorsque vous cliquez sur un objet d'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 les objets étendus dans le panneau du navigateur d'objets
Si votre projet comprend une vue ou une tâche "Explorer" qui étend une autre vue ou l'option "Explorer", vous pouvez utiliser le panneau du navigateur d'objets pour afficher l'objet LookML et y accéder. Lorsque vous développez une vue qui en développe une autre, le panneau du navigateur d'objets 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 ;;
}
}
Vous pouvez constater que le panneau du navigateur d'objets affiche à la fois 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 extensible en sélectionnant son nom dans le panneau du navigateur d'objets.
Affichage des objets affinés dans le panneau du navigateur d'objets
Le panneau du navigateur d'objets vous permet d'afficher le contenu d'une vue avancée ou de la fonction 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 en tant qu'objets individuels, plutôt que 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 les vues que vous ajoutez s'affichent avec le contenu de la vue d'origine.
Lorsque vous sélectionnez le nom d'une vue affinée ou de l'option "Explorer" dans le panneau du navigateur d'objets, l'IDE s'ouvre sur la ligne de votre LookML sur laquelle le filtre est défini. Si une vue ou une exploration ont été affinées plusieurs fois, l'IDE accède au dernier raffinement 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 le 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:
Lorsque vous ajoutez des filtres à votre projet, pensez à l'ordre dans lequel ils sont appliqués. Les filtres sont appliqués ligne par ligne dans un seul fichier et par ordre d'inclusion si un objet est affiné plusieurs fois dans plusieurs fichiers. Consultez la page de documentation sur les affinages LookML pour en savoir plus sur l'ordre dans lequel les filtres sont appliqués.