创建 Looker 表达式

Looker 表达式

Looker 表达式（有时称为 Lexp）用于针对以下对象执行计算：

Looker 表达式由以下元素组合构成：

  • NULL：值 NULL 表示没有数据，当您想要检查某个内容是否为空或不存在时，此值会很有用。

  • 常量：常量是您提供的不变值。数字（例如 7）或字符串（例如 Completed）是常量。

  • Looker 字段：对 Looker 字段的引用，包括维度、测量和表计算。

  • Looker 运算符：运算符有多种类型（详见 Looker 函数和运算符文档页面）：

    • 数学运算符（例如 +、-、* 和 /）
    • 比较运算符（例如 =、> 和 <=）
    • 逻辑运算符（例如 AND、OR 和 NOT）

  • Looker 函数：这些函数的性质与 Excel 函数类似。借助函数，您可以以复杂的方式转换数据或引用数据。所有可用函数均列在 Looker 函数和运算符文档页面上。

创建 Looker 表达式

表计算、自定义字段和自定义过滤条件使用 Looker 表达式编辑器。在您输入表达式时，Looker 会提示您可能要使用的函数、运算符和字段名称。

查看所有建议

通过创建表格计算、自定义字段或自定义过滤条件，在探索中访问 Looker 表达式编辑器。

输入一个空格，即可查看可供选择的所有字段、函数和运算符的列表。如果“探索”中当前选择了一个字段，Looker 会在该字段左侧显示一个黑点，并将该字段显示在列表顶部。

开始在 Looker 表达式编辑器中输入内容，以缩短列表，仅显示您感兴趣的项目。

如果当前使用的“探索”字段与自定义字段的函数兼容，自定义字段的编辑器会显示这些字段。

添加字段

如需在表达式中添加 Looker 字段，请开始输入该字段的名称。在您输入内容时，编辑器会将搜索范围缩小到包含您输入内容的字段和函数列表。您可以输入“探索”页面上显示的字段名称，也可以使用其 LookML 名称（如果您知道）。

当您从列表中选择某个字段时，Looker 会使用 ${view_name.field_name} 格式的 LookML 名称将其添加到表达式中。这样可确保表达式中的所有字段都有唯一的名称。

添加总计

如果您要根据显示了总计的探索创建表达式，则还可以在表达式中添加列和行的总计。列总计会显示在编辑器中，字段名称的 LookML 迭代前面会显示“总计”字样。例如，对于名为“Count”的字段，Looker 会为该字段的列总和命名为 Count - Total。

总计的 LookML 名称采用 ${view_name.field_name:total} 格式，其中 :total 会添加到字段名称的末尾。

对于行总计，编辑器中字段名称前面会显示“行总计”字样；在字段的 LookML 名称中，系统会在字段名称的末尾添加 :row_total，例如 ${view_name.field_name:row_total}。

添加运算符

您可以根据需要向表达式中添加逻辑运算符，例如 AND、OR 和 NOT。通常，AND 运算符会在 OR 运算符之前进行求值，但您可以使用圆括号替换此行为。您还可以使用比较运算符（例如 >、= 和 <=）和数学运算符（例如 + 和 *）。

当您将光标悬停在运算符上时，信息窗格中会显示有关正确使用方式的备注。

添加函数

如需在表达式中添加 Looker 函数，请开始输入函数的名称。当您输入内容时，编辑器会将搜索范围缩小到包含您输入内容的字段和函数列表。

函数可以由需要特定类型（例如字段、数字或是/否）的实参（或变量）构成。当您将光标悬停在函数上时，可以查看信息窗格中表达式旁边显示的备注，了解您需要提供哪些实参以及它们的类型。

您可以在 Looker 函数和运算符文档页面上查看 Looker 提供的完整函数列表。

使用错误提示和信息窗格

Looker 会在 Looker 表达式编辑器旁边显示一个信息窗格。此窗格会提供文档和建议，尤其是当表达式中存在错误时。

表达式编辑器旁边的信息窗格会提供以下信息：

  • 错误突出显示：Looker 会用红色下划线突出显示表达式中尚不正确的部分。

  • 建议和错误详情：Looker 会就表达式中接下来要添加的内容提供建议。如果出现错误，系统会说明出现错误的原因。如果存在多个错误，系统会根据光标的位置显示相应错误。

  • 文档：Looker 会根据光标位置显示与您正在使用的函数或运算符相关的文档。例如，当您输入 if() 函数的第一个实参时，Looker 会提供第一个实参应评估为 true 或 false 的信息。您可以点击函数名称，前往该函数的文档。

包含评论

您可以在 Looker 表达式中添加注释，只需在表达式编辑器中将注释行开头添加 # 即可。

使用字段

有时，您需要在表达式中使用字段（维度、测量值或表格计算）的值。您可能需要将该字段的值添加到其他内容、检查其是否具有某个值、将其包含在函数中，或执行许多其他操作。

