suggestions (pour les champs)

Cette page fait référence au paramètre suggestions qui fait partie d'une dimension, d'un champ de filtre ou d'un paramètre.

Vous pouvez également utiliser suggestions dans une vue, comme décrit sur la page de documentation du paramètre suggestions (pour les vues).

Utilisation

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}

Hiérarchie Afficher le fichier view Type de champ suggestions

Types de champs possibles Dimension, filtre, paramètre Acceptation Chaîne ou liste de chaînes

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 (consultez Modifier les suggestions de filtres pour savoir comment influencer 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 suggestion vous permet de coder en dur la liste des valeurs suggérées pour une dimension, un champ de filtre ou un paramètre qui s'affichera lorsqu'un utilisateur utilisera ce champ pour filtrer une requête.

Remarque : Bien que Looker mette en cache jusqu'à 1 000 résultats pour cette requête, seuls les 100 premiers résultats s'affichent pour l'utilisateur en tant que suggestions de filtres.

Si le champ se trouve dans une grande table, cette requête peut être trop lente ou créer une charge de base de données trop importante. En utilisant suggestions, vous pouvez coder en dur une liste de valeurs possibles et améliorer les performances.

Le paramètre suggestions est également utile, car il vous permet de spécifier une liste plus limitée si vous ne souhaitez pas que certaines valeurs d'un champ apparaissent comme suggestions.

Attention : Les valeurs label du paramètre case seront prioritaires sur les suggestions présentées aux utilisateurs à partir du paramètre suggestions.

Exemples

Remplacez les suggestions par défaut pour la dimension colors par une liste codée en dur :

dimension: colors {
  type: string
  sql: ${TABLE}.colors ;;
  suggestions: ["red", "yellow", "blue"]
}