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 傳回擷取的表達式，允許進一步編輯。