full_suggestions

Utilisation

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
Hiérarchie
view
Type de champ
full_suggestions
Types de champs possibles
Dimension, groupe de dimensions, filtre, paramètre

Acceptation
Booléen (oui ou non)

Définition

Lorsqu'un utilisateur filtre une exploration sur un type de champ qui accepte les suggestions, Looker suggère par défaut des valeurs possibles pour le champ (consultez la page de documentation Modifier les suggestions de filtres pour savoir comment modifier les suggestions de filtres). Pour fournir des suggestions pour un champ de filtre, Looker exécute une requête dans votre base de données afin de récupérer une liste de valeurs distinctes pour le champ. Looker génère généralement ces suggestions en exécutant une requête semblable à la suivante sur le champ de filtre :

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

Le paramètre full_suggestions contrôle la manière dont Looker interroge votre base de données pour fournir des suggestions pour les valeurs du champ dans le filtre d'une exploration :

  • full_suggestions: no : Looker utilise sa requête de suggestion de filtre habituelle 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, y compris les paramètres suivants :

Comportement par défaut

Si le paramètre full_suggestions n'est pas spécifié pour un champ, Looker interroge les valeurs de suggestion avec le comportement suivant :

  • Pour les explorations qui utilisent sql_always_where ou access_filter, ou always_join, Looker utilise par défaut le comportement full_suggestions: yes. Étant donné que les paramètres access_filter, sql_always_where et always_join appliquent des contraintes aux requêtes d'exploration, ces mêmes contraintes sont appliquées aux requêtes de suggestion de filtre. Pour en savoir plus sur la façon dont Looker fournit des suggestions pour les explorations avec des contraintes de requête, consultez la section Considérations pour les explorations avec sql_always_where ou access_filter.
  • Sinon, Looker utilise par défaut le comportement full_suggestions: no, en interrogeant uniquement la vue du champ de filtre et sans inclure la logique de l'exploration. Le paramètre full_suggestions: no améliore les performances des suggestions de filtres, car Looker interroge une seule table sans jointure, sans utiliser la logique définie dans l'exploration.

Exemple

Pour inviter Looker à utiliser la logique de l'exploration afin d'interroger votre base de données lorsque vous fournissez des suggestions de filtres pour une dimension, ajoutez full_suggestions: yes à la définition de la dimension :

dimension: project_name {
  type: string
  sql: ${TABLE}.project_name ;;
  full_suggestions: yes
}

Considérations pour les explorations avec sql_always_where ou access_filter

Les paramètres sql_always_where et access_filter sont souvent utilisés pour contrôler l'accès aux données. Chaque fois que sql_always_where ou access_filter sont utilisés dans une exploration, Looker applique ces restrictions aux suggestions de filtres qu'il effectue pour les types de champs qui acceptent les suggestions. Pour empêcher les utilisateurs de voir une suggestion de filtre qui ne s'applique pas à eux, Looker exige que la logique d'exploration (full_suggestions:yes) soit appliquée aux suggestions de valeurs de filtre dans l'exploration. Par conséquent, si une exploration est définie avec sql_always_where ou access_filter, Looker ne fournit aucune suggestion pour un filtre sur un champ défini avec full_suggestions:no.

Si vous disposez d'une exploration avec sql_always_where ou access_filter, et que vous savez qu'un champ ne nécessite pas la logique sql_always_where ou access_filter, vous pouvez remplacer le comportement en ajoutant bypass_suggest_restrictions:yes à la définition du champ. L'instruction bypass_suggest_restrictions:yes invite Looker à fournir la liste complète des suggestions de valeurs de filtre.