MBQL 库更新日志

在 metabase.lib.js 中用于操作 MBQL 查询的库 API 所做的更改。最新的 API 文档可在此处查看：https://metabase-dev-docs.github.io/metabase/metabase.lib.js.html。

此库主要由 Metabase 自己的前端使用，但它被视为一个正式的 API 接口，并在此更新日志中进行版本控制和文档记录。

Metabase 0.50.0

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

• 新增函数 as-returned。它处理在向聚合查询添加筛选器或表达式时的一个棘手情况。

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

  as-returned 会查看查询和阶段，并在必要时切换到后续阶段。如果需要后续阶段而我们已在最后阶段，则会追加一个新的空阶段。

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