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