如本页前面所述，您可以将字段的名称输入到表达式编辑器中，Looker 会帮助您找到引用该字段的正确方法。向表达式添加字段时，Looker 会使用该字段的 LookML 标识符，该标识符类似于 ${view_name.field_name}。输入字段选择器中显示的字段名称，表达式编辑器将同时显示字段选择器名称和 LookML 标识符。

您可以通过多种方式检索值：

  • 从同一行获取值：使用字段的最基本方法是直接引用它。例如，您的表达式可能会使用 ${product.category}。这样做，就相当于说“对于任何给定行，从该行中提取 Product Category”。

  • 从其他行获取值：您还可以从其他行获取字段的值。例如，您可能需要使用以下逻辑：“对于任何给定行，从前一行获取商品类别”。为此，您可以使用偏移函数（请参阅此位置函数列表）。偏移函数可能如下所示：offset(${product.category}, -1)。

  • 从数据透视表列中获取值：您还可以从数据透视表列中获取值。例如，您可能希望使用以下逻辑：“对于任何给定行，从第一个数据透视列中提取总销售额”。如需处理数据透视表列，您需要使用数据透视表函数（请参阅此数据透视表函数列表）。枢轴函数可能如下所示：pivot_index(${order.total_sales}, 1)。

  • 获取行或列的总计：如果您向“探索”添加了总计，则可以使用 ${field_name:total} 格式，将 :total（对于列总计）或 :row_total（对于行总计）添加到字段名称，从列或行中获取总计值。例如，如果您想要计算“Orders” 计数的百分比，可以创建如下表格计算：${orders.count} / ${orders.count:total}。

使用运算符

Looker 表达式可以包含逻辑运算符、比较运算符和数学运算符，以创建不同的条件：

  • 逻辑运算符（例如 AND、OR 和 NOT）
  • 比较运算符（例如 > 和 <）
  • 数学运算符（例如 + 和 -）

除非您使用圆括号指定其他逻辑，否则系统会先考虑 AND 逻辑，然后再考虑 OR 逻辑。以下不带额外括号的表达式：

if (
  ${order_items.days_to_process}>=4 OR
  ${order_items.shipping_time}>5 AND
  ${order_facts.is_first_purchase},
"review", "okay")

的求值结果为：

if (
  ${order_items.days_to_process}>=4 OR
  (${order_items.shipping_time}>5 AND ${order_facts.is_first_purchase}),
"review", "okay")

在 Looker 中，您应使用 yes 和 no，而不是 true 和 false。这些逻辑常量与用引号括起来的字词 "yes" 和 "no" 不同。如需了解详情，请参阅逻辑常量说明。

使用函数

Looker 表达式通常包含一个或多个函数，可帮助您检索特定数据或计算特定内容。它们的性质与 Excel 函数类似。

函数的形式为名称后跟一对圆括号，例如：my_function()。您可能需要在这些圆括号内提供信息，并以英文逗号分隔。这些信息称为“参数”，如下所示：my_function(argument_1, argument_2)。

例如，now 函数不接受任何参数，并会为您提供当前日期和时间。使用方法如下：now()。

round 函数接受一个参数，该参数为数字。使用方法如下：round(3.2)。结果为 3。

您可以通过以下两种方式了解需要提供哪些参数（如果有）：

  • 表达式编辑器旁边显示的信息窗格提供了一些关于您正在编写的函数的文档。您可以点击函数的名称以前往其文档。
  • 您也可以直接前往 Looker 函数和运算符文档页面，查找要使用的函数。

考虑 contains 函数，其文档如下所示：

函数 语法 用途
包含 contains(string, search_string) 如果 string 包含 search_string，则返回 Yes；否则返回 No

您可以看到，需要两个实参。它们的名称分别为 string 和 search_string，但这并不意味着您需要在函数中输入确切的字词“string”和“search_string”。这些只是实参的名称，您将用其他内容替换它们。从用途来看，string 应是我们要搜索的字段或其他值，而 search_string 是我们要搜索的内容。示例如下：

contains(${customer.feedback_text}, "great")

如果客户反馈中出现“great”一词，则此函数会返回 Yes 结果。否则，结果为 No。

您可以将函数放入其他函数中，以处理复杂的逻辑。只要内层函数的结果适合外层函数的参数，就能够正常运行。例如：

contains(
  if(
    is_null(${customer.feedback_text}),
    ${customer.comment_text},
    ${customer.feedback_text}
  ),
"great")

is_null 函数嵌套在 if 函数内，而 contains 函数本身也嵌套在 is_null 函数内。具体运作方式如下：

  1. is_null() 函数用于检查客户反馈文本。
  2. 接下来，if() 函数会使用该结果，并返回客户反馈文本（如果有），否则返回客户评论文本。
  3. 最后，contains() 函数使用 if() 函数返回的文本，并在其中搜索“great”一词。

从逻辑上讲，此表达式表示：“如果有客户反馈，则在其中搜索。如果没有，请改为在客户评论中搜索。在这两种情况下，请查找“great”一词。