MBQL 库变更日志

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

此库主要由 Metabase 自己的前端使用,但它被视为一个合适的 API 表面,在这个变更日志中进行版本控制和记录。

Metabase 0.50.0

  • 创建此文件并开始对此 API 进行版本控制。
  • 添加了新函数 as-returned。它处理在向带有聚合的查询添加筛选器或表达式时的棘手情况。

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

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

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

阅读其他版本的 Metabase 文档。