更改“探索”菜单和字段选择器

您可以使用多个 LookML 参数，更改字段在界面中的显示方式，而不改变底层 LookML，从而为探索探索提供更加人性化的体验。本页简要介绍了用于修改 Looker 探索菜单和字段选择器外观的 LookML 参数。

在 Looker 中，用户可以查看探索菜单中列出的“探索”。	在“探索”中，您的用户可以使用字段选择器选择要用于查询其数据的字段（维度和测量）。

此页面列出了每个常用参数，包括指向其完整参考页面的链接、函数简短说明及其功能图片。

如需有关如何构建方便用户使用的“探索”工具的提示和建议，请参阅最佳实践：为 Looker 用户打造良好的体验最佳实践页面。

探索名称和菜单

本部分介绍了探索的名称和外观在探索菜单中的默认行为，然后介绍可让您更改该行为的 LookML 参数：

• label（型号）
• label（探索）
• group_label（探索）
• description（探索）
• hidden（探索）

探索菜单的默认行为

模型名称

默认情况下，探索菜单按模型名称整理，名称由每个模型文件的名称决定。探索菜单会显示模型名称的格式版本，其中下划线会更改为空格，且每个单词的首字母都大写。每个模型名称下方都会显示模型模型中定义的“探索”列表。

探索名称

菜单中每个“探索”的名称都基于模型文件中对应的 explore 参数。与模型名称一样，“探索”名称采用菜单中的格式，因此下划线会更改为空格，且每个单词的首字母都大写。“探索”名称也会在字段选择器上方显示为“探索”标题。

在以下示例中，order_items 探索在模型文件 e_commerce_model.model 中定义：

explore: order_items {
  join: orders {
    type: left_outer
    sql_on: ${order_items.order_id} = ${orders.id} ;;
    relationship: many_to_one
  }
}

order_items 探索在“探索”菜单和字段选择器中会显示为订单项。

“探索”菜单：	字段选择器：

如需详细了解模型文件，请参阅了解模型和查看文件文档页面。如需详细了解如何定义“探索”，请参阅 explore 参数文档页面。

label（型号）

模型的 label 参数会在探索菜单中重命名模型，而不会更改它在 LookML 中引用的方式。探索网址、Looker IDE 和 SQL Runner 仍会反映实际模型名称；应在 LookML 和管理员设置中引用模型的方式保持不变。

默认情况下，“market_research.model”模型在“探索”菜单中显示为市场调研。

您可以使用 label 参数在“探索”菜单中重命名模型。例如，您将代码 label: "Marketing R&D" 添加到 market_research.model 模型文件中：

label: "Marketing R&D"

在此示例中，Looker 在“探索”菜单中按如下方式显示模型名称：

label（探索）

“探索”的 label 参数会在探索菜单和“探索”页面上重命名“探索”，但不会改变它在 LookML 中引用的方式。

如果未使用 label 参数，“探索”名称会根据其默认行为显示。

group_label（探索）

“探索”的 group_label 参数会更改探索菜单的默认组织。您可以使用 group_label 定义一个自定义标题，在其中列出一个或多个探索，而不是在其模型名称下列出每个探索。

在此示例中，“探索”客户、广告资源、订单商品和用户数据列在组标签网店查询下：

description（探索）

“探索”的 description 参数可让您向界面添加“探索”的说明，以便用户在创建报告时获取更多信息。

用户只需将鼠标悬停在字段选择器顶部的“探索”名称旁边，即可查看说明。信息图标也会显示在“探索”下拉列表中。如果您未向“探索”部分明确添加说明，系统将不会显示任何说明。

hidden（探索）

“探索”的 hidden 参数会从探索菜单中隐藏“探索”。默认情况下，“hidden”处于关闭状态，且会显示“探索”。hidden 不会隐藏 LookML，也不会阻止通过网址访问“探索”。hidden 不是安全功能，而是一种演示功能。

例如，在下面的示例中，将 LookML 代码 hidden: yes 添加到 inventoryML 的 LookML 中，就会在“探索”菜单中隐藏广告资源“探索”：

