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

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

例如,如果用户将鼠标悬停在加利福尼亚州上,根据总毛利润分组(按分组)的地图可视化提示会显示这两个字段的值。

用户将光标悬停在加利福尼亚州上方,系统显示一条提示,其中包含州值“加利福尼亚州”和总毛利润值“$988,018.58”。

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

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

所需要素

  • 流体变量 - 流动变量会将其他字段的值结合现有的“探索”查询呈现。
  • html 参数 - 当用户将鼠标悬停在可视化图表上时,测量的 html 参数中定义的字段将呈现在提示中。
  • 可视化图表 - 在使用某些可视化类型时,当用户将光标悬停在数据点上时,系统会显示提示。

前提条件

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

自定义提示的注意事项

自定义提示时,请务必注意以下事项:

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

示例

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

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

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 值。

后续步骤

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