偏移

⚠️ 偏移（Offset）函数目前不适用于 MySQL/MariaDB、ClickHouse、MongoDB 和 Druid。

偏移（Offset）函数返回不同行中表达式的值。偏移（Offset）只能在查询构建器的“汇总”步骤中使用（您不能使用偏移（Offset）创建自定义列）。

语法：Offset(expression, rowOffset)

expression 是从不同行获取的值。

rowOffset 是相对于当前行的数字。例如，-1 表示上一行，1 表示下一行。

示例：Offset(Sum([Total]), -1) 将获取上一行中 Sum([Total]) 的值。

分组依据的顺序很重要

由于 Offset 引用其他行，因此分组依据的顺序很重要（分组依据是“汇总”步骤中“按…分组”部分中的组）。Metabase 将首先按第一个组排序，然后按任何其他分组进行分区。例如，如果您想查看按产品类别随时间变化的订单数量，以及上一期间按产品类别变化的订单数量，您应该首先按 创建时间 分组，然后按产品类别分组。

偏移量不考虑缺失数据

Offset 只能引用您拥有的行，这意味着它可能会产生正确但意想不到的结果。例如，假设您想将每个**天**的计数与前一天进行比较。

请看下表，其中 Previous 列由表达式 Offset(Count, -1) 创建

10月4日 Previous 列中的值为 3，这是前一行的值。虽然根据数据是正确的，但前一行是10月**2日**；没有10月3日（前**一天**）的数据。如果您想使用偏移量来比较前**几天**（或几周，或其他任何时间），您需要确保您的数据包含您想要比较的每个数据点的行。在这种情况下，您的数据需要包含每一天的行，包括计数为零的天。如果您的数据中缺少日期，您可以将日历表连接到您的数据中，以确保每一天都在您的数据中有一行。

数据类型

偏移（Offset）函数返回偏移行中的任何值。

使用 Offset 进行同比（YoY）时间序列比较示例

在示例数据库中，您可以使用 Offset 比较订单的同比（YoY）计数。

首先，按总和（Sum of Total）汇总。然后再次汇总该总和，这次使用 Offset 获取上一行的值。

Offset(Sum([Total]), -1)

然后按年份对结果进行 Created At 分组

结果为

有了这些偏移量（“上一期间”列中的总和），我们就可以创建自定义列来计算诸如年度总和之间的差异之类的数据

[Sum of total] - [Previous period]

以及每年的百分比变化

[Difference] / [Previous period] * 100

使用 Offset 的滚动平均示例

您可以使用带有 Offset 的自定义表达式来计算滚动平均值。

例如，假设您想计算过去三个月订单总额的滚动平均值。您可以创建一个自定义表达式来计算这些滚动平均值

(Sum([Total]) + Offset(Sum([Total]), -1) + Offset(Sum([Total]), -2)) / 3

上述表达式将当前期间的总额加上前两个期间的总额（偏移量为 -1 和 -2），然后除以三，以获得这些期间的平均值。

相关函数

SQL

偏移（Offset）函数与 SQL 的 LAG 和 LEAD 窗口函数类似。

例如，如果您尝试创建一个包含两个系列折线图，以比较 a) 本月订单计数与 b) 上月订单计数，您将 count 本月订单，然后使用 offset 表达式计算上月订单，如下所示

Offset(count, -1)

在底层，Metabase 会将 Offset 表达式转换为 LAG 窗口函数，就像这个查询一样

SELECT
  "source"."CREATED_AT" AS "CREATED_AT",
  COUNT(*) AS "count",
  LAG(COUNT(*), 1) OVER (

ORDER BY
      "source"."CREATED_AT" ASC
  ) AS "Order count previous period"
FROM
  (
    SELECT
      DATE_TRUNC('month', "PUBLIC"."ORDERS"."CREATED_AT") AS "CREATED_AT"
    FROM
      "PUBLIC"."ORDERS"
  ) AS "source"
GROUP BY
  "source"."CREATED_AT"
ORDER BY
  "source"."CREATED_AT" ASC

延伸阅读

• 自定义表达式文档
• 自定义表达式教程