Notez que vous consultez la documentation Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Création des filtres requis avec LookML

Vous pouvez vous aider à organiser l'expérience de filtrage pour vos utilisateurs en spécifiant le comportement des filtres directement dans votre code LookML. Par exemple, vous pouvez ajouter des filtres utiles que la plupart des utilisateurs sont susceptibles d'utiliser dans une exploration, ou ajouter un filtre par défaut pour réduire le risque que les requêtes sollicitent les ressources de votre base de données.

Cette page présente chaque paramètre LookML qui affecte le filtrage pour tous les utilisateurs.

Créer des filtres modifiables par les utilisateurs

Ce tableau liste les paramètres LookML qui définissent des filtres visibles au niveau de l'exploration pour tous les utilisateurs. Les utilisateurs peuvent voir les filtres et modifier leurs valeurs lorsqu'ils explorent et consultent des Looks, mais ils ne peuvent pas les supprimer. Ces filtres s'appliquent également aux tableaux de bord, bien que les utilisateurs ne puissent pas voir ni modifier les valeurs des filtres à partir du tableau de bord, sauf si vous créez également un filtre de tableau de bord.

paramètre LookML	Définition du champ d'application	Visible par les utilisateurs ?	Modifiable par les utilisateurs ?	Description
`always_filter`	Explorer	Oui	Oui	Utilisez le paramètre LookML `always_filter` pour définir un filtre au niveau de l'exploration pour tous les utilisateurs. Les utilisateurs peuvent voir le filtre et modifier sa valeur par défaut, mais ils ne peuvent pas le supprimer de l'exploration.
`conditionally_filter`	Explorer	Oui	Oui	Utilisez le paramètre LookML `conditionally_filter` pour définir un filtre au niveau de l'exploration pour tous les utilisateurs. Comme dans `always_filter`, les utilisateurs peuvent voir le filtre et modifier sa valeur par défaut. Toutefois, contrairement à `always_filter`, les utilisateurs peuvent supprimer un filtre spécifié avec `conditionally_filter` si un champ spécifique est filtré à la place.

Créer des filtres que les utilisateurs ne peuvent pas modifier

Ce tableau liste les paramètres LookML qui définissent des filtres masqués au niveau de l'exploration pour tous les utilisateurs. Les utilisateurs ne peuvent pas modifier les conditions de filtre, et le filtrage est appliqué dans le SQL de chaque requête. Ces filtres s'appliquent également aux Looks et aux tableaux de bord.

paramètre LookML	Définition du champ d'application	Visible par les utilisateurs ?	Modifiable par les utilisateurs ?	Description
`sql_always_where`	Explorer	Parfois	Non	Utilisez le paramètre LookML `sql_always_where` pour définir une restriction de requête au niveau de l'exploration dans la clause `WHERE` de toutes les requêtes SQL générées à partir de l'exploration. Les utilisateurs ne pourront pas modifier la condition de filtre. Ils ne pourront voir la condition de filtre que s'ils sont autorisés à afficher la requête SQL générée.
`sql_always_having`	Explorer	Parfois	Non	Utilisez le paramètre LookML `sql_always_having` pour définir une restriction de requête au niveau de l'exploration dans la clause `HAVING` de toutes les requêtes SQL générées à partir de l'exploration. Comme avec `sql_always_where`, les utilisateurs ne pourront pas modifier la condition de filtre. Ils ne pourront voir la condition de filtre que s'ils sont autorisés à afficher la requête SQL générée.
`sql_where`	Participer	Parfois	Non	Utilisez le paramètre LookML `sql_where` pour définir une restriction de requête au niveau de l'exploration dans la clause `WHERE` de toutes les requêtes SQL générées à partir de l'exploration lorsque la jointure spécifiée est incluse dans la requête. Comme avec `sql_always_where`, les utilisateurs ne pourront pas modifier la condition de filtre. Ils ne pourront voir la condition de filtre que s'ils sont autorisés à afficher la requête SQL générée.
`access_filter`	Explorer	Parfois	Non	Utilisez le paramètre LookML `access_filter` pour définir une restriction de requête spécifique à l'utilisateur au niveau de l'exploration dans la clause `WHERE` de toutes les requêtes SQL générées à partir de l'exploration. Comme avec `sql_always_where`, les utilisateurs ne pourront pas modifier la condition de filtre. Ils ne pourront voir la condition de filtre que s'ils sont autorisés à afficher la requête SQL générée. Toutefois, contrairement à `sql_always_where`, la condition du filtre est déterminée par les valeurs des attributs utilisateur de chaque utilisateur.

Empêcher les utilisateurs de filtrer un champ

Ce tableau liste les paramètres LookML qui empêchent le filtrage des champs individuels.

paramètre LookML	Définition du champ d'application	Visible par les utilisateurs ?	Modifiable par les utilisateurs ?	Description
`can_filter`	Champ	Oui	Non	Utilisez le paramètre LookML `can_filter` pour indiquer si un champ peut être filtré. Pour empêcher le filtrage sur un champ, ajoutez-y la ligne `can_filter: no`. Cela permet également d'éviter que le champ ne soit filtré dans les menus d'analyse.
`skip_drill_filter`	Champ	Oui	Non	Utilisez le paramètre LookML `skip_drill_filter` pour spécifier si un champ peut être filtré dans les menus d'analyse. Pour empêcher le filtrage sur un champ dans les menus d'analyse, ajoutez la ligne `skip_drill_filter: yes` à ce champ. Toutefois, vous pourrez toujours filtrer le champ dans d'autres emplacements.