Plusieurs paramètres LookML permettent de rendre les explorations plus attrayantes en modifiant l'aspect des champs affichés dans l'interface utilisateur sans changer le code LookML sous-jacent. Cette page présente les paramètres LookML permettant de modifier l'apparence du menu d'exploration de Looker et du sélecteur de champ.
| Dans Looker, vos utilisateurs peuvent voir la liste des explorations dans le menu Explore (Explorer). | Dans une exploration, les utilisateurs peuvent se servir du sélecteur de champs pour choisir les champs (dimensions et mesures) à utiliser pour interroger leurs données. |
|
|
Cette page présente les paramètres les plus courants, accompagnés d'un lien vers une page de référence complète, d'une courte description de leur fonction et d'une image en illustrant les effets.
Pour obtenir des conseils et des suggestions sur la création d'une exploration conviviale, consultez la page Bonnes pratiques Bonnes pratiques: créer une expérience positive pour les utilisateurs de Looker.
Noms d'explorations et menu Exploration
Cette section décrit le comportement par défaut du nom et de l'apparence d'une exploration dans le menu Explore (Exploration), puis décrit les paramètres LookML permettant de modifier ce comportement:
Comportement par défaut du menu Exploration
Noms de modèles
Par défaut, le menu Explorer est organisé en noms de modèles, qui sont déterminés par le nom de chaque fichier de modèle. Le menu Explorer affiche une version mise en forme du nom du modèle, avec des traits de soulignement remplacés par des espaces et chaque mot commence par une majuscule. Sous chaque nom de modèle figure la liste des explorations définies dans le fichier de ce modèle.
Noms d'explorations
Le nom de chaque exploration du menu est basé sur le paramètre explore correspondant dans le fichier de modèle. À l'instar des noms de modèles, les noms d'explorations affichés dans le menu sont mis en forme. Les traits de soulignement sont ainsi remplacés par des espaces et chaque mot commence par une majuscule. Les noms d'explorations sont également utilisés comme intitulés au-dessus du sélecteur de champs.
Dans l'exemple suivant, l'exploration order_items est définie dans le fichier de modèle e_commerce_model.model:
explore: order_items {
join: orders {
type: left_outer
sql_on: ${order_items.order_id} = ${orders.id} ;;
relationship: many_to_one
}
}
L'exploration order_items apparaît en tant que Order Items (Éléments de la commande) dans le menu d'exploration et le sélecteur de champs.
| Menu Exploration : | Sélecteur de champ: |
 |
 |
