Créer des expressions Looker

Remarque : Cette page fait partie de la série de tutoriels Récupérer et représenter des données sous forme de graphique.

Remarque : Si votre administrateur vous a accordé les autorisations nécessaires pour créer des calculs de tableaux, vous pouvez utiliser les fonctionnalités suivantes pour effectuer rapidement des fonctions courantes sans créer d'expressions Looker :

• Les calculs rapides permettent d'effectuer rapidement des calculs courants sur les champs numériques de la table de données d'une exploration.

Si votre administrateur vous a accordé les autorisations pour créer des champs personnalisés, vous pouvez utiliser les fonctionnalités suivantes pour effectuer rapidement des fonctions courantes sans avoir à créer d'expressions Looker :

• Groupes personnalisés pour regrouper rapidement des valeurs sous des libellés personnalisés, sans avoir à développer une logique CASE WHEN dans les paramètres sql ni les champs type: case

Bins personnalisés pour regrouper les dimensions de type numérique dans des niveaux personnalisés sans avoir à développer des champs LookML type: tier

Expressions Looker

Les expressions Looker (parfois appelées Lexp) servent à effectuer des calculs dans les contextes suivants :

• Calculs de tables
• Champs personnalisés
• Filtres personnalisés
• Tests de données

Une expression Looker est créée à partir d'une combinaison des éléments suivants :

• NULL: : la valeur NULL indique qu'il n'y a pas de données. Elle peut être utile lorsque vous souhaitez vérifier qu'un élément est vide ou n'existe pas.

• Une constante : il s'agit d'une valeur immuable que vous fournissez. Un nombre tel que 7 ou une chaîne telle que Completed sont des constantes.

• Champ Looker : référence à un champ Looker, qui inclut des dimensions, des mesures et des calculs de table.

• Un opérateur Looker : il existe plusieurs types d'opérateurs (listés sur la page de documentation Fonctions et opérateurs Looker) :

  • Opérateurs mathématiques (tels que +, -, * et /)
  • Opérateurs de comparaison (tels que =, > et <=)
  • Opérateurs logiques (tels que AND, OR et NOT)

• Fonction Looker : elles sont semblables aux fonctions Excel. Les fonctions vous permettent de transformer vos données ou de faire référence à des données de manière complexe. Toutes les fonctions disponibles sont listées sur la page de documentation Fonctions et opérateurs Looker.

Créer des expressions Looker

Les calculs de table, les champs personnalisés et les filtres personnalisés utilisent l'éditeur d'expressions Looker. Lorsque vous saisissez votre expression, Looker vous propose des fonctions, des opérateurs et des noms de champs que vous pouvez utiliser.

Conseil : Si vous êtes un développeur Looker et que vous créez un test de données pour vérifier la logique de votre modèle, vous pouvez utiliser l'éditeur d'expressions Looker pour créer une expression Looker, puis la copier dans le paramètre expression de votre test de données.

Afficher toutes les suggestions

Accédez à l'éditeur d'expressions Looker dans une exploration en créant un calcul de table, un champ personnalisé ou un filtre personnalisé.

Saisissez un espace pour afficher la liste de tous les champs, fonctions et opérateurs que vous pouvez choisir. Si un champ est actuellement sélectionné dans l'exploration, Looker affiche un point noir à gauche du champ et le place en haut de la liste.

Commencez à saisir du texte dans l'éditeur d'expressions Looker pour réduire la liste aux éléments qui vous intéressent.

L'éditeur de champs personnalisés affiche les champs Explorer actuellement utilisés, s'ils sont compatibles avec la fonction du champ personnalisé.

Ajouter un champ

Pour inclure un champ Looker dans votre expression, commencez à saisir son nom. À mesure que vous saisissez du texte, l'éditeur réduit votre recherche à une liste de champs et de fonctions contenant ce que vous avez saisi. Vous pouvez saisir le nom du champ tel qu'il apparaît sur la page "Explorer", ou utiliser son nom LookML si vous le connaissez.

