Utiliser le diagramme LookML

Le diagramme LookML est une extension, c'est-à-dire une application Web créée à l'aide de composants Looker, développée à l'aide du framework d'extensions de Looker et déployée via Looker Marketplace.

Le diagramme LookML est un diagramme de la relation entité-modèle d'un modèle LookML qui représente visuellement les relations entre ses objets LookML. Utilisez cette extension pour:

  • Évaluer la structure du modèle LookML en identifiant les zones dans lesquelles il peut être consolidé et en déterminant la meilleure façon de l'ajouter au modèle
  • Identifier les erreurs de logique, ce qui réduit le risque de calculs erronés et de mauvaises performances des requêtes
  • En savoir plus sur la modélisation des données basée sur du code (LookML)

Cette page de documentation explique comment utiliser le schéma LookML 2.0.0 ou version ultérieure. Les administrateurs Looker doivent consulter la page de documentation Configurer l'extension du diagramme LookML pour savoir comment activer cette extension pour les utilisateurs de Looker.

Cette page explique comment:

Une fois le diagramme LookML installé, vous pouvez y accéder en cliquant sur Blocs dans le panneau de navigation de gauche, puis en sélectionnant la tuile Schéma LookML.

Observer les relations d'objets LookML avec le diagramme LookML

Votre administrateur Looker doit vous accorder les autorisations associées au modèle lookml_diagram et à tout modèle que vous souhaitez afficher dans l'extension.

L'extension de diagramme LookML comporte les éléments suivants:

  1. un panneau Paramètres de diagramme pour sélectionner un modèle, une branche Git et une exploration ;
  2. un panneau Options d'affichage, qui vous permet d'affiner les champs à afficher ;
  3. Une section d'aide concernant le diagramme pour fournir des explications supplémentaires sur les éléments du diagramme
  4. Dessin de diagramme permettant d'interagir avec les objets LookML dans l'onglet "Explorer" sélectionné
  5. Liste de champs de l'onglet "Explorer" sélectionnée, regroupée par vue
  6. une barre d'outils avec des options de zoom et de position, ainsi qu'une icône permettant d'afficher ou de masquer la mini-carte en toile, ce qui vous aide à vous orienter dans un diagramme plus grand.
  7. Un outil Profiler permettant d'afficher des informations sur l'objet LookML et d'accéder au LookML ou à la fonctionnalité Explorer associés, le cas échéant

Double-cliquez sur l'icône Diagram Settings (Paramètres du diagramme) ou View Options (Options d'affichage) pour réduire le panneau de gauche.

Configurer les paramètres du diagramme

Cliquez sur l'icône du diagramme dans la barre de navigation du diagramme pour afficher Diagram Settings (Paramètres du diagramme).

La liste déroulante Sélectionner un modèle liste tous les modèles pour lesquels vous disposez des autorisations d'affichage. Une fois le modèle sélectionné, deux options supplémentaires s'affichent:

  • La liste déroulante Branche actuelle contient la liste des branches Git de ce modèle. Si le modèle ne comporte qu'une seule branche (généralement la branche de production), cette branche est affichée. Si vous êtes en mode production ou que vous n'êtes pas autorisé à modifier les branches Git, le menu déroulant Branche actuelle est désactivé.

    Si votre administrateur vous a autorisé à modifier les branches Git sur le schéma LookML, activez le mode développement, assurez-vous de sélectionner à la fois un modèle et une exploration, puis sélectionnez une branche pour afficher le diagramme en fonction de la configuration du modèle sur cette branche.

  • La liste Explorer contient la liste des explorations de ce modèle. Cliquez sur le nom d'une exploration pour afficher ses champs, regroupés par vue, qui s'affichent sur la toile de la page.

Découvrir les options d'affichage

Lorsque l'option "Explorer" est sélectionnée, vous pouvez utiliser le panneau Options d'affichage pour restreindre les champs et les vues à afficher sur la toile.

Limitation des champs affichés

Vous pouvez choisir d'afficher tous les champs dans chaque vue de l'exploration en sélectionnant Tous les champs sous Champs à afficher. Pour n'afficher que les vues comportant des champs joints à d'autres champs, sélectionnez Champs avec jointures.

Si cette option est activée, le bouton Masquer les champs masqués masque tous les champs dont le lookML sous-jacent contient hidden: yes. L'option Masquer les champs masqués est activée par défaut.

