探索

本页面指的是属于模型explore 参数。

explore 还可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。

explore 还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例,请参阅 LookML 信息柱状图参数文档页面。

用法

explore: explore_name { . . . }
层次结构
explore
默认值

接受
现有视图的名称,或者使用 fromexplore 的名称

特殊规则
explore 名称在给定模型中必须是唯一的

定义

如果探索名称前面有加号 (+),例如 explore: +orders,则表示该探索是探索的细化。如需了解详情,请参阅 LookML 细化文档页面。

explore 会将现有视图添加到 Looker 的“探索”菜单中,如 LookML 术语和概念文档页面中所述。最佳实践是,在模型文件中定义 Explore。

探索通常以现有视图命名。不过,如果您想基于同一视图创建多个探索,可以向探索添加 from 参数。在这种情况下,您可以为探索功能指定任何有效名称,该名称只能包含小写字母 (a-z)、数字 (0-9) 和下划线。

explore 在 Looker 生成的 SQL 中发挥着重要作用。假设用户从“探索”菜单中选择客户并运行查询。此customers探索基于名为 customers 的视图,该视图与数据库表相关联。该表位于用户 SQL 查询的 FROM 子句中。

explore 可以有多个子形参,这些子形参会影响显示和过滤行为,并指定为探索添加联接。如果探索包含一个或多个联接,则这些联接可以具有用于指定首选联接行为的联接参数

示例

根据名为 users 的视图向“探索”菜单添加选项:

explore: users {
  # additional explore parameters go here
}

在“探索”菜单中添加一个名为事件的选项,该选项基于名为 user_events 的视图:

explore: events {
  from: user_events
}

常见挑战

explore 需要引用现有视图名称

您无法使用 explore 参数来定义视图中包含的数据库表、维度、指标和其他字段。您需要先使用 view 参数定义视图。然后,您可以在 explore 中引用该视图的名称。

explore 需要引用视图名称,而不是文件名

通常,视图的名称与定义该视图的视图文件相同。这不是必需的 - 视图名称和视图文件名可以不同。

例如,假设您在名为 company_users 的文件中定义了一个名为 users 的视图。视图文件 company_users 如下所示:

view: users { ... }

然后,您可以使用以下代码将 users 视图添加到“探索”菜单:

explore: users { ... }

即使 users 视图位于名为 company_users 的文件中,文件的名称也无关紧要。只有 view 参数中的视图名称才重要。

如果您在探索中使用 type: count度量,可视化图表会使用视图名称而非“数量”一词来标记结果值。为避免混淆,我们建议您将视图名称改为复数形式,在图表设置的序列下选择显示完整字段名称,或使用包含视图名称复数形式的 view_label

注意事项

explore 通常与其他参数搭配使用

您可以单独使用 explore,而无需添加其他参数。在实践中,您通常会看到 explore 与其他选项搭配使用。例如,将其他视图join到探索中非常常见。

explore 关联的所有其他参数都会显示在探索参数页面上。联接参数页面上会显示可在探索中用于 join 的参数。