view_label (pour les jointures)

Cette page fait référence au paramètre view_label qui fait partie d'une jointure.

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

view_label peut également être utilisé dans une dimension, une mesure ou un filtre, comme décrit sur la page de documentation du paramètre view_label (pour les champs).

Utilisation

explore: view_name {
  join: view_name_2 {
    view_label: "desired label"
  }
}

Hiérarchie Fichier de modèle explore join view_label

Valeur par défaut Nom de la jointure Acceptation Chaîne

Définition

view_label modifie le libellé d'un groupe de champs issus d'une vue jointe dans le sélecteur de champs. Vous pouvez utiliser view_label pour regrouper les champs d'une vue sous le nom d'une autre vue.

Vous pouvez utiliser view_label si vous avez besoin de plusieurs vues pour la modélisation, mais que ces vues représentent la même entité aux yeux des utilisateurs métier. Par exemple, imaginons une exploration appelée order_items avec deux vues jointes : order_facts et orders. Vous pouvez souhaiter que ces vues conservent des noms distincts à des fins de modélisation. Toutefois, il peut être plus simple pour vos utilisateurs que les deux apparaissent sous la forme Commandes dans l'UI.

Si vous n'ajoutez pas explicitement de view_label à une join, la valeur par défaut du paramètre view_label est le nom de la jointure.

Pour modifier les noms des champs eux-mêmes, vous pouvez utiliser le paramètre label.

Exemples

Faites en sorte que la vue customer_facts semble faire partie de la vue Customer dans le sélecteur de champs :

explore: customer {
  join: customer_facts {
    view_label: "Customer"
    sql_on: ${customer.id} = ${customer_facts.customer_id} ;;
  }
}

Faites en sorte que la vue product_facts semble faire partie de la vue Informations sur le produit dans le sélecteur de champs :

explore: product_info {
  join: product_facts {
    view_label: "Product Info"
    sql_on: ${product_info.product_id} = ${product_facts.product_id} ;;
  }
}

Difficultés courantes

view_label n'a aucun effet autre que la modification de l'apparence du sélecteur de champs

Lorsque vous modifiez le view_label d'un join, seul le sélecteur de champ est affecté. La manière dont les champs doivent être référencés dans le code LookML reste inchangée.

Utilisez les majuscules à bon escient lorsque vous combinez plusieurs vues via view_label.

Si vous souhaitez qu'une vue associée soit fusionnée avec une autre vue dans le sélecteur de champ, assurez-vous que la casse utilisée dans view_label est correcte. La casse doit correspondre à celle du nom de la vue dans le sélecteur de champs. Exemple :

explore: product_info {
  join: product_facts {
    view_label: "Product Info"
    sql_on: ${product_info.product_id} = ${product_facts.product_id} ;;
  }
}

product_info s'affichera dans le sélecteur de champ sous le nom Product Info. Chaque mot commence par une majuscule, et les traits de soulignement sont remplacés par des espaces. C'est pourquoi nous avons utilisé view_label: 'Product Info' au lieu de view_label: 'product_info'.

Bon à savoir

Il existe plusieurs façons de renommer une vue associée.

LookML propose plusieurs façons de renommer une vue jointe, qui ont toutes des effets différents sur la façon dont vous écrivez le code LookML. view_label ne convient pas à tous les cas d'utilisation.

Situation	Code LookML approprié
Nommer une vue différemment de sa table sous-jacente, à la fois dans le sélecteur de champs et lors de l'écriture de LookML	sql_table_name pour les vues
Nommer une vue jointe différemment de sa vue sous-jacente, uniquement dans le sélecteur de champs	view_label pour les jointures
Joignez la même vue à une exploration plusieurs fois et appliquez un nom unique à chaque cas, à la fois dans le sélecteur de champs et lorsque vous écrivez du code LookML.	from pour les jointures
Si la même vue peut décrire plusieurs tables différentes, choisissez celle à utiliser.	sql_table_name pour les jointures

view_label affecte les vues jointes de l'exploration

Ce paramètre est similaire à view_label (pour les explorations), mais s'applique aux vues jointes de l'exploration, et non à la vue de base. Contrairement à label (pour les vues), ce paramètre n'affecte la vue que lorsqu'elle est affichée dans cette exploration.