Parcourir les projets avec le panneau du navigateur d'objets

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 ces objets. 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 de l'explorateur d'objets regroupe les objets par type. Les objets sont triés par ordre alphabétique dans chaque type. Le panneau de navigation d'objets vous permet d'afficher ou de masquer les hiérarchies d'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 révéler 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 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 de navigation d'objets, pour 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:

Vous pouvez afficher le type d'un objet dans votre projet en passant la souris sur son nom dans le panneau du navigateur d'objets.

Le panneau du navigateur d'objets affiche à la fois une icône et un libellé qui identifie le type d'objet:

  • – Modèle
  • – Explorer
  • – Vue
  • – Dimension
  • : groupe de dimensions
  • – Mesure
  • – Filtre
  • : paramètre

En passant la souris 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 située à gauche de l'objet id indique qu'il s'agit d'une dimension. Si vous pointez sur la dimension id, vous constatez qu'il s'agit d'une dimension type: number:

Le navigateur d'objets affiche l'icône de dimension à côté du nom du champ d'ID d'exemple. Le type de numéro est indiqué lorsque l'utilisateur pointe dessus.

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:

En cliquant sur le nom de l'objet

Pour accéder au code LookML d'un objet, procédez comme suit:

  1. Dans le panneau du navigateur d'objets, cliquez sur le nom de l'objet.
  2. 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.

Rechercher l'objet

Pour rechercher un objet ou un fichier, procédez comme suit:

  1. Dans le panneau de l'explorateur 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).

  2. Saisissez le terme que vous recherchez. Looker affiche une liste d'objets et de fichiers correspondant à votre terme de recherche.

Situations spéciales

Afficher les objets importés dans le panneau du navigateur d'objets

Lorsque vous importez des fichiers depuis un autre projet et que vous incluez ces fichiers importés dans votre projet actif, vous pouvez également afficher les objets importés à l'aide du panneau de l'explorateur d'objets.

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 les objets étendus dans le panneau du navigateur d'objets

Si votre projet comprend une vue ou une exploration qui extends une autre vue ou exploration, vous pouvez utiliser le panneau de l'explorateur d'objets pour afficher le code 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 développée.

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 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 affinée ou d'une exploration, ou pour accéder au LookML afin d'y apporter des améliorations dans votre projet.

Le panneau du navigateur d'objets liste les filtres et les explorations ou vues sur lesquels 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 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 ouvre la ligne de votre 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 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, tenez compte de l'ordre dans lequel ils sont appliqués. Lorsqu'un objet est affiné plusieurs fois dans plusieurs fichiers, les affinements sont appliqués ligne par ligne vers le bas dans un même fichier, en fonction de l'ordre dans lequel leurs fichiers sont inclus. Consultez la page de documentation sur les filtres LookML pour en savoir plus sur l'ordre dans lequel les filtres sont appliqués.