探索

本页面引用了模型中的 explore 参数。

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

explore 也可以用作信息中心元素的一部分。如需了解其使用方式的示例,请参阅 LookML 信息中心的柱形图参数文档页面。

用量

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


接受
现有视图的名称,或者使用 from 时的 explore 的名称

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

定义

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

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

探索通常以现有数据视图命名。不过,如果您想根据同一视图设置多个探索,则可以向探索添加 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 的参数。