Lorsque vous sélectionnez un champ dans la liste, Looker l'ajoute à votre expression en utilisant le nom LookML au format ${view_name.field_name}. Cela garantit que tous vos champs ont des noms uniques dans votre expression.

Remarque : Vous trouverez des instructions plus détaillées sur l'utilisation des champs dans la section Utiliser les champs de cette page.

Ajouter des totaux

Si vous créez une expression basée sur une exploration dans laquelle vous avez affiché des totaux, vous pouvez également inclure des totaux de colonnes et de lignes dans votre expression. Les totaux des colonnes s'affichent dans l'éditeur avec le mot Total devant l'itération LookML du nom du champ. Par exemple, pour un champ nommé Nombre, Looker attribuera à la colonne du total de ce champ le nom Count - Total.

Le nom LookML des totaux se présente sous la forme ${view_name.field_name:total}, où :total est ajouté à la fin du nom du champ.

Pour les totaux des lignes, les mots Totaux des lignes apparaissent devant le nom du champ dans l'éditeur. Dans le nom LookML du champ, :row_total est ajouté à la fin du nom du champ, comme ${view_name.field_name:row_total}.

Ajouter des opérateurs

Si nécessaire, vous pouvez ajouter des opérateurs logiques tels que AND, OR et NOT à votre expression. En règle générale, les opérateurs AND sont évalués avant les opérateurs OR, mais vous pouvez ignorer ce comportement en utilisant des parenthèses. Vous pouvez également utiliser des opérateurs de comparaison (tels que >, = et <=) et des opérateurs mathématiques (tels que + et *).

Lorsque vous pointez sur un opérateur, des notes sur son utilisation s'affichent dans le panneau d'informations.

Remarque : Pour obtenir des instructions plus détaillées sur l'utilisation des opérateurs, consultez la section Utiliser des opérateurs sur cette page.

Ajouter des fonctions

Pour inclure une fonction Looker dans votre expression, commencez à saisir son nom. À mesure que vous saisissez du texte, l'éditeur réduit votre recherche à une liste de champs et de fonctions contenant ce que vous avez saisi.

Les fonctions peuvent être constituées d'arguments (ou de variables) qui nécessitent un certain type, comme un champ, un nombre ou un type oui/non. Lorsque vous pointez sur une fonction, vous pouvez consulter les notes qui s'affichent à côté de votre expression dans le volet d'informations pour comprendre les arguments que vous devez fournir et leur type.

Vous trouverez la liste complète des fonctions proposées par Looker sur la page de documentation Fonctions et opérateurs Looker.

Remarque : Vous trouverez des instructions plus détaillées sur l'utilisation des fonctions dans la section Utiliser des fonctions de cette page.

Utiliser les indications d'erreur et le volet d'informations

Looker affiche un volet d'informations à côté de l'éditeur d'expressions Looker. Ce volet fournit de la documentation et des suggestions, en particulier si votre expression contient une erreur.

Le volet d'informations situé à côté de l'éditeur d'expressions fournit les informations suivantes :

• Mise en évidence des erreurs : Looker souligne en rouge les parties de l'expression qui ne sont pas encore correctes.

• Suggestions et détails de l'erreur : Looker vous suggère ce que vous pouvez ajouter ensuite dans votre expression. En cas d'erreur, il explique pourquoi elle se produit. S'il y a plusieurs erreurs, celle qui s'affiche dépend de l'emplacement de votre curseur.

• Documentation : Looker affiche la documentation sur la fonction ou l'opérateur que vous utilisez, en fonction de la position de votre curseur. Par exemple, lorsque vous saisissez le premier argument d'une fonction if(), Looker vous indique que le premier argument doit être évalué comme "true" (vrai) ou "false" (faux). Vous pouvez cliquer sur le nom d'une fonction pour accéder à sa documentation.

Inclure les commentaires

Vous pouvez inclure des commentaires dans les expressions Looker en commençant la ligne de commentaire par # dans l'éditeur d'expressions.

Utiliser des champs

Vous aurez parfois besoin d'utiliser la valeur d'un champ (dimension, mesure ou calcul de tableau) dans une expression. Vous pouvez ajouter la valeur du champ à une autre valeur, vérifier qu'elle a une certaine valeur, l'inclure dans une fonction, etc.

