MBQL 库变更日志

对用于操作 MBQL 查询的库 API 所做的更改，位于 metabase.lib.js。最新的 API 文档可以在 此处找到。

该库主要由 Metabase 自行前端使用，但它被视为一个正式的 API 表面，在此变更日志中进行了版本控制和记录。

Metabase 0.50.0

• 创建此文件并开始对此 API 进行版本控制。

• 新增了函数 as-returned。它处理在查询中添加聚合时，添加过滤器或表达式的棘手情况。

  假设我们的查询在最后一个阶段具有聚合。当向该阶段添加过滤器或表达式时，它会在聚合**之前**应用。这可能是期望的行为，但如果我们想要一个基于最后一个阶段的聚合和分组的过滤器或自定义表达式，则此 API 中没有很好的支持。

  as-returned 会查看查询和阶段，并在必要时移至后面的阶段。如果需要后面的阶段，但我们已经处于最后一个阶段，则会附加一个新的空阶段。

• 新增了函数 column-extractions、extract 和 extraction-expression。
  • column-extractions 返回一个 *提取* 列表，这些是我们可以从给定列派生的可能的自定义表达式。例如，从 URL 或电子邮件地址获取主机名或基本域名，或者从日期或日期时间获取星期几。
  • extract 将提取应用于查询。
  • extraction-expression 返回提取的表达式，允许进一步编辑。