请注意，您正在查看 Looker 文档。如需查看 Looker Studio 文档，请访问 https://support.google.com/looker-studio。

此页面由 Cloud Translation API 翻译。

LookML 优化

概览

通过 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 结合使用后，最终结果就如同该视图的原始 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 参数。如需了解详情，请参阅本页的精炼项可以包含 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，并且该维度将显示在最终视图中。

在某些情况下，优化是累加的，而不是替换的；如需了解详情，请参阅本页的部分参数是累加的部分。

有些参数是累加的

在许多情况下，如果优化包含与要优化的对象相同的参数，则优化将覆盖优化对象的参数值。

但优化对某些参数而言可能是累加的，也就是说，基础对象中的值将与优化对象中的值结合使用。

以下参数是累加的：

对于维度和测量：
对于参数：
- allowed_value
对于派生表：
对于观看：
- extends（如需了解详情，请参阅本页的精炼 extends 是累加的部分。）
对于探索：
- access_filter
- aggregate_table
- extends（如需了解详情，请参阅本页的精炼 extends 是累加的部分。）
- join
- query

例如，以下视图具有 name 尺寸和 link 参数：

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)。如果出现此类冲突，文件中位于最底部的修 refine 会优先：

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 和优化措施的行为：

扩展对象会创建对象的新副本，然后在此副本的基础上构建。例如，您可以创建一个用于定义所有字段的基础视图，然后创建多个用于扩展基础视图的新视图。每个新视图都包含基本视图的副本，开发者可以在其中添加不同的字段、过滤条件或其他属性来修改基本视图中的内容。具体思路是，从一个基础对象开始，然后在多个其他对象中以不同的方式使用该基础对象。（如需全面了解如何使用 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 元素，则使用扩展对象中的版本，除非参数为累加。如需了解详情，请参阅使用“extends”重复使用代码文档页面。
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 中的任何冲突元素。

如需了解一次扩展多个对象的概念，请参阅使用 extends 重复使用代码文档页面。

最后要注意的一点：在此示例中，explore 参数的顺序无关紧要。但是，如果同一对象有多个精确化，精确化的顺序很重要。如本页中的优化会按顺序应用部分所述，文件中的最后一个优化会覆盖之前的优化。

在 LookML 项目中使用优化

以下是优化项目中的视图和探索的大致步骤：

确定您要优化的视图或“探索”部分。
确定要放置优化目标的位置。您可以在任何现有 LookML 文件中添加优化条件，也可以为优化项目创建单独的 LookML 文件。（如需查看创建通用 LookML 文件的示例，请参阅“了解其他项目文件”文档页面上的创建数据测试文件的过程。）
使用 include 参数将您的优化融入模型：
- 在编写优化的文件中，必须包含要优化的 LookML 的文件。如果您尝试优化未包含的对象，Looker IDE 会向您发出警告。
- 在模型文件中，添加定义了优化的文件。您可以非常有创意地组合文件并使用包含项；如需了解详情，请参阅本页中的使用优化项向模型添加层部分。

示例

通过优化 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 探索。

由于 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 探索优化：
- “探索”名称前面的 + 符号表示对现有“探索”的优化。
- label 参数将“探索”的标签更改为“飞机已简化”。
- fields 参数指定“探索”中将仅显示三个字段。

最终结果就好像是原始的 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 模型本地化文档页面。