對於所有開發人員都在 Looker IDE 中工作的 LookML 專案,系統會在將專案部署至實際工作環境的過程中,內建LookML 驗證功能。不過,如果 LookML 專案中部分或所有開發人員都在 Looker IDE 外工作,使用 VSCode 或 Vim 等外部 IDE 編寫 LookML,則可以將專案部署至實際工作環境,而無須驗證 LookML 語法。在這種情況下,您可以執行持續整合 (CI) LookML 驗證工具,找出 LookML 的語法問題,例如缺少 }
或無效的 ${}
參照。
如要進一步瞭解建立或編輯 CI 套件時可設定的選項,請參閱本頁的「LookML 驗證器選項」一節。如要瞭解如何執行 LookML 驗證工具,請參閱「執行持續整合套件」說明文件頁面。
在執行結果頁面中,LookML 驗證工具會提供專案中的 LookML 錯誤,以及 LookML 的連結:
LookML Validator 選項
以下各節說明執行 LookML 驗證工具的選項:
設定嚴重性門檻
嚴重性等級設定會決定 LookML 訊息的最低嚴重性等級,如果達到這個等級,持續整合執行作業就會在「持續整合執行作業」頁面和「持續整合執行作業結果」頁面顯示「失敗」持續整合狀態。
在 Looker IDE 中,LookML 驗證會傳回三種嚴重性等級的語法訊息:資訊、警告和錯誤。
根據預設,只有在 LookML 驗證工具在 LookML 專案中找到 LookML 警告或錯誤時,才會導致 CI 狀態為「失敗」。您可以選取 CI LookML 驗證工具應傳回「失敗」結果的最低層級訊息嚴重性:
- 錯誤:如果 LookML 驗證程序傳回錯誤訊息,CI LookML 驗證工具就會傳回「失敗」結果。
- 警告:如果 LookML 驗證結果為警告或錯誤訊息,CI LookML 驗證工具會傳回「失敗」結果。
- 資訊:如果 LookML 驗證結果傳回資訊、警告或錯誤訊息,CI LookML 驗證工具就會傳回「失敗」結果。
這項嚴重性門檻只會影響 CI 執行狀態值。無論嚴重程度設定為何,LookML 驗證工具的結果都會在 CI 執行結果頁面上顯示所有語法問題和 LookML 語法訊息。
逾時
您可以指定 CI LookML 驗證工具應執行的秒數 (預設為 600 秒)。如果 CI LookML 驗證工具的執行時間超過逾時時間,驗證程序就會放棄工作,並傳回「Error」執行狀態。