本页面指的是属于模型的
explore参数。
explore还可以用作信息中心过滤条件的一部分,如信息中心参数文档页面中所述。
explore还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例,请参阅 LookML 信息柱状图参数文档页面。
用法
explore: explore_name { . . . }
|
层次结构
explore |
默认值
无
接受
现有视图的名称,或者使用 from 时 explore 的名称
特殊规则
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 的参数。