explore: inventory {
  hidden: yes

  join: order_facts {
    view_label: "Orders"
    relationship: many_to_one
    sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
  }
}

字段选择器

本部分将介绍字段选择器的默认行为，然后介绍可让您更改该行为的 LookML 参数。

更改视图名称在字段选择器中的显示方式：

• view_label（探索）
• view_label（加入）
• label（查看）

通过以下方法更改各个字段在字段选择器中的显示方式：

• description（字段）
• hidden（字段）
• label（字段）
• fields（字段）

如需更改字段在字段选择器中的组织方式，请执行以下操作：

• view_label（字段）
• group_label（字段）

字段选择器默认行为

默认情况下，字段选择器按与 LookML view 参数指定的视图对应的标题进行整理。每个视图的字段都会分组到字段选择器中。字段的类型（维度、维度组、衡量、过滤条件字段和参数字段）决定了该字段在视图中的显示位置。除非使用 label 参数更改显示名称，否则字段选择器会显示 LookML 视图或字段名称的格式化版本，其中下划线会更改为空格，且每个单词的首字母都大写。

在以下示例中，Looker 将 accounts 视图显示为字段选择器中的帐号，这是默认行为：

view: accounts {
  sql_table_name: accounts ;;
}

以下示例默认展示了维度、维度组和衡量方式的名称。所有过滤条件字段和参数字段的名称均采用相同的格式。

dimension: account_number {
  primary_key: yes
  type: number
  sql: ${TABLE}.account_number ;;
}

dimension: name {
  type: string
  sql: ${TABLE}.name ;;
}

dimension_group: created {
  type: time
  timeframes: [raw, time, date, week, month, quarter, year]
  sql: ${TABLE}.created_date ;;
}

measure: average_annual_revenue {
  type: average
  sql: ${annual_revenue} ;;
  value_format_name: custom_amount_value_format
}

在此示例中，字段选择器会分别显示 account_number 和 name 维度、created 维度组和 average_annual_revenue 衡量的默认字段名称帐号、名称、创建日期和年收入。

如果您更改字段的名称，字段选择器会根据新名称做出调整，但您可能需要使用字段的旧名称添加 alias 参数。该参数用于为可能出现在查询中的字段提供备用名称。当模型中的字段名称发生变化，但有些人拥有指向数据的共享链接，而您希望让这些既有的网址发挥作用时，该方法就非常有用。

view_label（探索）

“探索”的 view_label 参数会更改“探索”的基本视图中字段在字段选择器中的标签方式，但不会更改“探索”及其字段在 LookML 中引用的方式。

例如，如果您将视图 order_facts 与名为 order_items 的“探索”联接，则可以使用 view_label 参数设置 Looker 在字段选择器中为 order_facts 视图显示的标签，如下所示：

explore: order_items {
  label: "Order Items"
  join: order_facts {
    view_label: "Orders and more"
    relationship: many_to_one
    sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
  }
}

在此示例中，order_facts 视图在“订单商品”探索中的字段选择器中显示为订单等。

view_label（加入）

联接的 view_label 参数可让您在字段选择器中，将一个视图的字段分组到另一个视图名称下。如果您没有为联接明确添加 view_label，view_label 默认为联接的名称。

例如，您将 products 视图与 product_facts 探索相关联：

explore: product_facts {
  join: products {
    type: left_outer
    sql_on: ${product_facts.product_id} = ${products.id} ;;
    relationship: many_to_one
  }
}

在此示例中，由于未指定视图标签，因此 products 视图中的字段会分组到字段选择器中的产品视图标签下，与产品事实视图分开：

您可以使用 view_label 形参为联接的 products 视图添加视图标签，如以下示例所示：

explore: product_facts {
  join: products {
    view_label: "Product Facts"
    type: left_outer
    sql_on: ${product_facts.product_id} = ${products.id} ;;
    relationship: many_to_one
  }
}

这会将 products 视图中的字段归入字段选择器中的视图标签 Product Facts 的下方：

label（查看）

视图的 label 参数会更改视图在字段选择器中的标签添加方式，而不会改变其在 LookML 中的引用方式。如果未指定，标签会默认为视图的名称。与 view_label（探索）和 view_label（联接）不同，此参数会影响使用视图的所有探索。

