Le schéma LookML est une extension (une application Web créée à l'aide de composants Looker) développée à l'aide du framework d'extension de Looker et déployée via Looker Marketplace.
Le schéma LookML est un diagramme de relation entre entités 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, identifier les domaines dans lesquels LookML peut être consolidé et déterminer la meilleure façon de l'ajouter au modèle
- Identifiez la logique incorrecte, ce qui réduit le risque de calculs incorrects et de mauvaises performances des requêtes.
- Apprendre à modéliser des données basées sur du code (LookML)
Cette page de documentation explique comment utiliser le schéma LookML version 2.0.0 et ultérieure. Les administrateurs Looker doivent se reporter à la page de documentation Configuration de l'extension de schéma LookML pour savoir comment activer cette extension pour les utilisateurs de Looker.
Cette page explique comment:
- Accéder au schéma LookML
- Observer les relations d'objets LookML à l'aide du schéma LookML
- Configurer les paramètres du schéma
- Configurer les options d'affichage d'une exploration
- Interpréter la toile du diagramme
- Observer des informations sur un objet avec le Profileur d'objet
Accès au schéma LookML
Une fois le schéma LookML installé, vous pouvez y accéder en cliquant sur Blocs dans le panneau de navigation de gauche, puis en sélectionnant la vignette Diagramme LookML.
Observer les relations d'objets LookML avec le schéma LookML
Votre administrateur Looker doit vous accorder des autorisations sur le modèle lookml_diagram et tout modèle que vous souhaitez afficher dans l'extension.
L'extension du schéma LookML se compose des éléments suivants:
- Un panneau Diagram Settings (Paramètres du diagramme) permettant de sélectionner un model, une branche Git et une exploration
- Un panneau View Options (Options d'affichage) pour affiner les champs que vous souhaitez afficher
- Une section d'aide sur le diagramme pour fournir une explication supplémentaire des éléments du diagramme.
- Canevas d'un diagramme permettant d'interagir avec les objets LookML de l'exploration sélectionnée
- Liste des champs d'une exploration sélectionnée, regroupés par vue
- 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 du canevas, qui vous aide à vous orienter dans un diagramme plus grand
- Un Profileur d'objet permettant d'afficher des informations sur l'objet LookML et d'accéder au code LookML ou à l'exploration associé, le cas échéant
Double-cliquez sur l'icône Diagram Settings (Paramètres du diagramme) ou sur l'icône View Options (Options d'affichage) pour réduire le panneau de gauche.
Configurer les paramètres du schéma
Cliquez sur l'icône représentant un diagramme dans la barre de navigation du diagramme pour afficher Diagram Settings (Paramètres du diagramme).
La liste déroulante Choisir un modèle liste tous les modèles que vous êtes autorisé à afficher. Une fois le modèle sélectionné, deux options supplémentaires apparaissent:
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), cette branche 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 autorisé à modifier les branches Git dans le schéma 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 contient la liste des explorations de ce modèle. Cliquez sur le nom d'une exploration pour voir ses champs, regroupés par vue, affichés sur la toile de la page.
Découvrir les options d'affichage
Lorsqu'une exploration est sélectionnée, vous pouvez utiliser le panneau Options d'affichage pour limiter les champs et les vues affichés sur la toile.
Limitation des 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 comprenant des champs joints à d'autres champs, sélectionnez Champs avec jointures.
Si cette option est activée, l'option Masquer les champs masqués masque tous les champs qui contiennent hidden: yes dans le code LookML sous-jacent. L'option Masquer les champs masqués est activée par défaut.
Limiter les vues affichées
La section Vues du panneau Options d'affichage liste les 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 View et toutes les jointures qui le relient à tout autre objet de l'exploration sont masqués dans la toile du diagramme.
Cliquez sur Tout masquer pour masquer toutes les vues de l'exploration dans la toile du diagramme. Cliquez sur Tout afficher pour faire réapparaître toutes les vues de cette exploration.
Vous pouvez également masquer certaines vues spécifiques dans la toile en désélectionnant l'icône représentant un œil à droite du nom de la vue. Lorsque la vue est masquée, son nom apparaît en gris et l'icône représentant un œil est barrée. Pour afficher une vue masquée individuelle, cliquez sur l'icône en forme d'œil barré.
Interpréter la toile des diagrammes
Le canevas de schéma LookML est l'endroit où sont représentées toutes les entités et relations d'une exploration donnée. Dans le langage vernaculaire de Looker, vous pouvez considérer le schéma LookML comme illustrant la façon dont les objets LookML sont joints dans une exploration pour un modèle donné.
La barre de titre des objets 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'informations de l'exploration (représentée par un "i" entouré d'un cercle) 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.
Entities
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:
- La vue de base de l'exploration est indiquée par un arrière-plan bleu foncé.
- Les vues jointes dans l'exploration ont un arrière-plan bleu clair.
Lorsqu'une jointure, une vue ou un champ est sélectionné, il est surligné en bleu vif.
Sous chaque vue se trouve une liste de champs appartenant à cette vue:
Les dimensions sont indiquées en haut.
Les mesures sont indiquées en bas et surlignées en orange clair.
S'il s'agit d'une clé primaire, une icône en forme de clé s'affiche à droite de son nom.
À gauche de chaque champ, une icône indique son type:
- A: dimensions de
type: string - #: dimensions ou mesures de
type: number - Barres échelonnées: dimensions de
type: tier - Coche: dimensions de
type: yesno - Agenda: dimensions de
type: date,type: date_timeettype: time - Point de la carte: dimensions de
type: location,type: distance,type: zipcode
Cliquez sur le nom du champ pour ouvrir le Profileur d'objet et en savoir plus sur le champ sélectionné.
Relations
Le diagramme utilise une ligne pour représenter la relation entre chaque objet et un autre objet dans le modèle sélectionné. La forme de la ligne, lorsqu'elle est reliée à la vue ou au champ, traduit la cardinalité de la relation entre les deux objets. Une ligne dupliquée indique une cardinalité "plusieurs", tandis qu'une seule ligne indique une cardinalité "un". Vous lirez la relation comme à partir de la vue de base et de la vue jointe. Exemple :
- Jointure individuelle de
order_itemsversinventory_itemsvia le champid - Jointure plusieurs à un de
order_itemsàrepeat_purchase_facts
Vous pouvez également pointer sur la ligne pour voir quel type de relation associe les deux objets.
Cliquez sur la ligne pour ouvrir le Profileur d'objets et afficher plus d'informations sur la jointure.
Options d'affichage des toiles
Une mini-carte en haut à droite du canevas peut vous aider à orienter votre position dans les diagrammes plus grands, la partie grisée de la carte indiquant la partie du diagramme qui est actuellement affichée sur le canevas. Cliquez et faites glisser l'espace vide dans la toile pour passer à 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 carte pour activer ou désactiver la mini-carte.
Afficher des informations sur un objet avec le Profileur d'objets
Le Profileur d'objet affiche des informations sur l'objet sélectionné. Cliquez sur une exploration, une vue, un champ ou une jointure sur la toile du diagramme pour ouvrir le Profileur d'objets sur le côté droit du canevas. Cliquez sur le canevas pour réduire le Profileur d'objets.
Explorations
Cliquez sur l'icône d'informations "Explorer" (icône en forme de "i" entourée d'un cercle) située à droite 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 s'affiche:
- Libellé: valeur de l'élément
labeld'exploration. - 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. - Project Name (Nom du projet) : nom du projet LookML, tel que défini dans les paramètres du projet.
- Connection Name (Nom de la connexion) : valeur du paramètre
connection, qui spécifie la connexion à la base de données à partir de laquelle le modèle va récupérer des données.
Si vous disposez des autorisations nécessaires pour afficher le code LookML, vous pouvez cliquer sur Go to LookML (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, avec la ligne explore mise en surbrillance.
Vues
Cliquez sur une vue de la toile du diagramme.
Le Profileur d'objet 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 la table SQL est affiché sous la forme unknown.
Si vous disposez des autorisations nécessaires pour afficher le code LookML, vous pouvez cliquer sur Go to LookML (Accéder à LookML) en bas à gauche du Profileur d'objets pour ouvrir le fichier contenant l'exploration à laquelle la vue est jointe. Le fichier s'ouvre dans un nouvel onglet du navigateur, avec la ligne explore mise en surbrillance.
Champs
Cliquez sur un champ dans la toile du diagramme.
Le Profileur d'objet affiche le nom, le type et la valeur du champ, ainsi que s'il s'agit d'une clé primaire en haut du panneau. Dans le profileur, les deux onglets Détails et Code affichent des informations supplémentaires sur le champ.
Dans l'onglet Détails, vous pouvez afficher les éléments suivants:
- View Name (Nom de la vue) : nom de la vue à laquelle appartient le champ.
- 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 d'une vue dont la mesure comporte
type: count, cliquez sur Calculate (Calculer) pour afficher un aperçu d'un graphique à colonnes illustrant la distribution des valeurs de décompte. 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 d'une vue dont la mesure comporte
type: count, cliquez sur Calculate (Calculer) pour afficher un aperçu des valeurs de décompte. Cliquez sur Explorer plus pour ouvrir l'exploration à laquelle ce champ appartient.
L'onglet Code affiche le paramètre et les sous-paramètres de champ.
Si vous disposez des autorisations nécessaires pour afficher le code LookML, vous pouvez cliquer sur Go to LookML (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, sur la ligne de l'exploration de la jointure.
Si vous disposez des autorisations nécessaires pour explorer les données, cliquez sur Explorer avec un champ en bas à droite du Profileur d'objet pour ouvrir une exploration dans laquelle ce champ est présélectionné dans le sélecteur de champs.
Jointures
Cliquez sur une jointure dans la toile du diagramme.
Le Profileur d'objet affiche l'instruction de jointure qui décrit la relation de jointure, ainsi que le type et la cardinalité de la jointure.
Si vous disposez des autorisations nécessaires pour afficher le code LookML, vous pouvez cliquer sur Go to LookML (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, sur la ligne de l'exploration de la jointure.