持續整合 (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 的執行方式。本頁的下列章節會說明這些選項:
要查詢的探索
根據預設,斷言驗證工具會執行 LookML 專案中的每個資料測試。
資料測試會使用指向專案中 Explore 的 explore_source
參數進行定義,您可以使用「Explores to query」欄位,將斷言驗證限制在資料測試所依據的特定 Explore。
您可以使用下列格式指定 Explore:model_name/explore_name
舉例來說,如要在 thelook.model.lkml
檔案中指定名為 users
和 orders
的探索,請輸入以下內容:thelook/users, thelook/orders
如要進一步瞭解如何在這個欄位中指定探索和模型,以及相關範例,請參閱 SQL Validator 說明文件頁面。
要排除的探索
根據預設,斷言驗證工具會執行 LookML 專案中的每個資料測試。您可以使用「要排除的探索」欄位,排除資料測試所依據的斷言驗證特定探索。Assert 驗證工具不會執行以這些排除的探索為依據的資料測試。
您可以使用下列格式指定探索:model_name/explore_name
如要進一步瞭解如何在這個欄位中指定探索和模型,以及相關範例,請參閱 SQL Validator 說明文件頁面。
查詢並行數量
根據預設,斷言驗證工具一次最多會執行 10 個查詢,以免 Looker 執行個體不堪負荷。您可以使用「查詢並行數」欄位,指定 Assert Validator 可同時執行的查詢數量上限。
「查詢並行性」欄位的最大值受限於資料庫連線的「這個連線的並行查詢數量上限」設定。
如果您在執行斷言驗證時,發現 Looker 執行個體速度變慢,可以降低這個值。