您可以使用多种 LookML 参数来更改字段在界面中的显示方式，从而使探索更易于用户使用，而无需更改底层 LookML。本页面简要介绍了 LookML 参数，这些参数用于修改 Looker“探索”菜单和字段选择器的外观。
| 在 Looker 中，您的用户可以查看“探索”菜单中列出的“探索”功能。 | 在探索中，用户可以使用字段选择器来选择用于查询其数据的字段（维度和测量）。 |
|
|
本页面列出了每个常用参数，并提供指向其完整参考页面的链接、其功能的简短说明及用途的图片。
如需有关打造人性化探索体验的提示和建议，请参阅最佳实践：为 Looker 用户打造良好体验最佳实践页面。
探索名称和菜单
本部分介绍了“探索”在探索菜单中的名称和外观的默认行为，然后介绍了可让您更改此行为的 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 参数文档页面。
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 添加到 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 视图显示为账号，这是默认行为：
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
}
}
这会在字段选择器的视图标签 Product Facts 下对 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（送货状态）字段：
group_item_label（字段）
当字段显示在组标签下时，可能不需要在字段选择器中显示其完整字段名称或标签。在之前针对 group_label（字段）显示的示例中，组标签已表明这些字段与配送相关。在这种情况下，您可以向这些分组字段中的每个字段添加 group_item_label 参数，以更改它们在组标签下的显示方式。
在此示例中，Shipping Info（配送信息）组包含 City（城市）、Country（国家/地区）和 State（州）字段：
