Cette page présente les paramètres LookML qui affectent les suggestions de filtres. Cette page répertorie chaque paramètre avec un lien vers sa page de référence complète et une brève 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 compatible avec les suggestions, Looker suggère des options correspondant à ce que l'utilisateur saisit. Sur un tableau de bord, si le filtre du tableau de bord filtre sur un champ qui prend en charge les suggestions, Looker suggère également des options de filtrage. Ces suggestions de filtres sont créées à l'aide d'une requête SELECT DISTINCT sur le champ. Par conséquent, elles ne renvoient que les valeurs correspondant aux données existantes pour ce champ:
Si vous constatez un comportement inattendu et que vous devez résoudre des problèmes liés aux suggestions de filtres, consultez la page Résoudre les problèmes courants liés aux suggestions de filtres sur la page "Bonnes pratiques".
Types de champs compatibles avec les suggestions
Looker propose des suggestions pour les valeurs type
suivantes pour les champs dimension
, dimension_group
, filter
et parameter
.
Valeurs type
de la dimension acceptant les suggestions :
Valeur type
du groupe de dimensions acceptant les suggestions:
type: time
, avec les valeurstimeframes
suivantes:
Valeur type
de filtrage compatible avec les suggestions :
type: string
Valeurs du paramètre type
compatibles avec les suggestions :
type: string
type: unquoted
Activer ou désactiver les suggestions de filtre
Cette section décrit les paramètres LookML suivants, qui vous permettent d'activer ou de désactiver les suggestions de filtres:
suggestions
(vue)
Par défaut, lorsqu'un utilisateur filtre une exploration sur un champ compatible avec les suggestions, Looker suggère des valeurs possibles pour ce champ.
Vous pouvez définir une vue à l'aide de suggestions:no
afin de 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 compatible avec les suggestions, Looker suggère des valeurs possibles pour ce champ.
Vous pouvez définir un champ individuel avec suggestable:no
pour désactiver les suggestions pour ce 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 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 {% paramètre %} variable Liquid. 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 %}
.
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 sur ce 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 sur parameter
.
bypass_suggest_restrictions
(champ)
bypass_suggest_restrictions
active les suggestions de filtres dans les situations où elles étaient 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 filtrage aux valeurs des lignes autorisées. Toutefois, si vous êtes certain qu'aucune valeur possible dans un champ particulier ne révélerait des informations sensibles, vous pouvez utiliser bypass_suggest_restrictions
pour rétablir l'ensemble complet des suggestions de filtrage.
case
(champ)
case
vous permet de regrouper les résultats d'une dimension à l'aide d'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 en tant que 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 modification.
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 de valeurs de champ pour un filtre:
full_suggestions: no
: Looker utilise une requête de base composée 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. Cela signifie que Looker inclura toutes les jointures de l'exploration requises pour interroger le champ du filtre, ainsi que la logique des paramètres de l'exploration, tels quesql_always_where
,access_filter
etconditionally_filter
.
Consultez la page full_suggestions
pour en savoir plus sur le comportement par défaut de Looker lors de la fourniture de suggestions et pour les éléments à prendre en compte pour les explorations avec sql_always_where
ou access_filter
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 demander à Looker d'interroger 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 suggestions de filtres possibles. Cela peut être utile si vous ne souhaitez pas que certaines valeurs de données d'un champ apparaissent en tant que suggestions, mais 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 pendant laquelle les suggestions de filtres sont mises en cache.
Si vous souhaitez réduire la charge sur votre base de données et que le nombre de valeurs de données d'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 des suggestions de filtres s'affichent, envisagez d'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 filtre sont mises en cache pendant six heures. Vous obtenez ainsi 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.