Expressions de filtre Looker

Les expressions de filtre sont un moyen avancé de filtrer les requêtes Looker. Vous pouvez utiliser des expressions de filtre de différentes manières :

• Dans la section "Explorer" de Looker, vous pouvez ajouter un filtre, choisir l'option Correspond à (avancé), puis saisir l'une des expressions listées sur cette page pour le type de filtre en tant que valeur de filtre.
• Dans les éléments LookML qui acceptent un paramètre filter.

Cette page liste les valeurs que vous pouvez saisir pour un filtre qui utilise l'option de condition correspondance (avancée) dans un Explore Looker. En fonction du type de filtre et de la valeur que vous saisissez, Looker peut convertir l'option Correspondances (avancé) en une condition de filtre plus appropriée.

À savoir sur les expressions de filtre

Lorsque vous utilisez des expressions de filtre Looker, tenez compte des points suivants :

• Les expressions de filtre de cette page sont également compatibles avec certains types de filtres dans Looker Studio lorsque le connecteur Looker fait référence à une exploration Looker comme source de données et que le filtre utilise une condition Correspondance (avancée). La condition Correspondances (avancé) se comporte légèrement différemment dans Looker Studio que dans une exploration Looker. Looker peut convertir la condition Correspondances (avancé) en une condition plus appropriée, en fonction de la saisie de l'utilisateur. Toutefois, Looker Studio utilise l'option Correspond à (avancé) comme condition générique lorsque la saisie de l'utilisateur ne convient pas aux autres conditions de filtre compatibles avec Looker Studio, mais Looker Studio ne convertit pas la condition.
• Dans les explorations, les filtres de base utilisent des expressions dont le sens diffère de celui des expressions de filtre documentées sur cette page.
• Lorsque vous utilisez des expressions de filtre dans LookML, placez l'expression entre guillemets (consultez la page de documentation filters pour découvrir comment les utiliser correctement). Cette condition est particulièrement importante pour les valeurs logiques telles que NULL. Lorsque vous utilisez des expressions de filtre dans la section "Explorer" de Looker, vous n'avez pas besoin de placer l'expression entre guillemets.
• Les expressions de filtre ne sont pas prises en charge avec les droits d'accès. Pour en savoir plus, consultez la page de documentation access_grant.

Expressions de filtre pour chaque type de filtre

Saisissez les exemples suivants comme valeurs de filtre dans les filtres Explorer de Looker qui utilisent l'option de condition correspond (avancé). Les expressions de filtre sont acceptées pour les types de filtres suivants :

• Chaîne
• Date et heure
• Booléen
• Number
• Emplacement

Chaîne

Inclusion de caractères spéciaux dans les filtres de chaînes

Pour inclure des caractères spéciaux dans les filtres de chaînes, prenez note des règles suivantes :

• Pour inclure ", % ou _, ajoutez le caractère d'échappement ^ avant. Par exemple : ^", ^% et ^_
• Pour inclure un - au début, échappez-le comme ceci : ^-. Cette condition n'est nécessaire que si - est le caractère de début. Elle est en revanche inutile si - se trouve à l'intérieur de la chaîne.
• Pour inclure ^, échappez-le comme ceci : ^^.
• Pour inclure une virgule dans un filtre de chaîne d'IU régulier, placez une barre oblique inversée \ devant la virgule. Exemple : Santa Cruz\, CA.
• Pour inclure une virgule avec l'option correspond à (avancé) dans un filtre, placez le caractère d'échappement ^ devant la virgule. Par exemple : Santa Cruz^, CA.
• Pour inclure une virgule dans une expression de filtre dans LookML, utilisez le caractère d'échappement ^ en préfixe. Par exemple :

  field: filtered_count {
      type: count
      filters: [city: "Santa Cruz^, CA"]
    }

Date and Time (Date et heure)

Le filtrage de date de Looker permet d'utiliser des expressions en anglais au lieu d'utiliser des fonctions de date SQL.

Structure de base des filtres de date et d'heure

Pour les exemples suivants :

• {n} est un nombre entier.

• {interval} correspond à un incrément de temps (heures, jours, semaines ou mois, par exemple).

  La formulation que vous choisissez détermine si {interval} inclut des périodes partielles ou uniquement des périodes complètes. Par exemple, l'expression 3 days inclut le jour partiel actuel et les deux jours précédents. L'expression 3 days ago for 3 days inclut les trois jours complets précédents et exclut le jour actuel, partiel. Pour en savoir plus, consultez la section Dates relatives.

