创建 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")

如果字词“好极了”出现在客户反馈中，则此函数的结果为 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”一词。

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