此页面指的是属于视图的
suggestions参数。
suggestions还可以用作维度或过滤字段的一部分,如suggestions(针对字段)参数文档页面中所述。
用法
view: view_name { suggestions: yes }
|
层次结构
suggestions |
默认值
yes
接受
布尔值(yes 或 no)
|
定义
当用户根据支持建议的字段过滤探索时,Looker 默认会为该字段建议可能的值(如需了解如何影响过滤条件建议,请参阅更改过滤条件建议)。
Looker 会从数据库中提供维度的可能值,并根据用户在过滤条件字段中输入的内容建议可能的值。对于大多数方言,建议功能默认处于开启状态。您可以将 suggestions: no 语句添加到 view 定义中,以针对视图中支持建议的所有维度停用过滤值建议。
对于某些方言(例如 Amazon Athena、Qubole Presto、Trino、Cloudera Impala、Apache Hive 和 Apache Spark),提供建议需要查询数据库,这可能会产生高昂的费用。因此,如果您使用 Looker 为这些方言从数据库中自动生成项目,Looker 将创建包含
suggestions: no声明的视图。
示例
以下示例视图中,所有维度的建议均已停用:
view: aircraft_types {
sql_table_name: flightstats.aircraft_types ;;
suggestions: no
...
}
注意事项
在数据视图级应用的 suggestions 与在维度级应用的 suggestions 效果不同
本页中所述的 suggestions 参数应用于视图,其运作方式与应用于维度的 suggestions 参数不同。在维度级应用时,suggestions 可让您为相应维度硬编码建议列表。
如果您想针对某个维度停用建议,可以针对该维度使用 suggestable: no 语句。
您可以针对个别维度停用建议
如果您想针对单个维度停用建议,可以向该维度的定义添加 suggestable: no 语句,而不是针对整个视图使用 suggestions: no。不过,反过来却不行:您无法先使用 suggestions: no 定义视图,然后使用 suggestable: yes 语句为视图中的各个维度启用建议。之所以这样设置行为,是因为如果开发者在视图级别指定 suggestions: no,则表示开发者希望防止对该视图的数据库进行开销大的查询,因此应针对该视图中的所有维度关闭建议。
作为替代方案,对于具有 suggestions: no 的视图,您可以针对各个维度使用 suggestions 参数来硬编码过滤器的可能值,即使维度的视图具有 suggestions: no 语句也是如此,因为硬编码的值不需要查询数据库。