• {time} peut spécifier une heure au format AAAA-MM-JJ HH:MM:SS ou AAAA/MM/JJ HH:MM:SS, ou une date au format AAAA-MM-JJ ou AAAA/MM/JJ. Lorsque vous utilisez la forme YYYY-MM-DD, veillez à inclure les deux chiffres du mois et du jour, par exemple 2016-01. La troncation d'un mois ou d'un jour en un seul chiffre est interprétée comme une soustraction, et non comme une date. Par exemple, la valeur 2016-1 est interprétée comme 2016 moins un an, ou 2015.

Voici toutes les combinaisons possibles des filtres de date :

Les filtres de date peuvent également être combinés :

• Pour obtenir une logique OR : saisissez plusieurs conditions dans le même filtre, séparées par des virgules. Par exemple, today, 7 days ago signifie "aujourd'hui ou il y a sept jours".
• Pour obtenir une logique AND : saisissez vos conditions une à une dans plusieurs filtres de date ou d'heure. Par exemple, vous pouvez insérer after 2014-01-01 dans un filtre Date de création, puis before 2 days ago dans un filtre Heure de création. Cela signifiera "après le 1er janvier 2014 et avant les deux jours précédents".

Dates absolues

Les filtres de date absolue utilisent les valeurs spécifiques de date en vue de générer des résultats de requête. Ils sont utiles lorsque vous créez des requêtes pour des plages de données spécifiques.

Dates relatives

Les filtres de date relative vous permettent de créer des requêtes avec des valeurs de date glissantes relatives à la date actuelle. Ils sont utiles lorsque vous créez des requêtes qui se mettent à jour à chaque fois que vous exécutez la requête.

Pour tous les exemples suivants, supposons que la date du jour est le vendredi 18/05/2018 à 18:30:02. Dans Looker, les semaines commencent le lundi, sauf si vous modifiez ce paramètre avec week_start_day.

Secondes

Minutes

Heures

Jours

Semaines

Mois

Trimestres

Années

Booléen

Pour filtrer des valeurs de type vrai ou faux dans Looker, vous devez savoir avec quel type de valeurs vrai ou faux vous interagissez.

Nombre

Les filtres sur les nombres prennent en charge à la fois les expressions en langage naturel (par exemple, 3 to 10) et les opérateurs relationnels (par exemple, >20). Looker prend en charge l'opérateur OR afin d'exprimer plusieurs plages de filtre (par exemple, 3 to 10 OR 30 to 100). L'opérateur AND peut être utilisé pour exprimer des plages numériques avec des opérateurs relationnels (par exemple, >=3 AND <=10) afin de préciser une plage. Les filtres sur les nombres peuvent également utiliser la notation d'intervalle algébrique pour filtrer des champs numériques.

Emplacement

Les expressions de filtre de localisation sont basées sur la latitude et la longitude, mais peuvent accepter certains langages naturels pour définir des cases et des cercles dans lesquels limiter une recherche.

Unités de mesure prises en charge

Pour filtrer dans une zone autour d'une localisation en particulier, vous pouvez utiliser les unités suivantes :

• Mètres
• Pieds
• Kilomètres
• Miles

Les unités de mesure singulières ne sont pas acceptées. Par exemple, le filtrage d'un rayon de 1 mile doit être rédigé comme suit : within 1 miles of 36.97, -122.03.

Valeurs d'attributs utilisateur

Pour utiliser la valeur d'un attribut utilisateur dans une expression de filtre, référencez l'attribut utilisateur avec la variable Liquid _user_attributes en utilisant la syntaxe requise par le dialecte de votre base de données :

{{ _user_attributes['name_of_attribute'] }}

Supposons par exemple que vous deviez appliquer un préfixe sf_ à la valeur de l'attribut utilisateur salesforce_username parce que c'est ainsi que les valeurs sont stockées dans votre base de données. Pour ajouter le préfixe à la valeur de l'attribut utilisateur, vous pouvez ajouter un filtre correspond à (avancé) au champ concerné et utiliser la variable Liquid _user_attributes dans l'expression du filtre comme suit :

sf_{{_user_attributes['salesforce_username']}}

Vous pouvez utiliser le même modèle pour insérer des attributs utilisateur dans les filtres de tableau de bord et les filtres d'éléments de tableau de bord LookML.