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

您可以使用多个 LookML 参数,在不更改底层 LookML 的情况下更改字段在界面中的显示方式,使探索更方便用户使用。本页面简要介绍了 LookML 参数,这些参数用于修改 Looker“探索”菜单字段选择器的外观。

在 Looker 中,您的用户可以查看“探索”菜单中列出的“探索”功能。 在“探索”中,用户可以使用字段选择器来选择用于查询数据的字段(维度测量值)。

探索列在“探索”菜单中它们所属模型的名称下方的列表中。 “探索”中的字段选择器会显示一个可展开的视图列表,其中包含可添加到查询中的字段。

本页面列出了每个常用参数,并提供指向其完整参考页面的链接、其功能的简短说明及用途的图片。

如需有关如何打造方便用户使用的“探索”页面的提示和建议,请参阅最佳实践:为 Looker 用户打造积极的体验页面。

浏览名称和菜单

本部分介绍了 Explore 菜单上“Explore”的名称和外观的默认行为,然后介绍了可用于更改此行为的 LookML 参数:

探索菜单的默认行为

模型名称

默认情况下,探索菜单按模型名称排列,这些名称由每个模型文件的名称决定。探索菜单会显示已设置格式的模型名称,其中下划线已更改为空格,且每个单词的首字母均为大写。每个模型名称下方都有一个模型文件中定义的探索列表。

探索名称

菜单中每个“探索”的名称均基于模型文件中对应的 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”菜单的“Explore”列表中。 “订单商品”标签显示在字段选择器面板的左上角。

如需详细了解模型文件,请参阅了解模型和查看文件文档页面。如需详细了解如何定义探索,请参阅 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 参数,则“探索”名称根据其默认行为显示。

“Explore”菜单和字段选择器中带有“Order Item Information”标签的“Explore”。

group_label(探索)

“探索”功能的 group_label 参数会更改探索菜单的默认组织方式。借助 group_label,您可以定义一个自定义标题,以便在其下列出一个或多个探索,而无需在每个模型名称下列出它。

在此示例中,“浏览”客户产品目录订单商品用户数据列于在线商店查询组标签下:

“探索”菜单中“在线商店查询”组标签下方的“浏览”列表。

description(探索)

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

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

hidden(探索)

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

例如,在以下示例中,将 LookML 代码 hidden: yes 添加到 inventory 探索的 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 参数。

通过以下代码更改视图名称在字段选择器中的显示方式:

使用以下代码更改各个字段的名称在字段选择器中的显示方式:

使用以下代码更改字段选择器中字段的整理方式:

字段选择器默认行为

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

在以下示例中,Looker 在字段选择器中将 accounts 视图显示为 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_numbername 维度、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 视图在 Order Items 探索的字段选择器中显示为 Orders and more

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 视图中的字段分组到视图标签商品信息下:

“商品”视图中的字段已分组在“商品信息”视图标签下。

label(查看)

视图的 label 参数会更改视图在字段选择器中的标记方式,而不会更改视图在 LookML 中的引用方式。如果未指定,则标签默认为视图的名称。与 view_label(探索)view_label(联接)不同,此参数会影响使用该视图的所有探索。

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


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

在此示例中,字段选择器针对 inventory_items 视图显示 Items in Inventory 标签,而不是默认标签 Inventory items

description(字段)

您可以将 description 添加到任何字段。对于 BigQuery 连接,如果您从数据库生成 LookML 项目,Looker 将使用 BigQuery 列元数据中的描述(如果有)自动填充字段说明。

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

此外,当用户将鼠标悬停在探索、信息中心或 Look 的表格或表格图表中的列名称上时,Looker 也会显示说明。

hidden(字段)

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

如果隐藏字段是手动添加到网址中的,则仍然可以在界面中访问,并且会在某些 Looker 窗口中显示。因此,应将 hidden 视为一种使字段选择器保持简洁的方式,而不是一项安全功能。

例如,在以下示例中,将 LookML 代码 hidden: yes 添加到 product_id 维度的 LookML 会在字段选择器中隐藏产品 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 ;;
}

在此示例中,“费用”维度的字段选择器中带有“价格”标签。

view_label(字段)

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

例如,您可以使用 view_label 参数为 cost 维度指定视图标签,如下所示:


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

在此示例中,Looker 会在字段选择器的费用信息视图标签下显示费用维度。

group_label(字段)

借助 group_label 参数,您可以在字段选择器的视图中将多个字段合并到一个共同的下拉列表中。

在此示例中,Shipping Info(送货信息)组包含 Shipping City(送货城市)、Shipping Country(送货国家/地区)和 Shipping State(送货状态)字段:

“探索”字段选择器中的“Shipping Info”(配送信息)组。

group_item_label(字段)

当字段显示在组标签下时,可能不需要在字段选择器中显示其完整字段名称或标签。在之前针对 group_label(字段)显示的示例中,组标签已指示这些字段与运费相关。在这种情况下,您可以向每个分组字段添加 group_item_label 参数,以更改这些字段在组标签下的显示方式。

在此示例中,Shipping Info(配送信息)组包含 City(城市)、Country(国家/地区)和 State(州)字段:

“探索”字段选择器中的“Shipping Info”(配送信息)组。