您可以使用多种 LookML 参数来更改字段在界面中的显示方式，从而使探索更易于用户使用，而无需更改底层 LookML。本页面简要介绍了用于修改 Looker“探索”菜单和字段选择器外观的 LookML 参数。
| 在 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，您可以定义一个自定义标题，并在该标题下列出一个或多个探索，而不是在每个模型的名称下列出每个探索。
在本示例中，探索 Customers（客户）、Inventory（商品目录）、Order Items（订单项）和 User Data（用户数据）列在群组标签 Online Store Queries（网店查询）下：
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
}
}
这会在字段选择器中将 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 视图显示“Items in Inventory”（商品目录中的商品）标签，而不是默认标签“Inventory Items”（商品目录项）。
description（字段）
您可以向任何字段添加 description。对于 BigQuery 连接，如果您从数据库生成 LookML 项目，Looker 会使用 BigQuery 列元数据中的说明（如果有）自动填充字段说明。
用户可以在多个位置看到此说明。当用户在字段选择器中选择字段名称右侧的信息图标时，Looker 会显示相应说明。
此外，当用户在探索、信息中心或数据分析中将光标悬停在表格或表格图表可视化图表中的列名称上时，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（州/省/直辖市）字段：
