持續整合斷言驗證工具

持續整合 (CI) 斷言驗證工具會執行 Looker 開發人員在 LookML 專案中建立的 LookML 資料測試,並顯示每項資料測試的結果。如果資料測試失敗,斷言驗證工具會顯示錯誤。

您可以透過 LookML 資料測試驗證 Looker 模型的邏輯。資料測試可測試複雜的假設,例如:

  • 去年 5 月的收益應為 $204,259 美元。
  • 轉換率應大於零。
  • 訂單狀態不得為空值。

LookML 資料測試由小型 explore_source 查詢和 yesno 斷言運算式組成,如以下範例所示:

test: historic_revenue_is_accurate {
  explore_source: orders {
    column: total_revenue { field: orders.total_revenue }
    filters: [orders.created_date: "2024"]
  }
  assert: revenue_is_expected_value {
    expression: ${orders.total_revenue} = 626000 ;;
  }
}

如要進一步瞭解建立或編輯 CI 套件時可設定的選項,請參閱本頁的「斷言驗證器選項」一節。如要瞭解如何執行 Assert Validator,請參閱「執行持續整合套件」說明文件頁面。

執行結果頁面中,斷言驗證工具會顯示每項資料測試的結果。如果資料測試失敗,斷言驗證工具會顯示錯誤,如下所示:

顯示 Assert Validator 檢查結果的持續整合結果頁面

Assert Validator 選項

建立或編輯持續整合套件時,您可以指定多個選項來設定 Assert Validator 的執行方式。本頁的下列章節會說明這些選項:

要查詢的探索

根據預設,斷言驗證工具會執行 LookML 專案中的每個資料測試。

資料測試會使用指向專案中 Explore 的 explore_source 參數進行定義,您可以使用「Explores to query」欄位,將斷言驗證限制在資料測試所依據的特定 Explore。

您可以使用下列格式指定 Explore:model_name/explore_name

舉例來說,如要在 thelook.model.lkml 檔案中指定名為 usersorders 的探索,請輸入以下內容:thelook/users, thelook/orders

如要進一步瞭解如何在這個欄位中指定探索和模型,以及相關範例,請參閱 SQL Validator 說明文件頁面。

要排除的探索

根據預設,斷言驗證工具會執行 LookML 專案中的每個資料測試。您可以使用「要排除的探索」欄位,排除資料測試所依據的斷言驗證特定探索。Assert 驗證工具不會執行以這些排除的探索為依據的資料測試。

您可以使用下列格式指定探索:model_name/explore_name

如要進一步瞭解如何在這個欄位中指定探索和模型,以及相關範例,請參閱 SQL Validator 說明文件頁面。

查詢並行數量

根據預設,斷言驗證工具一次最多會執行 10 個查詢,以免 Looker 執行個體不堪負荷。您可以使用「查詢並行數」欄位,指定 Assert Validator 可同時執行的查詢數量上限。

「查詢並行性」欄位的最大值受限於資料庫連線的「這個連線的並行查詢數量上限」設定。

如果您在執行斷言驗證時,發現 Looker 執行個體速度變慢,可以降低這個值。