建议（针对字段）

此页面指的是属于维度、过滤条件字段或参数的 suggestions 参数。

您还可以将 suggestions 用作视图的一部分，如 suggestions（适用于视图）参数文档页面中所述。

用法

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}

层次结构 查看文件 view 字段类型 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 参数，您可以为维度、过滤字段或参数硬编码建议值列表，以便在有人使用该字段过滤查询时显示这些建议值。

注意： 虽然 Looker 会缓存此查询的前 1,000 个结果，但只有前 100 个结果会作为过滤条件建议显示给用户。

如果该字段位于大型表中，则此查询可能会过慢或造成过大的数据库负载。通过使用 suggestions，您可以对可能的值列表进行硬编码，从而提高性能。

suggestions 参数也很有用，因为如果您不希望某个字段中的某些值显示为建议，可以使用该参数指定更有限的列表。

注意： case 参数中的 label 值优先于 suggestions 参数中向用户显示的建议。

示例

将 colors 维度的默认建议替换为硬编码列表：

dimension: colors {
  type: string
  sql: ${TABLE}.colors ;;
  suggestions: ["red", "yellow", "blue"]
}