Le diagramme LookML est une extension (une application Web créée à l'aide de composants Looker) développée à l'aide du framework d'extension Looker et déployée via la place de marché Looker.
Le diagramme LookML est un diagramme des entités et des relations d'un modèle LookML qui illustre visuellement les relations entre ses objets LookML. Utilisez cette extension pour:
- Évaluer la structure du modèle LookML, identifier les domaines dans lesquels LookML peut être consolidé et déterminer la meilleure façon d'ajouter des éléments au modèle
- Identifier les erreurs de logique, ce qui réduit les risques de calculs incorrects et de mauvaises performances des requêtes
- Découvrez comment modéliser des données à l'aide de code (LookML).
Cette page de documentation explique comment utiliser le diagramme LookML version 2.0.0 ou ultérieure. Les administrateurs Looker doivent consulter la page de documentation Configurer l'extension LookML Diagram pour savoir comment activer cette extension pour les utilisateurs de Looker.
Cette page explique comment:
- Accéder au schéma LookML
- Observer les relations entre les objets LookML avec le diagramme LookML
- Configurer les paramètres du diagramme
- Configurer les options d'affichage d'une exploration
- Interpréter le canevas du diagramme
- Observer les informations sur les objets avec le Profileur d'objets
Accéder au schéma LookML
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 carte Diagramme LookML.
Observer les relations entre les objets LookML avec le diagramme LookML
Votre administrateur Looker doit vous accorder des autorisations pour le modèle lookml_diagram et tout modèle que vous souhaitez afficher dans l'extension.
L'extension LookML Diagram se compose des éléments suivants:
- Un panneau Paramètres du diagramme pour sélectionner un modèle, une branche Git et une exploration
- Un panneau Options de vue pour affiner les champs que vous souhaitez afficher
- Une section Aide sur le diagramme pour fournir des explications supplémentaires sur les éléments du diagramme
- Un canevas de diagramme pour interagir avec les objets LookML de l'exploration sélectionnée
- Liste des champs d'une exploration sélectionnée, regroupés par vue
- 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 du canevas, qui permet de s'orienter dans un diagramme plus vaste
- Un outil de profilage d'objets pour afficher des informations sur l'objet LookML et accéder à son LookML ou à son exploration associés, le cas échéant
Double-cliquez sur l'icône Paramètres du diagramme ou sur l'icône 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 les paramètres du diagramme.
La liste déroulante Choisir un modèle affiche tous les modèles pour lesquels vous disposez des autorisations nécessaires pour les afficher. Une fois que vous avez sélectionné un modèle, deux options supplémentaires s'affichent:
La liste déroulante Branche actuelle affiche 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), celle-ci s'affiche. Si vous êtes en mode Production ou si vous ne disposez pas des autorisations nécessaires pour modifier les branches Git, le menu déroulant Branche actuelle est désactivé.
Si votre administrateur vous a accordé les autorisations nécessaires pour modifier les branches Git dans le diagramme LookML, activez le mode développement, assurez-vous qu'un modèle et une exploration sont sélectionnés, puis sélectionnez une branche pour afficher le diagramme en fonction de la configuration du modèle sur cette branche.
La liste Sélectionner une exploration s'affiche avec la liste des explorations de ce modèle. Cliquez sur le nom d'une exploration pour afficher ses champs, regroupés par vue, sur le canevas de la page.
Découvrir les options de visionnage
Une fois une exploration sélectionnée, vous pouvez utiliser le panneau Options de vue pour limiter les champs et les vues affichés sur le canevas.
Limiter les champs affichés
Vous pouvez choisir d'afficher tous les champs de chaque vue de l'exploration en sélectionnant Tous les champs sous Champs à afficher. Pour n'afficher que les vues dont les champs sont joints à d'autres champs, sélectionnez Champs avec jointures.
Si elle est activée, l'option Masquer les champs masqués masque tous les champs qui contiennent hidden: yes dans leur code LookML sous-jacent. Le bouton bascule Masquer les champs masqués est activé par défaut.
Limiter les vues affichées
La section Vues du panneau Options de vue affiche la liste des vues présentes dans l'exploration sélectionnée. Par défaut, toutes les vues sont affichées sur le canevas du diagramme. Lorsque vous masquez une vue, l'objet de vue et les jonctions qui le relient à d'autres objets de l'exploration sont masqués du canevas du diagramme.
Cliquez sur Masquer tout pour masquer toutes les vues de l'exploration depuis le canevas du diagramme. Cliquez sur Tout afficher pour afficher toutes les vues de cette exploration.
Vous pouvez également masquer des vues spécifiques du canevas en désélectionnant l'icône en forme d'œil à droite de leur nom. Lorsque la vue est masquée, son nom apparaît en gris et l'icône en forme d'œil est barrée d'un trait. Pour afficher une vue masquée, cliquez sur l'icône en forme d'œil barré.
Interpréter le canevas du diagramme
Le canevas du diagramme LookML est l'endroit où toutes les entités et relations d'une exploration donnée sont représentées. Dans le langage Looker, vous pouvez considérer le diagramme LookML comme une représentation de la façon dont les objets LookML sont associés dans une exploration pour un modèle donné.
La barre de titre de l'objet en haut du canevas affiche le nom de l'exploration dont les vues sont affichées sur le canevas. Cliquez sur l'icône d'informations sur l'exploration (un "i" entouré) dans la barre de titre de l'objet pour ouvrir le profileur d'objet et en savoir plus sur l'exploration sélectionnée. Cliquez sur la flèche dans le sens des aiguilles d'une montre pour actualiser l'extension.
Entités
Chaque vue de l'exploration est représentée par son propre ensemble d'entités, avec le nom de la vue en haut de l'ensemble:
- La vue de base d'Explore est indiquée par un arrière-plan bleu foncé.
- Les vues jointes de l'exploration ont un arrière-plan bleu clair.
Lorsqu'une jointure, une vue ou un champ est sélectionné, il est mis en surbrillance en bleu clair.
Sous chaque vue se trouve la liste des champs qui lui appartiennent:
Les dimensions sont listées en haut.
Les mesures sont listées en bas et surlignées en orange clair.
Si le champ est une clé primaire, une icône en forme de clé s'affiche à droite du nom du champ.
À gauche de chaque champ, une icône indique son type:
- A: les dimensions de
type: string - #: dimensions ou mesures de
type: number - Barres à plusieurs niveaux: dimensions de
type: tier - Cochez la case: dimensions de
type: yesno - Agenda: dimensions de
type: date,type: date_timeettype: time - Point de la carte: dimensions de
type: location,type: distanceettype: zipcode
Cliquez sur le nom du champ pour ouvrir l'outil de profilage des objets et en savoir plus sur le champ sélectionné.
Relations
Le diagramme utilise une ligne pour représenter la relation entre chaque objet du modèle sélectionné. La forme de la ligne, à l'endroit où elle se rattache à la vue ou au champ, indique la cardinalité de la relation entre les deux objets. Une ligne bifurquée indique une cardinalité "plusieurs", tandis qu'une ligne unique indique une cardinalité "un". Vous devez lire la relation comme de la vue de base à la vue jointe. Exemple :
- Une jointure individuelle de
order_itemsàinventory_items, effectuée sur le champid - Une jointure de plusieurs à un de
order_itemsàrepeat_purchase_facts
Vous pouvez également pointer sur la ligne pour voir le type de jointure qui relie les deux objets.
Cliquez sur la ligne pour ouvrir l'outil de profilage des objets et afficher plus d'informations sur la jointure.
Options d'affichage du canevas
Une mini-carte en haut à droite du canevas peut vous aider à vous orienter dans des diagrammes plus grands. La partie grisée de la carte indique la partie du diagramme actuellement affichée sur le canevas. Cliquez sur l'espace vide du canevas et faites-le glisser pour vous déplacer vers d'autres parties du diagramme.
Une barre d'outils verticale en bas à gauche du canevas 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 sur le diagramme.
- 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 la carte pour activer ou désactiver la mini-carte.
Afficher des informations sur les objets avec le profileur d'objets
Le Profileur d'objets affiche des informations sur l'objet sélectionné. Cliquez sur une exploration, une vue, un champ ou une jointure sur le canevas du diagramme pour ouvrir le Profileur d'objets à droite du canevas. Cliquez sur le canevas pour réduire le Profileur d'objets.
Explorations
Cliquez sur l'icône d'informations d'exploration (un "i" entouré) sur le côté droit de la barre de titre de l'objet.
Pour l'exploration sélectionnée dans le panneau Paramètres du diagramme, le profileur d'objets affiche:
- Libellé: valeur de l'exploration
label. - Libellé de groupe: valeur du paramètre
group_label, qui combine les explorations en groupes personnalisés dans le menu Explorer de Looker. Si aucun libellé de groupe n'est défini pour l'exploration, le nom du modèle est utilisé par défaut. - Nom du projet: nom du projet LookML, tel que défini dans les paramètres du projet.
- Nom de la connexion: valeur du paramètre
connection, qui spécifie la connexion à la base de données à partir de laquelle un modèle récupérera les données.
Si vous disposez des autorisations nécessaires pour afficher le code LookML, vous pouvez cliquer sur Accéder à LookML en bas à gauche du Profileur d'objets pour ouvrir le fichier dans lequel l'exploration est définie. Le fichier s'ouvre dans un nouvel onglet du navigateur, et la ligne de l'explore est mise en surbrillance.
Vues
Cliquez sur une vue dans le canevas du diagramme.
Le profileur d'objets affiche le nom de la table SQL s'il est défini dans le code LookML de la vue. Si aucun sql_table_name n'est défini pour la vue, le nom de table SQL est affiché sous la forme unknown.
Si vous êtes autorisé à afficher le code LookML, vous pouvez cliquer sur Accéder à LookML en bas à gauche de l'outil de profilage des objets pour ouvrir le fichier dans lequel est définie l'exploration à laquelle la vue est jointe. Le fichier s'ouvre dans un nouvel onglet du navigateur, et la ligne de l'explore est mise en surbrillance.
Champs
Cliquez sur un champ du canevas du diagramme.
En haut du panneau, le profileur d'objets affiche le nom, le type et la valeur du type du champ, ainsi que si le champ est une clé primaire. Deux onglets du profileur, Details (Détails) et Code (Code), affichent des informations supplémentaires sur le champ.
Dans l'onglet Détails, vous pouvez consulter les éléments suivants:
- Nom de la vue: nom de la vue à laquelle le champ appartient.
- Libellé: façon dont le champ apparaîtra dans la section "Données" d'une exploration. Il s'agit du nom ou du libellé de la vue, suivi du nom ou du libellé du champ.
- Distribution: pour les dimensions numériques d'une vue avec une mesure associée à
type: count, cliquez sur Calculer pour afficher un aperçu d'un graphique en colonnes illustrant la distribution des valeurs de nombre. La section Distribution affiche également les valeurs minimale, maximale et moyenne de la série de la dimension numérique. - Valeurs: pour les dimensions numériques d'une vue avec une mesure associée à
type: count, cliquez sur Calculer pour afficher un aperçu des valeurs de comptage. Cliquez sur Explorer plus pour ouvrir l'exploration à laquelle ce champ appartient.
Dans l'onglet Code, vous pouvez afficher le paramètre et les sous-paramètres du champ.
Si vous êtes autorisé à afficher LookML, vous pouvez cliquer sur Accéder à LookML en bas à gauche du Profileur d'objets pour ouvrir le fichier dans lequel la jointure est définie. Le fichier s'ouvre dans un nouvel onglet de navigateur à la ligne de l'exploration de la demande d'association.
Si vous disposez des autorisations nécessaires pour explorer les données, cliquez sur Explorer avec un champ en bas à droite du profileur d'objets pour ouvrir une exploration avec ce champ présélectionné dans le sélecteur de champ d'exploration.
Jointures
Cliquez sur une association dans le canevas du diagramme.
Le Profileur d'objets affiche l'instruction de jointure qui décrit la relation de jointure, ainsi que le type et la cardinalité de la jointure.
Si vous êtes autorisé à afficher LookML, vous pouvez cliquer sur Accéder à LookML en bas à gauche du Profileur d'objets pour ouvrir le fichier dans lequel la jointure est définie. Le fichier s'ouvre dans un nouvel onglet de navigateur à la ligne de l'exploration de la demande d'association.