Cette page présente les paramètres LookML qui affectent les suggestions de filtres. Cette page liste chaque paramètre, avec un lien vers sa page de référence complète, une brève description de sa fonction et une image de son rôle.
Comportement par défaut
Par défaut, dans un look ou une exploration, lorsqu'un utilisateur saisit une valeur de filtre pour une dimension de type: string
, Looker suggère des options correspondant à ce que l'utilisateur saisit. Sur un tableau de bord, si le filtre du tableau de bord est défini sur un champ de type: string
(et, dans le cas d'anciens tableaux de bord, s'il s'agit d'un type de filtre de champ), Looker suggère également des options de filtre. Ces suggestions de filtre sont créées à l'aide d'une requête SELECT DISTINCT, de sorte qu'elles ne renvoient que des valeurs correspondant aux données existantes pour ce champ:
Activer ou désactiver les suggestions de filtres
Cette section décrit les paramètres LookML suivants qui vous permettent d'activer ou de désactiver les suggestions de filtres:
suggestable
(champ)
Définir suggestable
sur no
vous permet de désactiver les suggestions pour une dimension ou un filtre. La valeur par défaut de suggestable
étant yes
, Looker envoie des suggestions à l'utilisateur lorsque cela est possible. Si vous définissez suggestable
sur no
à la place, Looker ne propose pas de suggestions.
suggestions
(vue)
Définir suggestions
sur no
vous permet de désactiver les suggestions pour toutes les dimensions d'une vue. La valeur par défaut de suggestions
étant yes
, Looker envoie des suggestions à l'utilisateur lorsque cela est possible. Si vous définissez suggestions
sur no
à la place, Looker ne propose pas de suggestions.
Filtrer les valeurs de suggestion
Cette section décrit les paramètres LookML suivants, qui vous permettent de définir ou de restreindre les valeurs affichées dans les suggestions de filtres:
allowed_value
(Champ)bypass_suggest_restrictions
(champ)case
(champ)full_suggestions
(champ)suggest_dimension
(champ) etsuggest_explore
(champ)suggestions
(champ)
allowed_value
(champ)
allowed_value
fonctionne avec le paramètre LookML parameter
. Si un développeur Looker fournit un champ de filtrage parameter
uniquement, les valeurs saisies ou sélectionnées par les utilisateurs peuvent être référencées à l'aide d'une variable liquide {% verbatim %}{% parameter %}. Vous pouvez éventuellement 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 filtres. Le sous-paramètre value
contient les valeurs transmises à la variable Liquid {% parameter %}
.
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 cas où elles seraient désactivées ou limitées. Si vous avez utilisé sql_always_where
ou access_filter
pour limiter les lignes visibles, Looker limite également les suggestions de filtre aux valeurs des lignes autorisées. Toutefois, si vous êtes certain qu'une valeur spécifique dans un champ de dimension ou de filtre n'est pas susceptible de révéler des informations sensibles, vous pouvez utiliser bypass_suggest_restrictions
pour rétablir la liste complète des suggestions de filtres.
case
(champ)
case
vous permet de regrouper les résultats d'une dimension avec une logique de casse. Cela a un impact sur les suggestions de filtres, car seules les valeurs définies dans l'instruction case
sont affichées en tant que suggestions de filtres pour cette dimension.
Les suggestions présentées à un utilisateur pour une dimension utilisant
case
ne seront pas limitées lors de l'utilisation defull_suggestions
. Toutes les options que vous incluez dans un paramètrecase
sont visibles par tous les utilisateurs.
Une dimension qui utilise case
peut être utilisée avec des filtres associés (également appelés filtres à attribut pour les anciens tableaux de bord), si elle 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)
Lorsque le paramètre full_suggestions
est défini sur no
, il désactive les suggestions de filtre pour une dimension.
Les suggestions présentées à un utilisateur pour une dimension utilisant
case
ne seront pas limitées lors de l'utilisation defull_suggestions
. Toutes les options que vous incluez dans un paramètrecase
sont visibles par tous les utilisateurs.
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 tables volumineuses, 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 transformer une requête Looker en une autre dimension pour les suggestions de filtres, 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 s'affichent en tant que suggestions, mais que vous souhaitez 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 filtres.
Si vous souhaitez réduire la charge sur votre base de données et que le nombre de valeurs de données pour une dimension est très élevé, envisagez d'utiliser un paramètre pour désactiver les suggestions de filtre pour votre dimension. Si vous souhaitez afficher des suggestions de filtres, vous pouvez utiliser un paramètre pour limiter les valeurs de filtre interrogées ou coder en dur les options appropriées.
suggest_persist_for
(champ)
Par défaut, les suggestions de filtres sont mises en cache pendant six heures, ce qui génère la même liste de suggestions pour cette durée. Le paramètre suggest_persist_for
vous permet de modifier la durée de mise en cache des suggestions de filtres.