Modifier les suggestions de filtre

Cette page présente les paramètres LookML qui affectent les suggestions de filtrage. Elle présente chaque paramètre, accompagné d'un lien vers sa page de référence complète et d'une courte description de sa fonction.

Comportement par défaut

Par défaut, dans une présentation ou une exploration, lorsqu'un utilisateur saisit une valeur de filtre pour un champ qui accepte les suggestions, Looker suggère des options qui correspondent à ce qu'il saisit. Dans un tableau de bord, si le filtre du tableau de bord filtre un champ qui accepte les suggestions, Looker suggère également des options de filtre. Ces suggestions de filtre sont créées à l'aide d'une requête SELECT DISTINCT sur le champ. Elles ne renvoient donc que les valeurs qui correspondent aux données existantes pour ce champ :

Les suggestions de filtres s'affichent dans un menu déroulant qui s'ouvre lorsqu'un utilisateur sélectionne le champ de valeur du filtre.

Si vous rencontrez un comportement inattendu et que vous devez résoudre des problèmes liés aux suggestions de filtre, consultez la page Bonnes pratiques pour résoudre les problèmes courants liés aux suggestions de filtre.

Types de champs qui acceptent les suggestions

Looker accepte les suggestions pour les valeurs type suivantes pour les champs dimension, dimension_group, filter etparameter.

Valeurs type de dimension qui acceptent les suggestions :

Valeur type de groupe de dimensions qui accepte les suggestions :

Valeur type de filtre qui accepte les suggestions :

  • type: string

Valeurs type de paramètre qui acceptent les suggestions :

Activation et désactivation des suggestions de filtre

Cette section décrit les paramètres LookML suivants qui vous permettent d'activer ou de désactiver les suggestions de filtre :

suggestions (vue)

Par défaut, lorsqu'un utilisateur filtre une exploration sur un champ qui accepte les suggestions, Looker suggère des valeurs possibles pour le champ.

Vous pouvez définir une vue avec suggestions:no pour désactiver les suggestions pour tous les champs de la vue.

suggestable (champ)

Par défaut, lorsqu'un utilisateur filtre une exploration sur un champ qui accepte les suggestions, Looker suggère des valeurs possibles pour le champ.

Vous pouvez définir un champ individuel avec suggestable:no pour désactiver les suggestions pour le champ.

Valeurs des suggestions de filtre

Cette section décrit les paramètres LookML suivants qui vous permettent de définir ou de limiter les valeurs affichées dans les suggestions de filtre :

allowed_value (champ)

allowed_value fonctionne avec le paramètre LookML parameter. Si un développeur Looker fournit un parameter champ réservé au filtrage, les valeurs saisies ou sélectionnées par les utilisateurs peuvent être référencées à l'aide d'une variable Liquid {% parameter %}. Vous pouvez également utiliser allowed_value pour définir une liste de valeurs qu'un utilisateur peut choisir pour ce champ de paramètre.

allowed_value comporte deux sous-paramètres : label et value. Le sous-paramètre label spécifie les options que l'utilisateur verra dans les suggestions de filtre. Le sous-paramètre value contient les valeurs transmises à la variable Liquid {% parameter %}.

Par exemple, un paramètre peut être défini comme suit :

parameter: order_amount {
  type: string
  allowed_value: {
    label: "Less than $50"
    value:"< 50"
  }
  allowed_value: {
    label: "Between $50 and $100"
    value:"<= 100"
  }
  allowed_value: {
    label: "Over $100"
    value:"> 100"
  }
}

Ensuite, lorsqu'un utilisateur filtre le paramètre, il peut choisir parmi les options Moins de 50 $, Entre 50 $ et 100 $ et Plus de 100 $.

Pour en savoir plus, consultez cette section de la page de référence parameter.

bypass_suggest_restrictions (champ)

bypass_suggest_restrictions active les suggestions de filtre dans les situations où elles seraient sinon désactivées ou limitées. Si vous avez utilisé sql_always_where ou access_filter pour limiter les lignes que les utilisateurs peuvent voir, Looker limite également les suggestions de filtre aux valeurs des lignes autorisées. Toutefois, si vous êtes certain qu'aucune valeur possible dans un champ particulier ne révèle d'informations sensibles, vous pouvez utiliser bypass_suggest_restrictions pour rétablir l'ensemble complet des suggestions de filtre.

case (champ)

case vous permet de regrouper les résultats d'une dimension avec une logique de cas. Cela a un impact sur les suggestions de filtre, car seules les valeurs définies dans l'instruction case sont affichées comme suggestions de filtre pour cette dimension.

Une dimension qui utilise case peut être utilisée avec des filtres associés, si la dimension est utilisée dans le filtre qui met à jour l'autre filtre. Une dimension qui utilise case ne peut pas être utilisée dans le filtre en cours de mise à jour.

full_suggestions (champ)

Vous pouvez définir un champ avec le paramètre full_suggestions pour contrôler la façon dont Looker interroge votre base de données afin de fournir des suggestions pour les valeurs du champ pour un filtre :

  • full_suggestions: no : Looker utilise une requête de base de valeurs distinctes et n'interroge que la vue contenant le champ de filtre.
  • full_suggestions: yes: Looker ajoute la logique d'exploration à sa requête de suggestion de filtre, ce qui signifie qu'il inclut toutes les jointures de l'exploration nécessaires pour interroger le champ du filtre, ainsi que la logique des paramètres de l'exploration, tels que sql_always_where, access_filter et conditionally_filter.

Pour en savoir plus sur le comportement par défaut de Looker pour fournir des suggestions et sur les considérations à prendre en compte pour les explorations avec sql_always_where ou access_filter, consultez la page full_suggestions.

suggest_dimension (champ) et suggest_explore (champ)

Looker génère généralement des suggestions de filtre en exécutant une requête SELECT DISTINCT sur le champ de filtre. Pour certaines grandes tables, cette requête peut être trop lente ou créer une charge de base de données trop importante. Vous pouvez utiliser suggest_dimension pour que Looker interroge une autre dimension pour les suggestions de filtre, en combinaison avec suggest_explore si cette dimension se trouve dans une autre exploration.

suggestions (champ)

suggestions vous permet de coder en dur une liste de valeurs de suggestion de filtre possibles. Cela peut être utile si vous ne souhaitez pas que certaines valeurs de données d'un champ apparaissent comme suggestions, et que vous préférez spécifier une liste plus limitée.

Mise en cache des suggestions de filtrage

Cette section décrit le paramètre suggest_persist_for, qui vous permet de configurer la durée de mise en cache des suggestions de filtre.

Si vous souhaitez réduire la charge sur votre base de données et que le nombre de valeurs de données pour un champ est très élevé, envisagez d'utiliser un paramètre pour désactiver les suggestions de filtre pour votre champ. Si vous souhaitez que les suggestions de filtre s'affichent, envisagez d'utiliser un paramètre pour limiter les valeurs de filtre interrogées ou pour coder en dur les options appropriées.

suggest_persist_for (champ)

Par défaut, les suggestions de filtre sont mises en cache pendant six heures, ce qui génère la même liste de suggestions pendant cette période. Le paramètre suggest_persist_for vous permet de modifier la durée de mise en cache des suggestions de filtre.