本页面引用了模型中的
explore
参数。
explore
也可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
explore
也可以用作信息中心元素的一部分。如需了解其使用方式的示例,请参阅 LookML 信息中心的柱形图参数文档页面。
用量
层次结构
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
的参数。