充分利用 Looker 可视化实战宝典:提示自定义

可视化图表提示默认显示所选维度和测量的值,可帮助用户了解单点数据的重要性。

例如,如果地图可视化图表基于总毛利润分组,则当用户将鼠标悬停在加利福尼亚州上时,该图表的提示将显示这两个字段的值。

用户将光标悬停在“California”上,系统会显示一个提示,其中包含“State”值“California”和“Total Gross Margin”值“$988,018.58”。

但是,如果您想在提示中添加默认值以外的字段,以便用户无需查看其他位置即可获取有关数据点的更多信息或上下文,该怎么办?

您可以自定义提示,以显示多个指定字段(包括“探索”查询中不包含的字段)中的值。

原料

前提条件

自定义提示需要满足以下要求:

提示自定义的注意事项

自定义提示时,请务必考虑以下事项:

  • html 参数的值将成为可视化图表的 y 轴。
  • 您希望在 y 轴上显示的值应该是测量的 sql 参数的值。
  • 当您使用任何格式化的测量(type: percent_of_total 的测量或带有 value_format_namevalue_format 参数的测量)时,请务必对呈现的值 {{ field_name._rendered_value }} 使用 Liquid 语法(其中 field_name 是测量或维度的实际名称)。

示例

默认情况下,可视化数据点的提示将包含总毛利润的值。不过,如果您想向用户提供地图上未显示或“探索”查询中未包含的其他信息,该怎么办?如果您想包含“总毛利润百分比”(而不是“状态”)字段的值,该怎么办?添加占总毛利润百分比有助于用户了解单个数据点的总毛利润值与整个数据集的总毛利润相比如何。

如需自定义提示,请按以下步骤操作:

measure: total_gross_margin {
  type: sum
  value_format_name: decimal_2
  sql: ${gross_margin} ;;
  html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}
  1. 开发模式下,前往要自定义的字段的 LookML 定义。

    您可以从“探索”直接导航到字段的 LookML 定义。

  2. 除了原始字段之外,确定您希望在提示中包含的字段和值。例如,总毛利润百分比

  3. html 参数添加到“探索”查询中引用并在提示中显示的原始衡量标准。在这种情况下,“探索”查询中当前显示在提示中的度量方式是总毛利润

  4. html 参数中,使用 Liquid 变量创建一个表达式,将其他字段附加到现有衡量标准的值。

    • 此示例使用 Liquid 变量 _rendered_value 显示采用 Looker 格式的值。例如,total_gross_margin 使用 Looker 格式设置,保留两位小数,而 percent_of_total_gross_margin 使用 Looker 格式设置,保留两位小数的百分比。
    • 您可以使用竖线字符 | 来分隔不同字段的值。
    • 您还可以附加其他字词,以阐明在提示中呈现的其他值的含义。在本例中,添加了 of total 以说明百分比值的含义。
  5. 保存和验证代码,在验证其按预期运行后将其推送到生产环境。

现在,当用户将鼠标悬停在带有提示的数据点上时,提示会显示两个值:数据点的 total_gross_margin 值和相应的 percent_of_total_gross_margin 值。

后续步骤

使用自定义提示创建可视化图表后,您可以与他人共享该图表: