建议(针对视图)

此页面指的是属于视图suggestions 参数。

suggestions 还可以用作维度过滤字段的一部分,如 suggestions(针对字段)参数文档页面中所述。

用法

view: view_name {
  suggestions: yes
}
层次结构
suggestions
默认值
yes

接受
布尔值(yesno

定义

当用户根据支持建议的字段过滤探索时,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 语句也是如此,因为硬编码的值不需要查询数据库。