使用 LookML 设置数据值的格式

本页面简要介绍了用于修改数据表格和可视化图表中显示的数据值的外观和行为的 LookML 参数。 例如，您可以指定货币格式，以便 1234 等数据值在数据表格和可视化图表中呈现为 $1,234.00。您还可以为字段指定可点击的行为，以便用户点击字段来触发操作或跟随链接。

修改数据值的格式

本部分介绍了用于更改数据值在用户眼中的显示方式的 LookML 参数。

参数 说明 示例
value_format 使用 value_format，通过 Excel 样式的选项设置 type: number 字段的输出格式。

请注意，value_format 对非 type: number 字段没有影响。		 
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#,##0.00"
 }
value_format_name 使用 value_format 使用内置或自定义 named_value_format 设置 type: number 字段的输出格式。

请注意，value_format 和 value_format_name 对非 type: number 字段没有影响。 
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}
style 使用 style 参数更改 type: tier 字段的格式。

请注意，style 是唯一会影响 type: tier 字段格式的 LookML 参数。 
dimension: age_tier {
  type: tier
  tiers: [0, 10, 20, 30, 40, 50, 60, 70, 80]
  style: classic
  sql: ${age} ;;
}
html 使用 html 参数可对字段应用 HTML 格式。

例如，您可以更改字体、字号、字体粗细或字体颜色。此表中的示例展示了如何根据字段的值向其添加表情符号。 
dimension: status {
  sql: ${TABLE}.status ;;
  html: {% if value == 'Shipped' or value == 'Complete' %}
      <p>✅ {{value}}</p>
    {% elsif value == 'Processing' %}
      <p>⏳ {{value}}</p>
    {% else %}
      <p>❌ {{value}}</p>
    {% endif %}
   ;;
}
sql 使用 sql 参数通过 SQL 更改数据值。

使用数据库允许的任何 SQL 转换。下表中的示例展示了如何根据字段值向字段添加表情符号。 
dimension: status {
  sql: CASE WHEN (${TABLE}.status = 'Shipped' OR ${TABLE}.status = 'Complete') ;;
     THEN CONCAT('✅ ', ${TABLE}.status)
   WHEN ${TABLE}.status = 'Processing'
     THEN CONCAT('⏳ ', ${TABLE}.status)
   ELSE
     CONCAT('❌ ', ${TABLE}.status)
   END ;;
}

修改数据值的可点击操作

本部分介绍了 LookML 参数，这些参数用于确定字段在点击数据表或可视化图表中的数据值时的行为。

参数 说明 示例
drill_fields 使用 drill_fields 可指定用户深入查看数据时要显示的字段。请注意，维度和测量有不同的展开行为。

如需了解用于构建自定义展开路径的高级选项，请参阅更强大的数据展开。 
dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}
action 使用 action 针对字段创建数据操作，让用户能够直接在 Looker 中执行其他工具中的任务。

如果某个字段定义了一项或多项操作，则数据表格中该字段旁边会显示省略号 (...)。点击字段或省略号会弹出一个菜单，用户可以从该菜单选择操作或深入了解数据。 
dimension: action_example {
  action: {
    label: "Send a Thing"
    url:
      "https://example.com/ping/{{value}}"
    form_url:
      "https://example.com/ping/{{value}}/form.json"
  }
}
link 使用 link 在字段上创建链接。

如果字段定义了一个或多个链接，则数据表中的字段旁边会显示省略号 (...)。点击字段或省略号会显示一个菜单，用户可以从该菜单中选择链接或深入了解数据。 
dimension: artist_name {
  link: {
    label: "Google"
    url: "http://www.google.com/search?q={{value}}"
    icon_url: "http://google.com/favicon.ico"
   }
}
html 使用 html 为字段编写自定义 HTML 格式。借助 HTML 标记（如 <a> 标记），您可以在字段中指定一个或多个超链接。

如果某个字段定义了一个或多个操作或链接，那么无论 html 定义如何，数据表中的字段旁边都会显示省略号 (...)。点击字段或省略号会显示一个菜单，用户可以从中选择任何可用的链接或操作。 
dimension: artist_name {
  html: <p>{{value}}
    <a href="#drillmenu">Drill menu</a>,
    <a href="http://www.google.com/search?q={{value}}">
      Google search
    </a></p>;;
    sql: ${TABLE}.artist_name ;;
    type: string
}