持續整合斷言驗證工具

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

您可以使用 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 驗證工具會顯示錯誤,如下所示:

持續整合結果頁面,顯示 Assert Validator 發現的結果

Assert Validator 選項

建立或編輯持續整合套件時,可以指定多種選項,設定 Assert Validator 的執行方式。本頁面以下各節將說明這些選項:

要查詢的探索

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

資料測試是使用 explore_source 參數定義,該參數會指向專案中的「探索」,您可以使用「Explores to query」(要查詢的探索) 欄位,將斷言驗證限制為資料測試所依據的特定探索。

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

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

如要進一步瞭解如何在這個欄位中指定探索和模型,請參閱 SQL 驗證器說明文件頁面。

要排除的探索

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

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

如要進一步瞭解如何在這個欄位中指定探索和模型,請參閱 SQL 驗證器說明文件頁面。

查詢並行數量

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

「查詢並行」欄位的值上限,取決於資料庫連線的「這個連線的並行查詢數量上限」設定。

如果在執行 Assert 驗證時發現 Looker 執行個體變慢,可以降低這個值。