创建 Looker 表达式

如果管理员已授权您创建表计算,您可以使用以下功能快速执行常用函数,而无需创建 Looker 表达式:

  • 快捷方式计算,可用于对探索数据表中的数字字段快速执行常见计算

如果您的管理员授予您创建自定义字段权限,您可以使用以下功能快速执行常用函数,而无需创建 Looker 表达式:

  • 自定义组:可通过自定义标签快速对值进行分组,而无需在 sql 参数或 type: case 字段中开发 CASE WHEN 逻辑

  • 自定义箱,用于将自定义层级中的数字类型维度分组,而无需开发 type: tier LookML 字段

Looker 表达式

Looker 表达式(有时称为 Lexp)用于执行下列计算:

Looker 表达式是基于以下元素的组合构建的:

  • NULL:值 NULL 表示没有数据,适合用于检查是否存在空值或不存在的情况。

  • 常量:常量是指您提供的不变值。数字(如 7)或字符串(如 Completed)是常量。

  • Looker 字段:对 Looker 字段的引用,其中包括维度、测量和表计算。

  • Looker 运算符:有几种类型的运算符(列于 Looker 函数和运算符文档页面上):

    • 数学运算符(例如 +-*/
    • 比较运算符(例如 =><=
    • 逻辑运算符(例如 ANDORNOT
  • Looker 函数:这类函数在本质上与 Excel 函数类似。函数可让您以复杂的方式转换或引用数据。Looker 函数和运算符文档页面上列出了所有可用函数。

创建 Looker 表达式

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

Handy 提示:如果您是 Looker 开发者,想要创建数据测试来验证模型的逻辑,则可以使用 Looker 表达式编辑器来构建 Looker 表达式,然后将表达式复制到数据测试的 expression 参数中。

查看所有建议

您可以在“探索”中通过创建表格计算自定义字段自定义字段来访问 Looker 表达式编辑器。

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

开始输入,将列表缩短到您感兴趣的项。

自定义字段编辑器会显示目前正在使用的“探索”字段(如果这些字段与自定义字段的功能兼容)。

添加字段

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

从列表中选择字段后,Looker 会以 ${view_name.field_name} 形式的 LookML 名称将该字段添加到表达式中。这样可确保所有字段在表达式中都具有唯一的名称。

如需详细了解如何使用字段,请参阅本页面的使用字段部分。

添加总计

如果您根据“探索”中显示总计值的位置创建表达式,还可以在表达式中添加列和行总计值。编辑器中显示的列总计值会在字段名称的 LookML 迭代前面显示 Total 一词。例如,对于名为 Count 的字段,Looker 会为该列指定总计值 Count - Total

总计的 LookML 名称格式为 ${view_name.field_name:total},其中 :total 将添加到字段名称的末尾。对于行总计,在编辑器中的字段名称前面会显示行总计一词;在字段的 LookML 名称中,会在字段名称的末尾添加 :row_total

添加运算符

您可以根据需要向表达式添加 ANDORNOT 等逻辑运算符。通常,AND 运算符在 OR 运算符之前求值,但您可以使用括号替换此行为。此外,您还可以使用比较运算符(例如 >=<=)和数学运算符(例如 +*)。

当您的光标位于运算符上时,信息窗格中会显示正确使用的注释。

如需详细了解如何使用运算符,请参阅本页面的使用运算符部分。

添加函数

要在表达式中添加 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} 添加列值(针对列总计值)或 :row_total(针对行总计),以便获取列或行的总计值,格式为 ${field_name:total}:total例如,如果您想在订单总数中占一定百分比,则可以创建如下表格计算:${orders.count} / ${orders.count:total}

在引用自定义过滤条件中的字段时,您只能使用维度,不能使用维度、总计值或表格计算值。此外,您不能引用其他行或透视列中的值。这是因为 Looker 必须能够将您的过滤器转换为 SQL 才能检索数据。

自定义过滤条件自定义字段仅支持部分时间和日期选项。如需了解详情,请参阅维度组参数说明。

表格计算中引用字段时,您可以引用任何维度、测量值或其他表计算中的任何值。

使用运算符

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

  • 逻辑运算符(例如 ANDORNOT
  • 比较运算符(例如 ><
  • 数学运算符(例如 +-

除非用括号另行指定,否则 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 中,您应使用 yesno,而不是 truefalse。这些逻辑常量与用引号括起来的单词 "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

您可以看到两个参数是必填项。它们分别名为 stringsearch_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 函数内。其运作方式如下:

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

从逻辑上来说,这个表达式意味着:“如果有客户反馈,就在其中搜索。如果不是,请改为搜索客户评论。在这两种情况下,查找 'great' 一词。

自定义过滤条件自定义字段可以使用大多数函数,但无法使用一些数学函数,也不能使用引用其他行或数据透视列的函数。您可以通过 Looker 函数和运算符文档页面了解可以使用的函数。

您可以在表格计算中使用任何函数。您也可以在数据测试expression 参数中使用任何函数,因为 expression 参数本质上是一个表计算,进而得到“是”(布尔值)。