Limiter le nombre de vues affichées

La section Vues du panneau Options d'affichage affiche la liste des vues présentes dans l'exploration sélectionnée. Par défaut, toutes les vues sont affichées sur la toile du diagramme. Lorsque vous masquez une vue, l'objet de vue et les jointures qui le connectent à tout autre objet de l'exploration sont masqués dans le canevas.

Cliquez sur Tout masquer pour masquer toutes les vues de la zone Explorer du diagramme. Cliquez sur Tout afficher pour afficher toutes les vues de cette exploration.

Vous pouvez également masquer des vues sélectivement sur la toile en désélectionnant l'icône en forme d'œil à droite du nom de la vue. Lorsque la vue est masquée, son nom est grisé et l'icône représentant un œil est traversée par une barre oblique. Pour afficher de nouveau une vue masquée, cliquez sur l'icône en forme d'œil barré.

Interpréter la toile du diagramme

Le canevas du diagramme LookML représente toutes les entités et relations d'une exploration donnée. Dans la langue verbale de Looker, vous pouvez considérer le diagramme de LookML comme la façon dont les objets LookML sont joints dans une exploration pour un modèle donné.

La barre de titre de l'objet en haut de la toile affiche le nom de l'exploration dont les vues sont affichées sur la toile. Cliquez sur l'icône d'information "Explorer" (entourée) dans la barre de titre de l'objet pour ouvrir Object Profiler et en savoir plus sur l'exploration sélectionnée. Cliquez sur la flèche vers la droite pour actualiser l'extension.

Entités

Chaque vue de l'exploration est représentée par son propre ensemble d'entités, le nom de la vue apparaissant en haut de l'ensemble:

  1. La vue de base de l'onglet "Explorer" est indiquée par un arrière-plan bleu foncé.
  2. Les vues associées dans l'onglet "Explorer" sont sur fond bleu clair.

  3. Lorsqu'une jointure, une vue ou un champ est sélectionné, il est surligné en bleu clair.

    Sous chaque vue figure une liste des champs appartenant à cette vue:

  4. Les dimensions sont répertoriées en haut.

  5. Les mesures sont listées en bas et surlignées en orange clair.

  6. Si le champ est une clé primaire, une icône en forme de clé apparaît à droite de son nom.

À gauche de chaque champ se trouve une icône indiquant son type:

  • A : dimensions de type: string
  • # : dimensions ou mesures de type: number
  • Barres hiérarchisées: dimensions de type: tier
  • Coche: dimensions de type: yesno
  • Agenda: dimensions type: date, type: date_time, type: time
  • Point de la carte: dimensions de type: location, type: distance, type: zipcode

Cliquez sur le nom du champ pour ouvrir Object Profiler et en savoir plus sur le champ sélectionné.

Relations

Le schéma illustre la relation entre chaque objet et un autre objet du modèle sélectionné. La forme de la ligne, qui est reliée à la vue ou au champ, est le reflet de la cardinalité de la relation entre les deux objets. Une ligne en diapason indique une cardinalité de type "plusieurs" et une seule ligne indique une cardinalité de type "une". La relation se présente comme suit : depuis la vue de base vers la vue jointe. Exemple :

  1. Participer à une réunion en tête-à-tête de order_items à inventory_items pour rejoindre le champ id
  2. Participation de plusieurs à plusieurs entre order_items et repeat_purchase_facts

Vous pouvez également pointer sur la ligne pour voir quel type de relation relie les deux objets.

Cliquez sur la ligne pour ouvrir Object Profiler afin d'afficher plus d'informations sur la jointure.

Options d'affichage du canevas

Une mini-carte en haut à droite de la toile peut vous aider à orienter l'emplacement dans des diagrammes plus grands. La partie grisée de la carte indique la partie du diagramme qui s'affiche sur la toile. Cliquez sur l'espace vide du canevas et faites-le glisser pour accéder à d'autres parties du diagramme.

Une barre d'outils verticale située en bas à gauche de la toile contient des icônes permettant de contrôler l'affichage du diagramme:

  • Cliquez sur (+) pour faire un zoom avant et sur (-) pour faire un zoom arrière.
  • Cliquez sur l'icône carrée pour revenir à la position de départ par défaut du diagramme.
  • Cliquez sur l'icône de carte pour activer ou désactiver la mini-carte.

Afficher des informations sur un objet avec Object Profiler

