创建 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 会使用 LookML 名称将该字段添加到表达式中，格式为 ${view_name.field_name}。这可确保所有字段在表达式中都具有唯一名称。

添加总计

如果您要创建基于“探索您在哪里显示了总计”的表达式，则还可以在表达式中包含列总计和行总计。在编辑器中，列总计值显示在字段名称的 LookML 迭代之前，带有 Total 一词。例如，对于名为 Count 的字段，Looker 会将该字段的总计列命名为 Count - Total。

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

对于行总计，“Row Totals”一词在编辑器中的字段名称前面显示；在字段的 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}。当您执行此操作时，就是说“对于任何给定行，从该行中获取产品类别”。

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

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

  • 获取某一行或某列中的总计值：如果您向“探索”中添加了总计值，则可以使用 ${field_name:total} 格式向字段名称中添加 :total（针对列总计）或 :row_total（针对行总计），以获取相应列或行的总计值。例如，如果您希望指定在订单总数中所占的百分比，则可以创建如下表格计算：${orders.count} / ${orders.count:total}。

使用运算符

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

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

除非您使用括号另行指定，否则系统会在 OR 逻辑之前考虑 AND 逻辑。以下表达式（不含其他括号）：

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 函数为例，其文档如下所示：

函数 语法 Purpose
包含 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 函数中。其工作方式如下：

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

从逻辑上来说，这个表达式的含义是：“如果有客户反馈，就在其中进行搜索。如果不是，则改为在客户评论中搜索。在这两种情况下，请查找“great”一词。