libellé (pour les champs)

Cette section fait référence au paramètre label qui fait partie d'un champ.

label peut également être utilisé dans un modèle, comme décrit sur la page de documentation du paramètre label (pour les modèles).

label peut également être utilisé dans une exploration, comme décrit sur la page de documentation du paramètre label (pour les explorations) .

label peut également être utilisé dans une vue, comme décrit sur la page de documentation du paramètre label (pour les vues).

label peut également être utilisé dans une ligne de référence, comme décrit sur la page de documentation Paramètres des lignes de référence du tableau de bord.

Utilisation

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}
Hiérarchie
view
Type de champ
label
Types de champs possibles
Dimension, groupe de dimensions, mesure, filtre, paramètre

Acceptation
Chaîne

Définition

label permet de rendre les explorations plus conviviales en vous permettant de choisir comment les noms de champs apparaissent dans le sélecteur de champs et dans le tableau de données d'une exploration. Par défaut, si ce paramètre n'est pas défini, le libellé affiché est le nom du champ.

Variables Liquid avec label

Vous pouvez utiliser des variables Liquid avec le paramètre label. Les variables Liquid vous permettent d'accéder à des données telles que des informations sur un modèle ou une exploration, des filtres appliqués à un champ et des valeurs d'attribut utilisateur. Vous pouvez utiliser des variables Liquid pour modifier dynamiquement la valeur label, ce qui modifie l'apparence du champ dans le sélecteur de champ et les visualisations de données.

Les variables Liquid qui renvoient une valeur basée sur un filtre, comme _filters, ou qui nécessitent l'exécution d'une requête au préalable, comme in_query, ne modifient pas le nom du champ dans le sélecteur de champ. Dans ce cas, le nom du champ ne sera modifié que dans la visualisation obtenue.

Par exemple, la variable Liquid {{ _user_attributes['name_of_attribute'] }} remplace la variable Liquid par la valeur de l'attribut utilisateur spécifié. Si un utilisateur disposait d'un attribut utilisateur appelé name avec la valeur "John Smith", la syntaxe label suivante modifierait le nom du champ dans le sélecteur de champ en John Smith :

label: "{{ _user_attributes['name'] }}"

Dans l'exemple suivant, la dimension name utilise la structure Liquid {% if %} {% else %} {% endif %} avec la variable Liquid _user_attributes['name_of_attribute'] pour modifier sa valeur label en fonction d'un attribut utilisateur company :

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

Vous trouverez d'autres exemples d'utilisation de label avec des variables Liquid pour définir des libellés dynamiques sur la page des bonnes pratiques Utilisations intéressantes de Liquid dans les libellés.

Exemple

Faites en sorte que cette mesure s'affiche sous le nom Nombre de clients au lieu de Nombre de clients distincts dans le sélecteur de champs.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Éléments à prendre en compte

L'IDE signale les libellés en double dans une vue.

Pour éviter les libellés de champ en double dans la même vue, l'IDE Looker affiche une icône d'information à côté du numéro de ligne de tout libellé de champ en double dans un fichier de vue LookML. Si vous pointez sur l'icône d'informations à côté du numéro de ligne, l'info-bulle indique qu'un champ portant ce libellé existe déjà dans la vue.

L'IDE Looker affichera les mêmes informations dans le panneau Aide rapide si vous sélectionnez le texte de l'instruction label dans l'IDE :