Pour en savoir plus sur les fichiers de modèle, consultez la page de documentation Comprendre les fichiers de modèle et de vue. Pour en savoir plus sur la définition des explorations, consultez la page de documentation sur les paramètres explore.
label (modèle)
Le paramètre label d'un modèle renomme celui-ci dans le menu Explorer, sans en modifier le référencement dans LookML. Les URL d'explorations, l'environnement IDE de Looker et SQL Runner font toujours référence au nom réel du modèle ; la façon dont le modèle doit être indiqué dans les paramètres LookML et Admin reste inchangée.
Par défaut, le modèle market_research.model est intitulé Étude de marché dans le menu "Explorer".
Vous pouvez utiliser le paramètre label pour renommer le modèle dans le menu Exploration. Par exemple, vous ajoutez le code label: "Marketing R&D" au fichier de modèle market_research.model:
label: "Marketing R&D"
Dans cet exemple, Looker affiche le nom de modèle comme suit dans le menu Exploration :
label (exploration)
Le paramètre label d'une exploration renomme une exploration dans le menu Explore (Explorer) et sur la page "Explore" (Exploration) sans modifier sa référence dans LookML.
Si le paramètre label n'est pas utilisé, le nom de l'exploration s'affiche conformément à son comportement par défaut.
group_label (exploration)
Le paramètre group_label d'une exploration modifie l'organisation par défaut du menu Explorer. Au lieu de lister chaque exploration sous le nom de son modèle, group_label vous permet de définir un titre personnalisé sous lequel une ou plusieurs explorations seront présentées.
Dans cet exemple, les explorations Clients, Inventaire, Articles de la commande et Données utilisateur sont répertoriés sous le libellé de groupe Requêtes de la boutique en ligne:
description (exploration)
Le paramètre description d'une exploration vous permet d'ajouter sa description à l'interface utilisateur, afin que les utilisateurs puissent obtenir des informations supplémentaires lorsqu'ils créent des rapports.
Les utilisateurs peuvent voir cette description en passant le curseur sur l'icône d'information, en regard du nom de l'exploration affiché en haut du sélecteur de champs. Cette icône d'information figure également dans la liste déroulante des explorations. Si vous n'ajoutez pas explicitement de description à une exploration, aucune description ne s'affiche.
hidden (exploration)
Le paramètre hidden d'une exploration la masque dans le menu Exploration. Par défaut, hidden est désactivé et l'exploration est affichée. hidden ne masque pas le code LookML et n'empêche pas l'accès à une exploration via l'URL. hidden n'est pas conçu comme une fonctionnalité de sécurité, mais plutôt comme une fonctionnalité de présentation.
Par exemple, l'ajout du code LookML hidden: yes au code LookML de l'exploration inventory dans l'exemple suivant masque l'exploration Inventory (Inventaire) dans le menu Exploration:
explore: inventory {
hidden: yes
join: order_facts {
view_label: "Orders"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Sélecteur de champs
Cette section décrit le comportement par défaut du sélecteur de champs, puis les paramètres LookML permettant de modifier ce comportement.
Les paramètres suivants permettent de modifier la présentation des noms de vues dans le sélecteur de champs :
Les paramètres suivants permettent de modifier la présentation des noms de champs dans le sélecteur de champs :
Les paramètres suivants permettent de modifier l'organisation des champs dans le sélecteur de champs :
Comportement par défaut du sélecteur de champs
Par défaut, le sélecteur de champs est organisé en en-têtes correspondant aux vues spécifiées par le paramètre LookML view. Les champs de chaque vue sont regroupés dans le sélecteur de champs. Le type du champ (dimension, groupe de dimensions, mesure, champ de filtrage ou champ de paramètre) détermine son emplacement au sein de la vue. À moins que le paramètre label ne soit utilisé pour modifier le nom à afficher, le sélecteur de champs affiche une version mise en forme du nom de la vue ou du champ LookML, avec des traits de soulignement remplacés par des espaces et chaque mot commence par une majuscule.
Dans l'exemple suivant, Looker affiche la vue accounts sous la forme Accounts (Comptes) dans le sélecteur de champs, ce qui est le comportement par défaut:
view: accounts {
sql_table_name: accounts ;;
}
L'exemple suivant montre comment les noms d'une dimension, d'un groupe de dimensions et d'une mesure s'affichent par défaut. La même mise en forme est appliquée aux noms des champs de filtrage et de paramètre.
dimension: account_number {
primary_key: yes
type: number
sql: ${TABLE}.account_number ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
dimension_group: created {
type: time
timeframes: [raw, time, date, week, month, quarter, year]
sql: ${TABLE}.created_date ;;
}
measure: average_annual_revenue {
type: average
sql: ${annual_revenue} ;;
value_format_name: custom_amount_value_format
}
Dans cet exemple, le sélecteur de champs affiche les noms de champs par défaut Numéro de compte, Nom, Date de création et Revenu annuel moyen pour les dimensions account_number et name, le groupe de dimensions created et la mesure average_annual_revenue, respectivement.
Si vous modifiez le nom d'un champ, le sélecteur de champs s'adapte au nouveau nom, mais vous pouvez ajouter un paramètre alias avec l'ancien nom du champ. Ce paramètre permet de définir d'autres noms pour un champ, susceptibles de figurer dans l'URL d'une requête. Cela peut s'avérer utile lorsque les noms des champs d'un modèle changent, mais que certaines personnes ont partagé des liens vers des données et que vous souhaitez que ces URL préexistantes continuent de fonctionner.
view_label (exploration)
Le paramètre view_label d'une exploration modifie la façon dont le groupe de champs de sa vue de base est libellé dans le sélecteur de champs, sans modifier la façon dont l'exploration et ses champs sont référencés dans LookML.
Par exemple, si vous joignez une vue order_facts à une exploration appelée order_items, vous pouvez utiliser le paramètre view_label pour définir le libellé que Looker affiche pour la vue order_facts dans le sélecteur de champs, comme suit:
explore: order_items {
label: "Order Items"
join: order_facts {
view_label: "Orders and more"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Dans cet exemple, la vue order_facts apparaît sous la forme Orders and more (Commandes et autres) dans le sélecteur de champs de l'exploration Order Items (Articles de la commande).
view_label (inscription)
Le paramètre view_label d'une jointure vous permet de regrouper les champs d'une vue sous le nom d'une autre vue dans le sélecteur de champs. Si vous n'ajoutez pas explicitement de view_label à une jointure, view_label est défini par défaut sur le nom de la jointure.
Par exemple, vous joignez la vue products à l'exploration product_facts:
explore: product_facts {
join: products {
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Dans cet exemple, comme aucun libellé de vue n'est spécifié, les champs de la vue products sont regroupés sous le libellé de la vue Products dans le sélecteur de champs, séparément de la vue Product Facts (Informations sur le produit) :
Vous pouvez utiliser le paramètre view_label pour ajouter un libellé de vue à la vue products jointe, comme dans l'exemple suivant:
explore: product_facts {
join: products {
view_label: "Product Facts"
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Cela regroupe les champs de la vue products sous le libellé de vue Product Facts (Facts sur le produit) dans le sélecteur de champs:
label (vue)
Le paramètre label d'une vue modifie l'étiquetage de cette vue dans le sélecteur de champs, sans modifier la façon dont elle est référencée dans LookML. Par défaut, le libellé affiché est le nom de la vue. Contrairement à view_label (Exploration) et view_label (Jointure), ce paramètre affecte toutes les explorations qui utilisent la vue.
Par exemple, vous pouvez utiliser le paramètre label afin de spécifier un libellé pour la vue inventory_items comme suit:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
Dans cet exemple, le sélecteur de champs affiche le libellé Items in Inventory (Articles de l'inventaire) pour la vue inventory_items, au lieu du libellé par défaut Inventory Items (Éléments d'inventaire).
description (champ)
Vous pouvez ajouter un description à n'importe quel champ. Pour les connexions BigQuery, si vous générez un projet LookML à partir de votre base de données, Looker remplira automatiquement les descriptions de champs avec les descriptions issues des métadonnées de vos colonnes BigQuery, le cas échéant.
Cette description est visible par l'utilisateur à plusieurs endroits. Looker affiche la description lorsque l'utilisateur sélectionne l'icône d'informations à droite du nom du champ dans le sélecteur de champs.
En outre, Looker affiche également la description lorsque l'utilisateur pointe sur le nom de la colonne dans une table ou une visualisation sous forme de tableau dans une exploration, un tableau de bord ou une présentation.
hidden (champ)
Par défaut, les champs spécifiés dans une vue s'affichent dans le sélecteur de champs. Le paramètre hidden du champ masque un champ dans le sélecteur de champs.
Les champs masqués restent accessibles dans l'interface utilisateur à condition d'être ajoutés manuellement à l'URL, et apparaissent dans certaines fenêtres Looker. Par conséquent, considérez hidden comme un moyen de garder le sélecteur de champ propre, et non comme une fonctionnalité de sécurité.
Par exemple, l'ajout du code LookML hidden: yes au code LookML de la dimension product_id dans l'exemple suivant masque la dimension Product ID (ID produit) dans le sélecteur de champs:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (champ)
Le paramètre fields permet de spécifier les champs de la vue de base d'une exploration et les jointures qui sont exposés dans le sélecteur de champs. Si vous n'utilisez pas le paramètre fields, Looker affiche tous les champs.
Pour spécifier les champs que vous souhaitez afficher dans le sélecteur de champs, utilisez une liste ou des ensembles de champs séparés par des virgules. Pour indiquer les champs que vous souhaitez masquer dans le sélecteur de champs, utilisez l'ensemble ALL_FIELDS* avec une liste des champs ou ensembles à exclure séparés par une virgule, précédés d'un tiret (-).
Par exemple, vous pouvez utiliser le code LookML suivant pour n'afficher qu'une sélection de champs de l'exploration aircraft dans le sélecteur de champs:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
Dans cet exemple, l'exploration Avion n'affiche que les dimensions Code du modèle de l'avion, Code du moteur de l'avion, Ville, Pays et Code postal, ainsi que la mesure Nombre dans le sélecteur de champs.
label (champ)
Le paramètre label d'un champ vous permet de modifier l'apparence d'un nom de champ dans le sélecteur de champs, sans modifier la façon dont il est référencé dans LookML. Par défaut, si ce paramètre n'est pas défini, le libellé affiché est le nom du champ.
Par exemple, vous pouvez utiliser le paramètre label afin de définir un libellé pour la dimension cost comme suit:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
Dans cet exemple, la dimension Coût est associée au libellé price dans le sélecteur de champs.
view_label (champ)
Le paramètre view_label d'un champ vous permet de modifier le nom de la vue sous laquelle le champ est répertorié dans le sélecteur de champs, sans modifier la façon dont il est référencé dans LookML. Par défaut, si ce paramètre n'est pas utilisé, le champ apparaît sous le libellé de la vue dans laquelle il est défini.
Par exemple, vous pouvez utiliser le paramètre view_label comme suit afin de spécifier un libellé de vue pour la dimension cost:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
Dans cet exemple, Looker affiche la dimension Coût sous le libellé de vue Informations sur les coûts dans le sélecteur de champs.
group_label (champ)
Le paramètre group_label vous permet de combiner des champs dans une liste déroulante commune au sein d'une vue du sélecteur de champs.
Dans cet exemple, le groupe Shipping Info comprend les champs Shipping City (Ville de la livraison), Shipping Country (Pays de livraison) et Shipping State (État de la livraison) :
group_item_label (champ)
Lorsque des champs sont affichés sous un libellé de groupe, il n'est pas nécessaire d'afficher leur nom ou leur libellé complet dans le sélecteur de champs. Dans l'exemple précédent pour group_label (champ), le libellé du groupe indique déjà que les champs concernent la livraison. Dans ce cas, vous pouvez ajouter le paramètre group_item_label à chacun de ces champs groupés pour modifier leur apparence sous le libellé de groupe.
Dans cet exemple, le groupe Shipping Info comprend les champs City (Ville), Country (Pays) et State (État) :
