概览
通过 LookML 优化,您可以调整现有视图或探索,而无需修改包含该视图的 LookML 文件。此功能非常适合:
- 使用 Looker Blocks(使用 LookML 的预构建片段)的项目
- 从其他项目导入文件的项目
- 您经常需要根据数据库中的表生成文件的项目
- 希望在模型或项目之间共享 LookML,同时在每个位置进行自定义(中心辐射型配置)的场景
例如,如果您的项目中具有以下视图文件:
view: flights {
sql_table_name: flightstats.accidents ;;
dimension: id {
label: "id"
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
}
您可以优化 flights
视图,如以下示例所示:使用相同的视图名称使用 view
参数,但在名称前面添加一个加号 (+
),以表明它是对现有视图的优化。
此次优化将 air_carrier
维度添加到了现有的 flights
视图中:
view: +flights {
dimension: air_carrier {
type: string
sql: ${TABLE}.air_carrier ;;
}
}
此优化可以用于项目中的任何 LookML 文件,例如模型文件、视图文件或其专属的 LookML 文件。如需了解工作原理,请参阅在 LookML 项目中使用优化功能部分。
结合原始 LookML 的优化得到的最终结果就好比是视图的原始 LookML:
view: flights {
sql_table_name: flightstats.accidents ;;
dimension: id {
label: "id"
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
dimension: air_carrier {
type: string
sql: ${TABLE}.air_carrier ;;
}
}
在 Looker 界面中,用户会看到“航空公司”维度,就像您已将该维度添加到原始视图文件本身一样。
如需了解更详细的实现信息,请参阅示例部分。
与扩展项相比的优化次数
Looker 还支持扩展 LookML 对象。如果您想为现有视图或“探索”创建新对象,以便向该视图添加新对象,则扩展功能非常有用。例如,您可以创建一个定义所有字段的基本视图,然后创建扩展该基本视图的多个新视图。然后,您可以修改这些新视图,以隐藏基本视图中的特定字段,或在基本视图中更改字段的定义或标签。
如果您想修改现有视图或对某些对象进行一些调整或调整,但不想创建视图或探索的副本,则优化非常有用。优化非常适合以下情形:您无法或不想修改基本视图或“探索”,以及创建新视图或“探索”需要对其他 LookML 引用进行大量更改的情况。有关此使用场景的示例,请参阅本页中的示例部分。
对于大多数使用场景来说,优化是替代 extends
的一种更简单、更简洁的替代方案。
高级 LookML 开发者可能需要在 LookML 优化中使用 extends
参数。如需了解详情,请参阅本页中的优化可以包含扩展部分。
优化会覆盖大多数参数
请务必注意,在大多数情况下,优化会覆盖对象的原始设置。在以下示例中,原始视图具有一个隐藏维度 (hidden: yes
):
view: faa_flights {
dimension: carrier {
hidden: yes
}
}
在另一个文件中,使用 hidden: no
对该维度进行了优化:
include: "/views/faa_flights.view.lkml"
view: +faa_flights {
dimension: carrier {
hidden: no
}
}
以最后一个优化为准,因此系统会应用 hidden: no
,并且该维度将显示在最终视图中。
在某些情况下,优化会进行累加,而不是覆盖;请参阅本页的某些参数可累加部分。
有些参数是累加的
在许多情况下,如果优化包含与要优化的对象相同的参数,则优化将覆盖优化对象的参数值。
但优化对某些参数而言可能是累加的,也就是说,基础对象中的值将与优化对象中的值结合使用。
以下参数可累加:
对于维度和测量:
对于参数:
对于派生表:
对于视图:
extends
(如需了解详情,请参阅此页面上的优化extends
是累加的部分。)
对于探索:
access_filter
aggregate_table
extends
(如需了解详情,请参阅此页面上的优化extends
是累加的部分。)join
query
例如,以下视图包含一个具有 link
参数的 name
维度:
view: carriers {
sql_table_name: flightstats.carriers ;;
dimension: name {
sql: ${TABLE}.name ;;
type: string
link: {
label: "Google {{ value }}"
url: "http://www.google.com/search?q={{ value }}"
icon_url: "http://google.com/favicon.ico"
}
}
}
以下是对 carriers
视图的优化,其中 name
维度的 link
形参具有不同的值:
include: "/views/carriers.view.lkml"
view: +carriers {
label: "Refined carriers"
dimension: name {
sql: ${TABLE}.name ;;
type: string
link: {
label: "Dashboard for {{ value }}"
url: "https://docsexamples.dev.looker.com/dashboards/307?Carrier={{ value }}"
icon_url: "https://www.looker.com/favicon.ico"
}
}
}
在经过优化的 carriers
视图中,这两个 link
参数是累加的,因此 name
维度会显示两个链接。
按顺序应用优化条件
一个对象可以在多个位置进行多次优化,这让 Looker 开发者能够以多种创造性方式使用优化。但这也意味着开发者必须非常注意应用优化的顺序:
- 在项目中,系统会按照文件添加的顺序来应用优化。最后包含的文件的优化条件会覆盖之前包含的文件的优化条件。
- 在单个文件中,系统会逐行应用优化,并逐行应用。行号最高的优化将最后应用,如果存在冲突,将覆盖之前的所有优化。
例如,以下视图文件中就有两个优化的 faa_flights
视图。第一个优化会隐藏维度 (hidden: yes
),第二个优化则会显示维度 (hidden: no
)。出现此类冲突时,系统将优先考虑文件中最下方的优化:
include: "//e_faa_original/views/faa_flights.view.lkml"
view: +faa_flights {
dimension: carrier {
hidden: yes
}
}
view: +faa_flights {
dimension: carrier {
hidden: no
}
}
在项目中包含多个文件的逻辑相似:以包含项中列出的最后一个文件中的优化项为准。例如,如果模型文件包含以下文件:
include: "/refinements/distance_analysis.lkml"
include: "/refinements/finishing_touches.lkml"
系统会先应用 distance_analysis.lkml
中的所有优化,然后再应用 finishing_touches.lkml
文件中的所有优化。如果存在任何冲突,则以最后一个文件 finishing_touches.lkml
中的优化为准。
使用 final: yes
阻止进一步优化
如前所述,系统可能会在多个位置多次优化同一个对象,并且上次优化将覆盖之前的所有优化。
如果您希望将某个优化条件视为视图或“探索”的最终优化条件,可以为该优化条件添加 final: yes
标志。如果存在会在此最终优化之后应用的现有优化,或者如果开发者尝试添加将在最终优化之后应用的新优化,则 Looker IDE 将返回 LookML 错误。例如,此视图文件中的第二个优化将创建 LookML 错误,因为前一个优化具有 final: yes
标志:
include: "//e_faa_original/views/faa_flights.view.lkml"
view: +faa_flights {
final: yes
dimension: carrier {
hidden: yes
}
}
view: +faa_flights {
dimension: carrier {
hidden: no
}
}
向优化条件添加 final: yes
标志是验证优化条件是否按您预期的顺序应用的好方法。
优化可以包含扩展
高级 LookML 开发者可能需要在 LookML 优化中使用 extends
参数,这会将扩展的对象添加到要优化的对象中。
总结一下 extends
和优化措施的行为:
- 扩展对象会创建对象的新副本,然后在此副本的基础上构建。例如,您可以创建一个定义所有字段的基本视图,然后创建扩展该基本视图的多个新视图。每个新视图都包含基本视图的副本,开发者可以在其中添加不同的字段、过滤器或其他属性来修改基本视图中的内容。具体思路是,从一个基础对象开始,然后在多个其他对象中以不同的方式使用该基础对象。(有关使用扩展的完整讨论,请参阅通过扩展重复使用代码文档页面。)
- 优化对象会向对象添加一层修改,但与扩展不同,优化不会创建对象的多个副本。其理念是在基础对象的基础上构建,而不修改其原始 LookML。
举例来说明优化的标准用法,下面是一个名为 orders
的探索和用于对其进行优化的 +orders
探索:
explore: orders {
view_name: orders
# other Explore parameters
}
explore: +orders {
label: "Orders Information"
# other Explore parameters to build on the original Explore
}
此外,您还可以添加包含 extends
的优化。以示例为基础,下面就是同一个 orders
探索。此外,还有一个名为 users_base
的基本探索,现在 +orders
优化包含一个 extends
形参,该形参引入了 users_base
:
explore: users_base {
view_name: users
extension: required
# other Explore parameters
}
explore: orders {
view_name: orders
# other Explore parameters
}
explore: +orders {
label: "Orders Information"
extends: [users_base]
# other Explore parameters to build on the original Explore
}
这里的特别之处在于,+orders
优化中包含 extends
。结果是,+orders
视图现在会扩展 users_base
的“Explore”(探索)。
Looker 如何在优化条件中实现 extends
在优化中扩展对象是一个高级 LookML 概念。在使用 extends
进行优化之前,您应该对以下内容有深入了解:
- Looker 如何实现
extends
:如果同时在扩展对象和扩展对象中定义了 LookML 元素,系统会使用扩展对象中的版本,除非该参数是附加参数。如需了解详情,请参阅通过扩展重复使用代码文档页面。 - Looker 如何实现优化:如果在多个优化中定义了一个 LookML 元素,则最后一次优化会覆盖之前的优化。有关详情,请参阅此页面上的按顺序应用优化条件部分。
最后,您应该了解 Looker 如何结合这些原则来实现在优化中使用的 extends
。以下是 Looker 实现的顺序;如果发生冲突,每个步骤都会覆盖前一个步骤:
- 对象中指定的
extends
中的值 - 在对象的优化中指定的
extends
中的值 - 对象中的值
- 来自对象的优化条件的值
为便于说明,以下示例遵循了 label
参数的值完成每个实现步骤:
explore: orders_base {
label: "Orders Base"
view_name: orders
extension: required
}
explore: users_base {
label: "Users Base"
view_name: users
extension: required
}
explore: orders {
label: "Orders"
extends: [orders_base]
}
explore: +orders {
label: "Orders Refined"
extends: [users_base]
}
下面的示例展示了 Looker 如何为 orders
探索实现 label
的值:
- 对象中指定的
extends
的值。由于orders
探索具有extends
参数,因此 Looker 将从要扩展的对象(在本例中为orders_base
探索)中的 LookML 元素开始。此时,label
值为“Orders Base”。 - 在对象的优化中指定的
extends
中的值。由于orders
有优化条件且优化包含extends
参数,因此 Looker 随后会应用优化扩展(在本例中为users_base
探索)中的 LookML 元素。此时,label
值为“Users Base”。 - 对象中的值。现在所有扩展均已得到解决,Looker 会应用扩展对象(在本例中为
orders
探索)中的元素。如有任何冲突,扩展对象优先。现在,label
的值为“Orders”。 - 对象优化设置的值。最后,Looker 会应用来自
orders
“探索”页面的所有优化元素。如果存在任何冲突,优化对象将胜出。因此,label
的值现在为“OrdersRefine”。
优化条件“extends
”可累加
如本页中的优化条件替换参数部分所述,优化目标通常会覆盖对象的原始设置。extends
参数并非如此。在优化中使用 extends
时,extends
形参中的值会附加到原始对象或之前的优化(如果有)中扩展的项目列表。然后,如果存在任何冲突,则优先处理扩展链中的最后一项。
例如,下面是一个名为 orders_base
的基本探索,还有一个扩展了该基础的 orders
探索。此外,还有 users_base
探索和 +orders
优化,用于扩展 users_base
:
explore: orders_base {
view_name: orders
extension: required
# other Explore parameters
}
explore: users_base {
view_name: users
extension: required
# other Explore parameters
}
explore: orders {
extends: [orders_base]
# other Explore parameters to build on the base Explore
}
explore: +orders {
extends: [users_base]
# other Explore parameters to build on the base Explores
}
orders
探索扩展了 orders_base
,然后 +orders
优化将 users_base
添加到 extends
列表中。结果是 +orders
探索现在将同时扩展 orders_base
和 users_base
,就好像这是探索的原始 LookML 一样:
explore: orders {
extends: [orders_base, users_base]
}
然后,如果存在任何冲突,则优先处理扩展链中的最后一项。在此示例中,users_base
中的元素将替换 orders_base
中的任何冲突元素。
通过扩展重复使用代码文档页面讨论了一次扩展多个对象的概念。
最后要注意的一点:在此示例中,explore
参数的顺序无关紧要。但在对同一对象进行多项优化的情况下,优化的顺序很重要。如本页面中的按顺序应用优化条件部分所述,文件中的最后一个优化条件会覆盖之前的优化条件。
在 LookML 项目中使用优化
以下是优化项目中的视图和探索的大致步骤:
- 确定要优化的视图或“探索”。
- 确定要放置优化目标的位置。您可以在任何现有的 LookML 文件中添加优化条件,也可以为优化项目创建单独的 LookML 文件。(如需查看创建通用 LookML 文件的示例,请参阅“了解其他项目文件”文档页面上的创建数据测试文件的过程。)
- 使用
include
参数将您的优化融入模型:- 在编写优化的文件中,必须包含要优化的 LookML 的文件。如果您尝试优化未包含的对象,Looker IDE 会向您发出警告。
- 在模型文件中,添加定义了优化的文件。您可以非常有创意的方式合并文件并使用 include ;有关详情,请参阅本页的使用优化条件向模型添加层部分。
示例
通过优化 LookML 对象,您可以轻松调整视图和探索,而无需修改原始 LookML。当视图和探索在项目中处于只读状态时(例如,对于从其他项目导入的文件),此功能会特别方便。以下是优化“探索”的示例。
以下是 aircraft
探索的 LookML:
explore: aircraft {
join: aircraft_types {
type: left_outer
sql_on: ${aircraft.id} = ${aircraft_types.id} ;;
relationship: many_to_one
}
join: aircraft_engine_types {
type: left_outer
sql_on: ${aircraft.id} = ${aircraft_engine_types.id} ;;
relationship: many_to_one
}
}
此“探索”包含多个视图,每个视图又包含多个维度。
现在,另一个名为 e_faa_refined
的 LookML 项目导入 aircraft
探索文件。在 e_faa_refined
项目中,您可以使用优化来大幅简化 aircraft
的“Explore”。
由于 aircraft
探索是导入的文件,因此您无法直接修改。而是可以对其加以优化。以下示例展示了一个名为 refinements.lkml
的单独文件,该文件包含此 LookML:
include: "//e_faa_original/Explores/aircraft.explore.lkml"
explore: +aircraft {
label: "Aircraft Simplified"
fields: [aircraft.aircraft_serial, aircraft.name, aircraft.count]
}
refinements.lkml
文件包含以下内容:
include
参数,用于从导入的项目中引入原始aircraft.explore.lkml
文件(如需详细了解如何引用导入的项目文件,请参阅从其他项目导入文件文档页面)。aircraft
探索优化:
最终结果就好像是原始的 aircraft
探索和 aircraft
视图:
explore: aircraft {
label: "Aircraft Simplified"
}
view: aircraft {
sql_table_name: flightstats.aircraft ;;
dimension: aircraft_serial {
type: string
sql: ${TABLE}.aircraft_serial ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
measure: count {
type: count
}
}
如需查看使用优化为多个用例自定义单个视图的示例,请参阅使用 DRY LookML 最大限度地提高代码可重用性:为多个用例自定义单个基本视图实战宝典方法。
其他优化用例
如前所述,优化非常适合于调整只读的 LookML 对象,例如 Looker 块或导入的文件。
但是,一旦您了解了如何添加优化元素并将其添加到模型中,就可以对项目执行非常酷的操作,如下例所示。
使用优化添加分析
您可以使用优化功能向模型中添加分析,而无需更改原始 LookML 文件。例如,如果项目的视图和探索是根据数据库中的表生成并存储在名为 faa_basic.lkml
的 LookML 文件中,则您可以创建 faa_analysis.lkml
文件,在其中使用优化功能添加分析。以下示例展示了一个名为 distance_stats
的新派生表,其中包含距离分析。此示例展示了对 faa_basic.lkml
文件中现有 flights
探索的优化,该文件将 distance_stats
派生表联接到 flights
探索。此外,在示例的底部,我们对现有 flights
视图进行了优化,以从分析中添加新字段:
include: "faa_basic.lkml"
explore: +flights {
join: distance_stats {
relationship: one_to_one
type: cross
}
}
view: distance_stats {
derived_table: {
explore_source: flights {
bind_all_filters: yes
column: distance_avg {field:flights.distance_avg}
column: distance_stddev {field:flights.distance_stddev}
}
}
dimension: avg {
type:number
sql: CAST(${TABLE}.distance_avg as INT64) ;;
}
dimension: stddev {
type:number
sql: CAST(${TABLE}.distance_stddev as INT64) ;;
}
}
view: +flights {
measure: distance_avg {
type: average
sql: ${distance} ;;
}
measure: distance_stddev {
type: number
sql: STDDEV(${distance}) ;;
}
dimension: distance_tiered2 {
type: tier
sql: ${distance} ;;
tiers: [500,1300]
}
}
使用优化向模型添加层
另一个有趣的优化用例是向项目中添加层。您可以创建多个优化文件,然后有策略地将它们加入其中,以添加图层。
例如,在 FAA 项目中,有一个 faa_raw.lkml
文件,其中包含根据数据库中的表生成的所有视图和探索。此文件有一个针对数据库中的每个表的视图,每个表都有一个与每个数据库列对应的维度。
除了原始文件之外,您还可以创建一个 faa_basic.lkml
文件来添加经过基本优化的新图层,例如向探索中添加联接或为视图添加测量,如下所示:
include: "faa_raw.lkml"
explore: +flights {
join: carriers {
sql_on: ${flights.carrier} = ${carriers.name} ;;
}
}
view: +flights {
measure: total_seats {
type: sum
sql: ${aircraft_models.seats} ;;
}
}
然后,您可以添加 faa_analysis.layer.lkml
文件,以添加带有分析的新图层(有关分析文件的示例,请参阅使用优化条件添加分析子部分)。
接下来,只需将所有优化文件添加到模型文件中即可。您还可以使用模型文件添加优化,将视图指向要引用的数据库表:
connection: "publicdata_standard_sql"
include: "faa_raw.lkml"
include: "faa_basic.lkml"
include: "faa_analysis.lkml"
view: +flights {
sql_table_name: lookerdata.faa.flights;;
}
view: +airports {
sql_table_name: lookerdata.faa.airports;;
}
view: +aircraft {
sql_table_name: lookerdata.faa.aircraft;;
}
view: +aircraft_models{
sql_table_name: lookerdata.faa.aircraft_models;;
}
view: +carriers {
sql_table_name: lookerdata.faa.carriers;;
}
您可以复制该模型文件并指向不同的数据库表,也可以添加已创建的不同优化文件,以定义模型中所需的其他图层。
针对 PDT 使用优化
如本页的与扩展项相比的优化点部分所述,扩展程序会为要扩展的对象创建新副本。对于永久性派生表 (PDT),请勿使用扩展名,因为 PDT 的每个扩展名都会在数据库中创建一个表的新副本。
但是,您可以向 PDT 视图添加优化,因为优化不会创建要优化的对象的新副本。
使用元数据查看对象的优化
您可以在 Looker IDE 中点击 explore
或 view
参数,并使用元数据面板查看对象的任何优化设置。如需了解详情,请参阅 LookML 对象的元数据文档页面。
需要考虑的事项
已本地化的项目
优化对象时请注意,本地化规则也适用于优化对象。如果要优化对象,然后定义新的标签或说明,则应在项目的语言区域字符串文件中提供本地化定义。如需了解详情,请参阅将 LookML 模型本地化文档页面。