标签（针对字段）

本部分指的是属于字段的 label 参数。

label 还可以用作模型的一部分，如 label（针对模型）参数文档页面中所述。

label 还可以用作探索的一部分，如 label（适用于探索） 参数文档页面中所述。

label 还可以用作视图的一部分，如 label（针对视图）参数文档页面中所述。

label 也可以用作参考线的一部分，如信息中心参考线参数文档页面中所述。

用法

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}
层次结构
view
字段类型
label
可能的字段类型
维度、维度组、度量、过滤条件、参数

接受
一个字符串

定义

label 可让您选择字段名称在字段选择器和探索的数据表中的显示方式，从而使探索更易于使用。如果未指定标签，则标签默认为字段的名称。

包含 label 的 Liquid 变量

您可以将 Liquid 变量与 label 参数搭配使用。借助 Liquid 变量，您可以访问数据，例如模型或探索的相关信息、应用于字段的过滤条件以及用户属性值。您可以使用 Liquid 变量动态更改 label 值，从而更改字段选择器和数据可视化图表中的字段外观。

根据过滤条件返回值的 Liquid 变量（例如 _filters）或需要先运行查询的 Liquid 变量（例如 in_query）不会更改字段选择器中的字段名称。在这种情况下，字段名称只会更改为最终的可视化图表中的名称。

例如，Liquid 变量 {{ _user_attributes['name_of_attribute'] }} 会将 Liquid 变量替换为指定用户属性的值。如果用户有一个名为 name 的用户属性，其值为“John Smith”，则以下 label 语法会将字段选择器中的字段名称更改为 John Smith：

label: "{{ _user_attributes['name'] }}"

在下一个示例中，name 维度使用 Liquid {% if %} {% else %} {% endif %} 结构和 _user_attributes['name_of_attribute'] Liquid 变量，根据 company 用户属性更改其 label 值：

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

如需查看使用 label 和 Liquid 变量定义动态标签的其他示例，请参阅在标签中使用 Liquid 的有趣方式最佳实践页面。

示例

使此指标在字段选择器中显示为客户数，而不是去重后的客户数。

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

注意事项

IDE 会标记视图中的重复标签

为防止同一视图中出现重复的字段标签，Looker IDE 会在 LookML 视图文件中任何重复的字段标签的行号旁边显示一个信息图标。如果您将鼠标悬停在行号旁边的信息图标上，系统会显示一个提示，指出视图中已存在具有相应标签的字段。

如果您在 Looker IDE 中选择 label 语句的文本，Looker IDE 将在快速帮助面板中显示相同的信息：