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 compatible avec les suggestions, Looker suggère par défaut des valeurs possibles pour le champ (pour savoir comment modifier les suggestions de filtres, consultez la page de documentation Modifier les suggestions de filtres). Pour fournir des suggestions pour un champ de filtre, Looker exécute une requête sur 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 telle que celle ci-dessous 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 façon dont Looker interroge votre base de données pour fournir des suggestions de valeurs de champ dans le filtre d'une exploration :

  • full_suggestions: no : Looker utilisera sa requête de suggestion de filtre typique et n'interrogera que la vue contenant le champ de filtre.

  • full_suggestions: yes : Looker ajoute la logique de l'exploration à sa requête de suggestion de filtre. Cela signifie que Looker 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, 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 Explorer, ces mêmes contraintes sont appliquées aux requêtes de suggestions de filtres. Pour en savoir plus sur la façon dont Looker fournit des suggestions pour les explorations avec des contraintes de requête, consultez Points à prendre en compte 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 jointures, sans utiliser la logique définie dans l'exploration.

Exemple

Pour inciter Looker à utiliser la logique de l'exploration pour interroger votre base de données lorsqu'il fournit 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
}

Remarques concernant 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 propose pour les types de champs compatibles avec les suggestions. Pour éviter que les utilisateurs voient une suggestion de filtre qui ne s'applique pas à eux, Looker exige que la logique Explore (full_suggestions:yes) soit appliquée aux suggestions de valeurs de filtre dans Explore. Par conséquent, si une exploration est définie avec sql_always_where ou access_filter, Looker ne fournira aucune suggestion pour un filtre sur un champ défini avec full_suggestions:no.

Si vous avez une exploration avec sql_always_where ou access_filter, et que vous avez un champ qui, selon vous, 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.