Le profileur d'objets affiche des informations sur l'objet sélectionné. Cliquez sur n'importe quel onglet "Explorer", "Afficher", "Champ" ou "Joindre" sur le canevas de schéma pour ouvrir l'objet Profiler sur le côté droit de la toile. Cliquez sur la toile pour réduire le générateur d'objets.

Explorations

Cliquez sur l'icône d'information "Explorer" (cercle &i;) sur le côté droit de la barre de titre de l'objet.

Pour l'onglet "Explorer" sélectionné dans le panneau Paramètres du diagramme, le générateur d'objets affiche les éléments suivants:

  • Libellé: valeur de l'élément Explorer label.
  • Libellé du groupe : valeur du paramètre group_label, qui combine les explorations en groupes personnalisés dans le menu Parcourir de Looker. Si aucun libellé de groupe n'est défini pour l'exploration, le nom du modèle est utilisé par défaut.
  • Project Name (Nom du projet) : nom du projet LookML, tel que défini dans les paramètres du projet.
  • Connection Name (Nom de connexion) : valeur du paramètre connection, qui spécifie la connexion à la base de données à partir de laquelle un modèle récupère les données.

Si vous êtes autorisé à afficher LookML, vous pouvez cliquer sur Go to LookML (Accéder à LookML) en bas à gauche de l'objet Profiler pour ouvrir le fichier dans lequel l'exploration est définie. Le fichier s'ouvre dans un nouvel onglet du navigateur, et la ligne explore est encadrée.

Vues

Cliquez sur une vue du canevas.

Le profileur d'objets affiche le nom de la table SQL s'il est défini dans le LookML de la vue. Si aucun sql_table_name n'est défini pour la vue, le nom de la table SQL est affiché sous la forme unknown.

Si vous êtes autorisé à afficher LookML, vous pouvez cliquer sur Go to LookML (Accéder à LookML) en bas à gauche de l'objet Profiler pour ouvrir le fichier dans lequel l'exploration à laquelle la vue est associée a été définie. Le fichier s'ouvre dans un nouvel onglet du navigateur, et la ligne explore est encadrée.

Champs

Cliquez sur un champ du diagramme.

Le profileur d'objets affiche le nom, le type et la valeur de type du champ, et si ce champ est une clé primaire en haut du panneau. Les deux onglets du profileur (Détails et Code) contiennent des informations supplémentaires sur le champ.

Dans l'onglet Détails, vous pouvez afficher:

  • Nom de la vue: nom de la vue à laquelle le champ appartient.
  • Libellé : apparence du champ dans la section Données d'une exploration, qui correspond au nom ou au libellé de la vue suivi du nom ou du libellé du champ.
  • Distribution: pour les dimensions numériques sur une vue avec une mesure comportant type: count, cliquez sur Calculer pour afficher un aperçu d'un graphique à colonnes représentant la répartition des valeurs de comptabilisation. La section Distribution affiche également les valeurs minimale, maximale et moyenne de la série de dimensions numériques.
  • Valeurs: pour les dimensions numériques sur une vue avec une mesure comportant type: count, cliquez sur Calculer pour afficher un aperçu des valeurs de décompte. Cliquez sur Explorer plus pour ouvrir la section "Explorer" à laquelle ce champ appartient.

Dans l'onglet Code, vous pouvez afficher les paramètres et les sous-paramètres du champ.

Si vous êtes autorisé à afficher LookML, vous pouvez cliquer sur Go to LookML (Accéder à LookML) en bas à gauche de l'objet Profiler pour ouvrir le fichier dans lequel la jointure est définie. Le fichier s'ouvre dans un nouvel onglet de navigateur au niveau de la ligne Explorer.

Si vous êtes autorisé à explorer des données, cliquez sur Explorer avec un champ en bas à droite du profileur d'objets pour ouvrir un champ "Explorer avec ce champ" présélectionné dans l'outil de sélection du champ "Explorer".

Jointures

Cliquez sur une jointure sur la toile du diagramme.

Le profileur d'objets affiche l'instruction de jointure qui décrit la relation ainsi que le type et la cardinalité de la jointure.

Si vous êtes autorisé à afficher LookML, vous pouvez cliquer sur Go to LookML (Accéder à LookML) en bas à gauche de l'objet Profiler pour ouvrir le fichier dans lequel la jointure est définie. Le fichier s'ouvre dans un nouvel onglet de navigateur au niveau de la ligne Explorer.