view_label（适用于探索）

此页面涉及 探索的一部分 view_label 参数。

view_label 还可以用作联接的一部分，如 view_label（用于联接）参数文档页面中所述。

view_label 还可以用作维度、衡量指标或过滤条件的一部分，如 view_label（针对字段）参数文档页面中所述。

用法

explore: explore_name {
  view_label: "desired label for the view"
}

层次结构 模型文件 explore view_label

默认值 探索的名称 接受 一个字符串

定义

view_label 更改了探索的基本视图中的一组字段在字段选择器中的标签方式。

有时，view_label 用于在视图名称前面添加下划线，以便按字母顺序排序时，该视图成为字段选择器中的顶部视图。或者，当您出于建模目的需要多个视图，但这些视图对于业务用户而言代表的是同一实体时，也可以使用它。例如，您可能在 LookML 中定义了一个名为 customer 的视图和另一个名为 customer_facts 的视图，并且希望它们保留这些名称以用于建模。不过，对于企业用户而言，这两者都显示为 Customer 可能更有意义。

如果您想更改字段本身的名称，可以使用 label 参数。

示例

使 customer_facts“探索”功能对业务用户显示为“客户”视图的一部分：

explore: customer_facts {
  view_label: "Customers"
}

使 product_facts“探索”显示为 Product Info 视图的一部分：

explore: product_facts {
  view_label: "Product Info"
}

注意事项

view_label 除了更改字段选择器的外观之外，没有其他任何效果

更改探索的 view_label 时，只会影响字段选择器。“探索”在探索菜单中的显示方式以及字段在 LookML 中的引用方式均保持不变。

将多个视图与 view_label 结合使用时，请使用正确的大小写

如果您希望在字段选择器中将探索的基本视图中的字段与探索的某个联接视图中的字段合并，则需要确保 view_label 中使用的英文大写字母正确无误。您使用的大小写应与视图名称在字段选择器中的显示方式一致。请看以下示例

explore: product {
  view_label: "Product Info"
  join: product_info {
    sql_on: ${product.product_id} = ${product_info.product_id} ;;
  }
}

product_info 在字段选择器中显示为 Product Info；每个字词的首字母都大写，下划线改为空格。因此，我们使用了 view_label: 'Product Info' 而不是 view_label: 'product_info'。

字段的 view_label 优先于 Explore 的 view_label

如果探索中的某个字段具有 view_label，则该字段将显示在其 view_label 下，而不是探索的 view_label 下。请看以下示例，其中“探索”和维度都具有 view_label 值。

在模型文件中，使用 view_label: "View Label on Explore" 定义探索：

explore: us_births {
  label: "US births"
  view_label: "View Label on Explore"
}

在 us_births.view 文件中，state 维度使用 view_label: "View Label on Field" 定义：

view: us_births {
  label: "US births"

  dimension: state {
    view_label: "View Label on Field"
    type: string
    sql: ${TABLE}.state ;;
  }

在这种情况下，state 维度的 view_label 将替换探索的 view_label，因此在探索中，state 维度将显示在“字段上的视图标签”view_label 下。

view_label 会影响“探索”的基本视图

此参数与 view_label（用于联接）类似，但会影响探索的基本视图，而不是联接的视图。与 label（适用于视图）不同，此参数仅影响相应探索中的基本视图。