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 qui accepte les suggestions, Looker suggère par défaut des valeurs possibles pour le champ (pour savoir comment modifier les suggestions de filtre, consultez Modifier les suggestions de filtre). 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 suggestions 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'affiche lorsqu'un utilisateur utilise 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 filtre.

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 du paramètre sont prioritaires par rapport aux suggestions présentées aux utilisateurs à partir du paramètre.

labelcasesuggestions

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"]
}