探索

本页介绍属于 模型一部分的 explore 参数。

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

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

用法

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

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

特殊规则
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 的视图,向“探索”菜单添加一个名为 Events 的选项:

explore: events {
  from: user_events
}

常见挑战

explore 需要引用现有视图名称

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

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

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

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

view: users { ... }

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

explore: users { ... }

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

当您在探索中使用 衡量指标 type: count时,可视化图表会使用视图名称(而不是“Count”一词)为生成的值添加标签。为避免混淆,我们建议您将视图名称复数化,在可视化图表设置的系列 下选择显示完整字段名称 ,或使用带有视图名称复数版本的 view_label

注意事项

explore 通常与其他参数一起使用

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

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