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 Exploration de Looker et du sélecteur de champs.
| Dans Looker, vos utilisateurs peuvent voir les explorations dans le menu Explorer. | Dans une exploration, les utilisateurs peuvent utiliser le 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: 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 Explorer, 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 dans le 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. Le nom de l'exploration apparaît également comme titre dans le panneau 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 dans le menu "Explorer" et le sélecteur de champs.
| Menu Exploration : | Sélecteur de champs: |
 |
 |
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 d'explorations, consultez la page de documentation du paramètre explore.
label (modèle)
Le paramètre label d'un modèle renomme ce dernier dans le menu Explorer sans modifier ses références 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 apparaît en tant qu'é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 (Explorer)
Le paramètre label d'une exploration renomme une exploration dans le menu Explorer et sur la page "Explorer" 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 (Explorer)
Le paramètre group_label d'une exploration modifie l'organisation par défaut du menu Explorer. Au lieu de répertorier chaque exploration sous le nom de son modèle, group_label vous permet de définir un titre personnalisé sous lequel répertorier une ou plusieurs explorations.
Dans cet exemple, les explorations Clients, Inventaire, Articles commandés et Données utilisateur sont répertoriées sous le libellé de groupe Requêtes de la boutique en ligne:
description (Explorer)
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 (Explorer)
Le paramètre hidden d'une exploration masque l'exploration dans le menu Explorer. Par défaut, hidden est désactivé et l'exploration est affichée. hidden ne masque pas LookML et n'empêche pas l'accès à une exploration via l'URL. hidden n'est pas une fonctionnalité de sécurité, mais plutôt une fonctionnalité de présentation.
Par exemple, l'ajout du code LookML hidden: yes au LookML de l'exploration inventory dans l'exemple suivant masque l'exploration Inventory (Inventaire) dans le menu Explore:
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 de la vue ou du nom de champ LookML, avec des traits de soulignement remplacés par des espaces et chaque mot en majuscules.
Dans l'exemple suivant, Looker affiche la vue accounts sous la forme Accounts (Comptes) dans le sélecteur de champs, ce qui correspond au 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 être 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 (Explorer)
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 manière 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 l'étiquette que Looker affichera 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.
view_label (participer)
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 un 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 vue Products (Produits) du sélecteur de champs, séparément de la vue Product Facts (Informations sur les produits) :
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
}
}
Cette opération regroupe les champs de la vue products sous le libellé de vue Product Facts (Informations sur le produit) du sélecteur de champs:
label (afficher)
Le paramètre label d'une vue modifie l'étiquetage de la 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é Articles de l'inventaire pour la vue inventory_items, au lieu du libellé par défaut É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 renseignera automatiquement les descriptions des 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.
De plus, 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 nettoyer le sélecteur de champs, et non comme une fonctionnalité de sécurité.
Par exemple, l'ajout du code LookML hidden: yes au LookML pour 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 vous permet de spécifier les champs de la vue de base et les jointures d'une exploration à afficher dans le sélecteur de champs. Si vous n'utilisez pas le paramètre fields, Looker affichera 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 spécifier les champs que vous souhaitez masquer dans le sélecteur de champs, utilisez l'ensemble ALL_FIELDS* avec une liste des champs ou des ensembles à exclure, séparés par une virgule, en les faisant précéder d'un trait d'union (-).
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 de modèle du vol, 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 la façon dont un nom de champ s'affiche 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é prix 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 le coût du 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 (Informations de livraison) comprend les champs Shipping City (Ville du colis), 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 (field), l'étiquette de groupe indique déjà que les champs se rapportent à 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 Informations de livraison comprend les champs Ville, Pays et État:
