驗證 LookML

編輯 LookML 時,Looker IDE 會針對單一檔案中未解決的語法錯誤發出警示 (請參閱 Looker IDE 總覽說明文件頁面)。

如要執行完整的模型驗證,請使用 LookML Validator。有些錯誤 (例如因缺少彙整而導致的無效欄位參照) 需要從整體角度檢視模型,因此只有在執行 LookML 驗證工具時才會顯示。請務必先驗證 LookML 變更內容,再發布至正式環境。雖然驗證無法找出所有問題 (例如資料庫權限問題),但可以避免大部分的錯誤。

LookML 驗證工具只會掃描自上次 LookML 驗證後更新的 LookML 檔案,或是受更新影響的檔案:

  • 如果模型層級設定有變更,系統會再次驗證所有內容。
  • 如果檢視畫面發生變更,系統只會重新驗證使用該檢視畫面的探索。
  • 如果「探索」內容有所變更,系統只會再次驗證該項內容。

執行驗證

如要執行 LookML 驗證工具,請選取 Looker IDE 右上方的「Validate LookML」按鈕;或者選取 IDE 頂端的「Project Health」圖示,開啟「Project Health」面板,然後按一下「Validate LookML」圖示。

執行 LookML 驗證工具後,您可能會看到一份清單,列出需要解決的錯誤和其他警告。您可以選取任何箭頭,展開錯誤或警告清單。

只要您做出並儲存其他變更,專案健康狀況面板中的驗證器按鈕就會再次顯示。

驗證訊息

Looker 會在對 LookML 執行驗證後顯示驗證訊息。

沒有發現任何 LookML 錯誤

如果驗證工具未發現任何問題,Looker 會顯示綠色勾號,並顯示「沒有找到任何 LookML 錯誤」文字。

LookML 錯誤

LookML 錯誤是可能導致查詢無法執行的問題。括號內的數字是所發現的錯誤數量 (在下方範例中為九個):

驗證訊息示例,其中包含文字 LookML 錯誤 (9)。

在展開的問題清單中,您會看到驗證未通過的原因。通常只要點選錯誤,系統就會直接帶您前往有問題的程式碼行。資料列旁邊會顯示紅色的「X」。在某些情況下,將滑鼠游標懸停在該欄上,即可取得更詳細的錯誤資訊:

範例:當游標懸停在沒有值的類型參數定義上時,系統會顯示錯誤訊息,指出您必須提供類型值。

即時通訊團隊提示:我們最常收到的驗證錯誤是「不明或無法存取的欄位」。請參閱「錯誤:不明或無法存取的欄位」最佳做法頁面,瞭解原因和解決方法。

LookML 警告

LookML 警告可能不會阻止查詢執行,但仍可能導致使用者無法使用某些功能或出現意料之外的功能。與錯誤一樣,括號中的數字代表找到的警告數量 (以下範例中有三個警告):

範例:驗證訊息,其中包含「LookML 警告 (3)」文字。

如同 LookML 錯誤,您可以選取「Project Health」面板中的警告,然後將滑鼠游標懸停在紅色「X」圖示上,即可查看更多資訊,並展開警告並跳至問題代碼:

警告範例:文字指出探索必須與檢視表名稱相符,或是探索必須具有 from 或 view_name 屬性。

部署變更

確認變更能正常運作後,您可以使用 Looker 的 Git 整合功能,將變更提交並部署至實際環境