驗證 LookML

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

如要執行完整的模型驗證，請使用 LookML 驗證器。有些錯誤 (例如因缺少聯結而導致的無效欄位參照) 需要全面檢查模型，因此只會在執行 LookML 驗證器時顯示。請務必先驗證 LookML 變更，再發布至正式環境。雖然驗證無法找出所有問題 (例如資料庫權限問題)，但可以避免大多數錯誤。

注意： 請勿將 LookML 驗證器與內容驗證器混淆，後者會檢查您所做的變更是否會導致任何已儲存的 Look 無法運作。

LookML 驗證器只會掃描上次 LookML 驗證後更新的 LookML 檔案，或受更新影響的檔案：

• 如果模型層級的設定有所變更，系統會再次驗證所有內容。
• 如果檢視區塊有變更，系統只會重新驗證使用該檢視區塊的探索。
• 如果探索內容有變更，系統只會重新驗證該探索內容。

提示： 如果發現 LookML 驗證需要很長時間才能完成，請先檢查模型檔案中的 include 參數。如果您納入所有檢視檔案 (include: "*.view")，LookML 驗證器就必須檢查所有檔案，這可能會影響效能。如果是這種情況，請更新模型檔案的 include 參數，只納入所需的檢視畫面檔案。

正在執行驗證

如要執行 LookML 驗證器，請選取 Looker IDE 右上方的「驗證 LookML」按鈕；或選取 IDE 頂端的「專案健康狀態」圖示，開啟「專案健康狀態」面板，然後按一下「驗證 LookML」圖示。

執行 LookML 驗證工具後，您可能會看到錯誤和其他警告清單，請務必解決這些問題。選取任一箭頭即可展開錯誤或警告清單。

如果您進行並儲存其他變更，「專案健康狀態」面板中的驗證器按鈕就會再次啟用。

驗證訊息

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

注意：啟用寬鬆本地化時，LookML 資訊主頁會在側欄中顯示資訊訊息，而非警告。

未發現任何 LookML 錯誤

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

LookML 錯誤

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

在展開的問題清單中，您會看到驗證未通過的原因。通常只要點選錯誤，系統就會直接將您帶往有問題的程式碼列。資料列旁會顯示紅色「X」。將滑鼠游標懸停在該欄上，有時會顯示更詳細的錯誤資訊：

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

LookML 警告

LookML 警告可能不會阻止查詢執行，但仍可能導致使用者無法正常使用或出現非預期功能。與錯誤一樣，括號中的數字代表找到的警告數量 (以下範例中有三項警告)：

與 LookML 錯誤一樣，您可以展開警告，然後選取「專案健康狀態」面板中的警告，並將滑鼠游標懸停在紅色 X 圖示上，即可查看更多資訊，並跳至問題程式碼：

部署變更

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

注意： 如果您變更 Look 或資訊主頁中做為篩選器的欄位名稱，請務必檢查已排程 Look 和資訊主頁的「篩選器」部分，並視需要更新篩選器，以反映變更。如果排定傳送的內容包含不再運作的篩選器 (例如參照的欄位已變更)，排定傳送的內容可能會顯示未經過濾的資料。