本页面简要介绍了会影响过滤器建议的 LookML 参数。该页面列出了每个参数,并附带指向其完整参考页面的链接、函数简要说明及其功能图片。
默认行为
默认情况下,在 Look 或 Discover 中,当用户针对 type: string
维度输入过滤条件值时,Looker 会推荐与用户输入的内容匹配的选项。在信息中心内,如果信息中心过滤条件基于 type: string
字段进行过滤(如果是旧版信息中心,如果是字段类型过滤器),Looker 还会提供过滤器选项建议。这些过滤条件建议是使用维度“SELECT DISTINCT”查询创建的,因此建议将仅返回与该字段的现有数据相匹配的值:
启用或停用过滤器建议
本部分介绍了以下允许您启用或停用滤镜建议的 LookML 参数:
suggestable
(字段)
将 suggestable
设置为 no
可停用针对维度或过滤条件的建议。suggestable
的默认值为 yes
,因此 Looker 会尽可能为用户提供建议。如果您将 suggestable
设置为 no
,Looker 不会给出建议。
suggestions
(查看)
通过将 suggestions
设置为 no
,您可以停用针对视图中所有维度的建议。suggestions
的默认值为 yes
,因此 Looker 会尽可能为用户提供建议。如果您将 suggestions
设置为 no
,Looker 不会给出建议。
过滤建议值
本部分介绍了以下 LookML 参数,可用于设置或限制过滤器建议中显示的值:
allowed_value
(字段)bypass_suggest_restrictions
(字段)case
(字段)full_suggestions
(字段)suggest_dimension
(字段)和suggest_explore
(字段)suggestions
(字段)
allowed_value
(字段)
allowed_value
使用 parameter
LookML 参数。如果 Looker 开发者提供“parameter
”过滤器专用字段,则可以使用 {% parameter %} 液体变量引用用户输入或选择的值。(可选)您可以使用 allowed_value
定义用户可以为该参数字段选择的值列表。
allowed_value
有两个子参数:label
和 value
。label
子参数用于指定用户在过滤建议中看到的选项。value
子参数包含传递给 {% parameter %}
液体变量的值。
如需了解详情,请参阅 parameter
参考页面的此部分。
bypass_suggest_restrictions
(字段)
启用bypass_suggest_restrictions
后,如果过滤器建议被停用或受到限制,则会启用过滤器建议。如果您使用 sql_always_where
或 access_filter
限制了用户可以查看的行,则 Looker 还会将过滤建议限制为允许行中的值。不过,如果您确定特定维度或过滤条件字段中没有可能会透露敏感信息的值,则可以使用 bypass_suggest_restrictions
恢复完整的过滤条件建议。
case
(字段)
借助 case
,您可以使用大小写逻辑对维度的结果进行分桶。这会影响过滤条件建议,因为只有 case
语句中定义的值会为该维度显示为过滤条件建议。
使用
case
时,针对某个维度向用户显示的建议在使用full_suggestions
时不会受到限制。所有用户均可看到您在case
参数中添加的任何选项。
使用case
一个维度的过滤器可以用关联的过滤器(旧版信息中心的分面过滤器)用于更新另一个过滤器的过滤器。无法在要更新的过滤条件中使用 case
维度。
full_suggestions
(字段)
当 full_suggestions
设置为 no
时,它会停用针对某个维度的过滤器建议。
使用
case
时,针对某个维度向用户显示的建议在使用full_suggestions
时不会受到限制。所有用户均可看到您在case
参数中添加的任何选项。
suggest_dimension
(字段)和 suggest_explore
(字段)
Looker 通常通过对过滤器字段执行 SELECT DISTINCT 查询来生成过滤器建议。对于某些大型表,此查询速度可能太慢,或者创建的数据库负载过大。如果 suggest_dimension
位于其他探索中,您可以使用 Looker 将替代查询作为维度过滤建议,也可以将其与 suggest_explore
结合使用。
suggestions
(字段)
借助 suggestions
,您可以对可能的过滤条件建议值列表进行硬编码。如果您不希望某个字段中的某些数据值显示为建议,而想指定更为有限的列表,上述做法就很有用。
缓存过滤器建议
本部分介绍了 suggest_persist_for
参数,可让您配置过滤器建议的缓存时长。
如果想要减少数据库的负载,而某一维度的数据值数量非常庞大,不妨考虑使用参数为维度停用过滤器建议。如果您希望显示过滤条件建议,不妨考虑使用参数来限制查询的过滤条件值或对相应选项进行硬编码。
suggest_persist_for
(字段)
默认情况下,过滤条件建议会被缓存 6 小时,因此,系统会针对这一时长生成相同的建议列表。您可以使用 suggest_persist_for
参数更改过滤器建议的缓存时长。