Le panneau du navigateur d'objets 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. Cela peut être une alternative utile à la navigation dans votre projet par fichier ou dossier.
Afficher les objets d'un projet
Le panneau du navigateur d'objets affiche les modèles, les explorations, les vues et les champs qui ont été 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 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 les hiérarchies d'objets en développant ou en réduisant les 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. Sélectionnez la flèche à gauche du nom d'un objet dans le panneau du navigateur d'objets pour réduire ou développer l'objet. Par défaut, tous les modèles d'un projet sont développés dans le panneau du navigateur d'objets, ce qui révèle une liste des explorations définies dans le modèle.
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 le nom de cet objet dans le panneau du navigateur d'objets.
Le panneau du navigateur d'objets affiche à la fois une icône et une étiquette de texte qui identifient le type d'objet :
- — Modèle
- — Exploration
- — Vue
- — Dimension
- — Groupe de dimensions
- — Mesure
- — Filtre
- — Paramètre
Lorsque vous pointez sur le nom d'un champ dans le panneau du navigateur d'objets, la valeur du sous-paramètre type du champ s'affiche. Dans l'exemple suivant, l'icône à gauche de l'objet id indique qu'il s'agit d'une dimension, et lorsque vous pointez sur la dimension id, vous voyez qu'il s'agit d'une dimension type: number :
Accéder au LookML d'un objet
Vous pouvez utiliser l'une des méthodes suivantes pour accéder directement au LookML d'un objet à partir du panneau du navigateur d'objets :
Cliquer sur le nom de l'objet
Pour accéder au 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 place le curseur sur la première ligne de la déclaration de l'objet.
Rechercher l'objet
Pour rechercher un objet ou un fichier, procédez comme suit :
Dans le panneau du navigateur d'objets, cliquez sur l'icône Accéder à l'objet ou au fichier .
Vous pouvez également utiliser le raccourci clavier Commande+J (Mac) ou Ctrl+J (Windows).
Saisissez le terme de recherche. 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 à 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.
Supposons, par exemple, que vous ayez utilisé le local_dependency paramètre 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 inclure cette vue 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 toutes les vues et tous les champs qu'elle contient.
Lorsque vous sélectionnez un objet à partir 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 inclut une vue ou une exploration qui étend une autre vue ou une autre exploration, vous pouvez utiliser le panneau du navigateur d'objets pour afficher le LookML de l'objet étendu 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 les champs que vous avez ajoutés dans la vue étendue.
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 à la fois les champs définis dans la vue de base users_extended et les nouveaux champs définis dans la vue user_with_age_extension.
Vous pouvez accéder au LookML de l'objet étendu en sélectionnant son nom dans le panneau du navigateur d'objets.
Afficher les 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 ou d'une exploration affinée, ou pour accéder au LookML des affinages de votre projet.
Le panneau du navigateur d'objets répertorie les affinages et les explorations ou les vues sur lesquelles ils s'appuient en tant qu'objets uniques, plutôt que d'afficher séparément les affinages et leurs objets de base. Si vous utilisez des affinages 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 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 LookML où l'affinage est défini. Si une vue ou une exploration a été affinée plusieurs fois, l'IDE accède au dernier affinage de cet objet par ordre d'inclusion.
Supposons, par exemple, que vous souhaitiez ajouter une nouvelle dimension, country, à la vue appelée user_with_age_extension sans modifier le LookML d'origine de la vue. 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 affinages à votre projet, tenez compte de l'ordre dans lequel ils sont appliqués. Les affinages sont appliqués ligne par ligne vers le bas dans un seul fichier, et dans l'ordre dans lequel leurs fichiers sont inclus si un objet est affiné plusieurs fois dans plusieurs fichiers. Pour en savoir plus sur l'ordre dans lequel les affinages sont appliqués, consultez la page de documentation sur les affinages LookML.