持續整合 (CI) 內容驗證工具可找出有錯誤的資訊主頁和外觀。這些錯誤通常是因為缺少 LookML 欄位參照所致。
CI 內容驗證工具的驗證方式與 標準 Looker 內容驗證工具類似,但仍有些差異:
CI 內容驗證工具支援下列功能:
- 您可以設定 CI 內容驗證工具,在 Looker 開發人員向 LookML 存放區提交提取要求時自動執行,或是在手動執行 CI 套件時手動執行。
- 您可以將 CI Content Validator 結果的範圍限定在特定 Looker 內容資料夾,或是 LookML 專案中的特定模型和探索。根據預設,CI 內容驗證工具的結果會自動套用至 LookML 專案。CI 內容驗證工具的範圍是後置處理:驗證工具會在整個 Looker 例項上執行,然後將結果篩選為您在建立 CI 套件時指定的範圍。
標準 Looker 內容驗證工具支援下列功能:
- 您只能手動執行 Looker 內容驗證工具。
- 您可以將 Looker 內容驗證工具的範圍限定在特定 Looker 內容資料夾,或特定 LookML 專案。Looker Content Validator 會在驗證前設定範圍:驗證工具只會針對您在啟動內容驗證時指定的資料夾和專案執行。
- 您可以使用 Looker 內容驗證工具替換欄位、檢視畫面、探索和模型的名稱、移除欄位,以及刪除 Look 圖表。
如要進一步瞭解建立或編輯 CI 套件時可設定的選項,請參閱本頁的「內容驗證工具選項」一節。如要瞭解如何執行內容驗證工具,請參閱「執行持續整合套件」說明文件頁面。
在執行結果頁面中,內容驗證工具會針對每個錯誤的 Look 或資訊主頁提供錯誤訊息,以及內容的連結:
Content Validator 選項
建立持續整合套件時,您可以指定多個選項,用於設定內容驗證工具的執行方式。本頁的下列章節會說明這些選項:
要查詢的探索
根據預設,Content Validator 會對 LookML 專案中的所有模型和探索執行內容驗證。
您可以使用「要查詢的探索」欄位,指定要納入內容驗證程序的探索和模型。
您可以使用下列格式指定 Explore:model_name/explore_name
舉例來說,如要在 thelook.model.lkml
檔案中指定名為 users
和 orders
的探索,請輸入以下內容:thelook/users, thelook/orders
如要進一步瞭解如何在這個欄位中指定探索和模型,以及相關範例,請參閱 SQL Validator 說明文件頁面。
要排除的探索
根據預設,Content Validator 會對 LookML 專案中的所有模型和探索執行內容驗證。
您可以使用「要排除的探索」欄位,指定要從內容驗證中排除的探索和模型。
您可以使用下列格式指定探索:model_name/explore_name
如要進一步瞭解如何在這個欄位中指定探索和模型,以及相關範例,請參閱 SQL Validator 說明文件頁面。
要驗證的資料夾
您可以指定資料夾 ID 或以半形逗號分隔的資料夾 ID 清單,將內容驗證範圍限定在 Looker 執行個體的特定內容資料夾。
如要取得資料夾 ID,請使用 Looker 主導覽選單開啟資料夾,然後從瀏覽器網址取得資料夾 ID。資料夾 ID 是網址的最後一個元素。例如在下列網址中,資料夾 ID 為 45
:
https://myinstance.looker.com/folders/45
要排除的資料夾
您可以在「要排除的資料夾」欄位中指定資料夾 ID 或以半形逗號分隔的資料夾 ID 清單,藉此從內容驗證中排除特定內容資料夾。
排除個人資料夾中的內容
如果您希望 Content Validator 只驗證共用資料夾中的內容,請啟用「排除個人資料夾中的內容」欄位。啟用「Exclude content in personal folders」欄位後,Content Validator 就會忽略 Looker 執行個體中個人資料夾中的內容。
漸進式驗證
您可以透過「漸進式驗證」這個方法,找出專屬於特定開發分支版本、不存在於正式環境的錯誤。開發人員可以透過漸進式驗證,找出並修正自己負責的錯誤,不必分心處理專案中現有的錯誤,而且驗證速度也會更快,特別是針對包含多個探索的 LookML 專案。
在驗證工具結果中,內容驗證工具會指出每個 Explore 都已略過,因為在驗證的分支或修訂版本中,這些 Explore 的編譯 SQL 並未有所變更。如需逐步驗證結果的範例,請參閱「查看逐步驗證結果」一文。
建立或編輯持續整合套件時,您可以選取「Content Validator」部分中的「Only incremental errors」核取方塊,為「Content Validator」啟用逐步驗證功能。
請注意下列增量驗證事項:
- 驗證正式環境分支版本本身時 (例如在正式環境分支版本中手動執行),漸進式驗證設定不適用。驗證正式環境分支版本時,Content Validator 會顯示完整的結果驗證。
內容驗證功能的限制
如果您刪除模型或變更模型名稱,Content Validator 就不會傳回這些「懸而未決」的內容錯誤,因為模型無法再與正在測試的專案建立關聯。