本页介绍的是属于维度、过滤条件字段或参数的
suggestions参数。您还可以将
suggestions用作 视图 的一部分,如suggestions(适用于视图) 参数文档页面中所述。
用法
view: view_name {
dimension: field_name {
suggestions: ["suggestion string", "suggestion string", "…"]
}
}
|
层次结构
suggestions |
可能的字段类型
维度、过滤条件、参数
接受
字符串或字符串列表
|
定义
当用户根据支持建议的字段类型过滤探索时,默认情况下,Looker 会建议该字段的可能值(如需了解如何影响过滤条件建议,请参阅更改过滤条件建议)。为了提供过滤条件字段的建议,Looker 会对您的数据库执行查询,以检索该字段的不同值列表。Looker 通常通过对过滤条件字段执行如下查询来生成这些建议:
SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000
借助 suggestion 参数,您可以对
维度、过滤条件字段或参数的建议值列表进行硬编码,以便在有人使用该字段过滤查询时显示该列表。
如果该字段位于大型表中,此查询可能会太慢或产生过大的数据库负载。通过使用 suggestions,您可以对可能值的列表进行硬编码,从而提高性能。
suggestions 参数也很有用,因为如果您不希望字段中的某些值显示为建议,则可以使用该参数指定更有限的列表。
labelcase示例
将 colors 维度的默认建议替换为硬编码列表:
dimension: colors {
type: string
sql: ${TABLE}.colors ;;
suggestions: ["red", "yellow", "blue"]
}