例如，您可以使用 label 参数为 inventory_items 视图指定标签，如下所示：

view: inventory_items {
  label: "Items in Inventory"
  sql_table_name: inventory_items ;;
}

在此示例中，字段选择器会为 inventory_items 视图显示产品目录中的项目标签，而不是默认标签产品目录项目。

description（字段）

您可以向任何字段添加 description。对于 BigQuery 连接，如果您基于数据库生成 LookML 项目，Looker 会使用您的 BigQuery 列元数据（如果有）中的字段自动填充字段说明。

用户可以在多个位置看到此说明。当用户选择字段选择器中字段名称右侧的信息图标时，Looker 会显示相应的说明。

此外，当用户将鼠标悬停在“探索”部分、信息中心或“查看”部分的表格或表格图表可视化图表中的列名称上时，Looker 也会显示相应说明。

hidden（字段）

默认情况下，视图中指定的字段会显示在字段选择器中。该字段的 hidden 参数会在字段选择器中隐藏一个字段。

如果隐藏字段已手动添加到网址中，那么您仍然可以在界面中访问它们，并且这些字段将在某些 Looker 窗口中显示。因此，请将 hidden 视为保持字段选择器简洁的一种方式，而非安全功能。

在以下示例中，向product_id维度的 LookML 添加 LookML 代码 hidden: yes 会向字段选择器隐藏产品 ID 维度：

dimension: product_id {
  hidden: yes
  type: number
  sql: ${TABLE}.product_id ;;
}

fields（字段）

借助 fields 参数，您可以指定“探索”功能的基础视图中的哪些字段以及联接在字段选择器中显示。如果您不使用 fields 参数，Looker 将公开所有字段。

如需指定要在字段选择器中显示的字段，请使用以英文逗号分隔的字段或集合列表。如需指定要在字段选择器中隐藏的字段，请使用 ALL_FIELDS* 集以及要排除的字段或集的英文逗号分隔列表，并在前面加上连字符 (-)。

例如，您可以使用以下 LookML 代码，仅显示字段选择器中 aircraft 探索的部分字段：

explore: aircraft {
  fields: [
    aircraft.aircraft_model_code,
    aircraft.aircraft_engine_code,
    aircraft.count,
    aircraft.city,
    aircraft.country,
    aircraft.zip,
   ]
}

在此示例中，“飞机探索”仅会显示字段选择器中的“飞机型号代码”、“飞机引擎代码”、“城市”、“国家/地区”和“计数”维度。

label（字段）

借助字段的 label 参数，您可以更改字段名称在字段选择器中的显示方式，而无需在 LookML 中引用该字段的方式。如果未指定标签，标签将默认为字段名称。

例如，您可以使用 label 参数为 cost 维度设置标签，如下所示：

dimension: cost {
  label: "price"
  type: number
  sql: ${TABLE}.cost ;;
}

在此示例中，“费用”维度在字段选择器中具有 price 标签。

view_label（字段）

通过字段的 view_label 参数，您可以更改要在字段选择器中列出字段的视图的名称，而无需更改它在 LookML 中引用的方式。如果未指定标签，该字段将显示在其定义所在视图的标签下方。

例如，您可以使用 view_label 参数为 cost 维度指定视图标签：

dimension: cost {
  view_label: "Cost Information"
  type: number
  sql: ${TABLE}.cost ;;
}

在此示例中，Looker 在字段选择器的 Cost Information 视图标签下显示 Cost 维度。

group_label（字段）

使用 group_label 参数，您可以在字段选择器的视图中将一个共同的下拉列表中的各个字段合并到一起。

在此示例中，配送信息组包含配送城市、配送国家/地区和配送状态字段：

group_item_label（字段）

当字段标签在组标签下方显示时，它们可能不需要在字段选择器中显示它们的完整字段名称或标签。在前面为 group_label（字段）显示的示例中，群组标签已指明这些字段与配送有关。在这种情况下，您可以向每个分组字段添加 group_item_label 参数，以更改它们在组标签下的外观。

在此示例中，配送信息组包含城市、国家/地区和州/省字段：