Comme indiqué plus haut sur cette page, vous pouvez saisir le nom du champ dans l'éditeur d'expressions. Looker vous aidera à trouver la bonne façon de faire référence au champ. Lorsque vous ajoutez un champ à une expression, Looker utilise l'identifiant LookML du champ, qui ressemble à ${view_name.field_name}. Saisissez le nom du champ tel qu'il apparaît dans le sélecteur de champs. L'éditeur d'expressions affichera alors le nom du sélecteur de champs et l'identifiant LookML.

Il existe plusieurs façons de récupérer une valeur :

• Obtenir une valeur à partir de la même ligne : la façon la plus simple d'utiliser un champ est de le référencer directement. Par exemple, votre expression peut utiliser ${product.category}. En procédant ainsi, vous indiquez "pour chaque ligne, récupérez la catégorie de produit de cette ligne".

• Obtenir une valeur à partir d'une autre ligne : vous pouvez également obtenir la valeur d'un champ à partir d'une autre ligne. Par exemple, vous pouvez souhaiter appliquer la logique "pour chaque ligne, récupérez la catégorie de produit de la ligne précédente". Pour ce faire, vous pouvez utiliser une fonction de décalage (consultez cette liste de fonctions de positionnement). La fonction de décalage peut se présenter comme suit : offset(${product.category}, -1).

• Obtenir une valeur à partir d'une colonne pivotée : vous pouvez également obtenir des valeurs à partir de colonnes pivotées. Par exemple, vous pouvez souhaiter appliquer la logique "pour chaque ligne, récupérez le total des ventes de la première colonne croisée". Pour utiliser des colonnes croisées, vous devez utiliser des fonctions de tableau croisé dynamique (consultez cette liste de fonctions de tableau croisé dynamique). La fonction pivot peut se présenter comme suit : pivot_index(${order.total_sales}, 1).

• Obtenir un total à partir d'une ligne ou d'une colonne : si vous avez ajouté des totaux à votre exploration, vous pouvez obtenir les valeurs totales d'une colonne ou d'une ligne en ajoutant :total (pour les totaux de colonnes) ou :row_total (pour les totaux de lignes) au nom du champ, au format ${field_name:total}. Par exemple, si vous souhaitez obtenir un pourcentage du total du nombre de commandes, vous pouvez créer un calcul de tableau comme celui-ci : ${orders.count} / ${orders.count:total}.

Remarque : Lorsque vous référencez des champs dans un filtre personnalisé, vous ne pouvez utiliser que des dimensions, et non des mesures, des totaux ni des calculs de table. De plus, vous ne pouvez pas faire référence à des valeurs dans d'autres lignes ou colonnes pivotées. En effet, Looker doit pouvoir convertir votre filtre en SQL pour récupérer vos données.

Toutes les options de date et d'heure ne sont pas compatibles avec les filtres personnalisés ni les champs personnalisés. Pour en savoir plus, consultez la description du paramètre dimension group.

Lorsque vous faites référence à des champs dans un calcul de tableau, vous pouvez faire référence à n'importe quelle valeur provenant d'une dimension, d'une mesure ou d'un autre calcul de tableau.

Utiliser des opérateurs

Les expressions Looker peuvent inclure des opérateurs logiques, de comparaison et mathématiques pour créer différentes conditions :

• Opérateurs logiques (tels que AND, OR et NOT)
• Opérateurs de comparaison (tels que > et <)
• Opérateurs mathématiques (+ et -, par exemple)

Sauf indication contraire avec des parenthèses, la logique AND est considérée avant la logique OR. L'expression suivante sans parenthèses supplémentaires :

if (
  ${order_items.days_to_process}>=4 OR
  ${order_items.shipping_time}>5 AND
  ${order_facts.is_first_purchase},
"review", "okay")

est donc évaluée comme suit :

if (
  ${order_items.days_to_process}>=4 OR
  (${order_items.shipping_time}>5 AND ${order_facts.is_first_purchase}),
"review", "okay")

