MBQL库变更日志

对metabase.lib.js中发现的用于操作MBQL查询的库API所做的更改。最新的API文档可以在这里找到。

此库主要供 Metabase 的前端使用，但在此变更日志中被视为一个正确的 API 界面，具有版本和文档。

Metabase 0.50.0

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

• 新增了函数 as-returned。它处理向具有聚合的查询中添加过滤器或表达式时的复杂情况。

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

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

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