Dans Looker, vous devez utiliser yes et no au lieu de true et false. Ces constantes logiques ne sont pas les mêmes que les mots "yes" et "no", qui sont entre guillemets. Pour en savoir plus, consultez la description des constantes logiques.

Utiliser des fonctions

Les expressions Looker incluent souvent une ou plusieurs fonctions, qui vous aident à récupérer certaines données ou à effectuer certains calculs. Elles sont de nature similaire aux fonctions Excel.

Les fonctions se présentent sous la forme d'un nom suivi de deux parenthèses, comme ceci : my_function(). Vous devrez peut-être fournir des informations entre ces parenthèses, séparées par des virgules. Ces informations sont appelées "arguments" et se présentent comme suit : my_function(argument_1, argument_2).

Par exemple, la fonction now ne prend aucun argument et vous donne la date et l'heure actuelles. Voici comment l'utiliser : now().

La fonction round accepte un argument, qui est un nombre. Voici comment l'utiliser : round(3.2). Le résultat est 3.

Il existe deux façons de savoir quels arguments vous devrez fournir, le cas échéant :

• Le volet d'informations qui s'affiche à côté de l'éditeur d'expressions fournit de la documentation sur la fonction que vous écrivez. Vous pouvez cliquer sur le nom de la fonction pour accéder à sa documentation.
• Vous pouvez également accéder directement à la page de documentation sur les fonctions et opérateurs Looker et rechercher la fonction que vous souhaitez utiliser.

Prenons la fonction contains, dont la documentation se présente comme suit :

Fonction	Syntaxe	Objectif
contient	contains(string, search_string)	Renvoie Yes si string contient search_string, ou No si ce n'est pas le cas.

Vous pouvez voir que deux arguments sont requis. Elles portent les noms string et search_string, mais cela ne signifie pas que vous devez saisir les mots exacts "string" et "search_string" dans la fonction. Il s'agit simplement de noms d'arguments que vous remplacerez par quelque chose. En lisant l'objectif, nous voyons que string doit être un champ ou une autre valeur dans laquelle nous voulons effectuer une recherche , tandis que search_string est ce que nous voulons rechercher . Par exemple :

contains(${customer.feedback_text}, "great")

Si le mot "super" apparaît dans les commentaires des clients, cette fonction renvoie Yes. Sinon, le résultat est No.

Vous pouvez placer des fonctions à l'intérieur d'autres fonctions pour gérer une logique complexe. Tant que le résultat de la fonction interne est adapté aux arguments de la fonction externe, cela fonctionnera. Exemple :

contains(
  if(
    is_null(${customer.feedback_text}),
    ${customer.comment_text},
    ${customer.feedback_text}
  ),
"great")

La fonction is_null est imbriquée dans une fonction if, qui est elle-même imbriquée dans une fonction contains. Voici comment cela fonctionne :

1. La fonction is_null() vérifie le texte des commentaires des clients.
2. Ensuite, la fonction if() utilise ce résultat et renvoie le texte des commentaires des clients, le cas échéant, ou le texte des commentaires des clients.
3. Enfin, la fonction contains() utilise le texte renvoyé par la fonction if() et y recherche le mot "great" (génial).

Logiquement, cette expression signifie : "S'il y a des commentaires de clients, effectue une recherche dans ces commentaires. Si ce n'est pas le cas, recherchez plutôt dans les commentaires des clients. Dans les deux cas, recherchez le mot "super".

Remarque : Les filtres personnalisés et les champs personnalisés peuvent utiliser la plupart des fonctions, mais pas certaines fonctions mathématiques ni celles qui font référence à d'autres lignes ou colonnes croisées. La page de documentation sur les fonctions et opérateurs Looker vous indique les fonctions que vous pouvez utiliser.

Vous pouvez utiliser n'importe quelle fonction dans un calcul de table. Vous pouvez également utiliser n'importe quelle fonction dans le paramètre expression d'un test de données, car le paramètre expression est essentiellement un calcul de tableau qui génère une valeur booléenne (oui/non).