Content Validator 會在 LookML 中搜尋 Looker 內容 (Look 圖表和資訊主頁) 中參照的模型、探索和欄位名稱。這項工具可用於驗證 LookML 參照項目、修正 LookML 中的錯誤，以及更新專案中的 LookML 元素名稱。
您必須具備 develop 權限，才能使用內容驗證工具。內容驗證工具會針對您具有 develop 權限的 LookML 專案，驗證所有以該專案為基礎的內容。
如要開啟內容驗證工具，請在主要導覽面板中，從「開發」選單中選取「內容驗證工具」。接著，您可以透過下列兩種方式使用內容驗證工具：
- 按一下「驗證」，即可找出並修正 LookML 模型變更所造成的錯誤。
- 點選「在所有內容中尋找並取代」，即可在 Looker 內容中尋找並取代模型、探索或欄位名稱，無論 Looker 內容是否有錯誤皆可使用此功能。
使用內容驗證工具前的準備
使用內容驗證功能進行變更時，請務必非常小心。內容驗證工具沒有復原功能，且可能會影響許多外觀和資訊主頁，以及這些資訊主頁的「從這裡探索」連結。如果不小心犯錯，請盡快修正，以免其他變更導致受影響的 Look 更難區隔。
此外，請考量使用內容驗證工具的時機。將開發變更推送至正式版時，請盡量同時修正受影響的樣式和圖塊，以便縮短服務中斷的時間。如果您過早修正 Look 和圖塊，根據您在開發模式中的工作，這些項目會向使用者顯示為損毀，直到您推送變更為止。同樣地，如果您在推送變更後，遲遲未修正外觀和資訊方塊，使用者就會看到外觀和資訊方塊無法正常運作，直到您修正為止。
使用內容驗證工具修正錯誤
內容驗證工具是一項實用工具，可找出並修正 LookML 變更後產生的錯誤。舉例來說，如果您將欄位名稱從 customer 變更為 user，包含 customer 欄位的任何 Look 或資訊主頁資訊方塊都會停止運作 (除非您使用 alias 參數)。內容驗證工具會列出任何參照 customer 欄位的項目，並提供「Replace」或「Remove」按鈕，以便修正錯誤。
執行 Content Validator 時，系統會驗證 Look 和資訊主頁對 LookML 模型、探索、檢視畫面和欄位的所有參照，並針對內容對不明 LookML 物件的任何參照顯示錯誤。
針對以下情況，Content Validator 不會顯示錯誤：
- 已刪除並位於「垃圾桶」中的 Look。如要驗證已刪除的 Look，Looker 管理員必須先還原 Look。
您沒有
develop權限的 LookML 模型內容。您只能在具有develop權限的模型 (可在 Looker IDE 中查看的模型) 上使用內容驗證工具。如要瞭解模型權限，請參閱「角色」說明頁面。
執行內容驗證工具
執行 Content Validator 時，您可以將驗證範圍限定在特定 LookML 專案和特定內容資料夾 (包括任何子資料夾)。這有助於提升內容驗證工具的效能。
請注意下列 Content Validator 範圍設定事項：
- 如果您未指定資料夾或 LookML 專案，驗證作業就不會設有範圍。內容驗證工具會驗證所有以您擁有
develop權限的模型為基礎的內容。 - 如果您指定內容資料夾，Content Validator 會對內容資料夾和所有子資料夾 (如果有的話) 執行驗證。
- 如果您指定內容資料夾和一或多個 LookML 專案，系統會套用這兩種條件：內容驗證工具會將驗證範圍限制在您所選 LookML 專案的資料夾 (和子資料夾) 內的內容。
- 資訊主頁快訊、資訊主頁排程和 Look 排程不會儲存在內容資料夾中。因此，如果您將內容驗證範圍限定為資料夾，Content Validator 就不會驗證任何排程或快訊。
如果您指定 LookML 專案，內容驗證工具會查看指定專案的原始 LookML，以及為每個專案設定的模型，藉此判斷專案的相關聯模型。您可以在「LookML 專案」頁面查看這些模型。如果 LookML 專案中的模型檔案已刪除，且在「LookML 專案」頁面上未顯示為專案中的模型，內容驗證工具就不會顯示與該已刪除模型相關的內容錯誤。
如要執行內容驗證工具，請按照下列步驟操作：
- 按一下 Looker 的「主選單」圖示，然後選取「Develop」(如果系統尚未顯示「Develop」選單)。
- 在「Develop」選單中，選取「Content Validator」。
在「Content Validator」(內容驗證工具) 頁面上，按一下「Validate」(驗證)。
內容驗證工具會顯示「Choose Projects to Validate」對話方塊。
在「Choose Projects to Validate」對話方塊中，執行下列任一操作：
- 如要在所有 LookML 專案上執行驗證工具，請保留「Select projects」欄位，不選取任何專案，然後按一下「Next」。
- 如要在一或多個特定 LookML 專案上執行驗證工具，請按一下「Select projects」下拉式選單，選取要驗證的專案，然後按一下「Next」。
內容驗證工具會顯示「Choose Folder to Validate」對話方塊。
在「Choose Folder to Validate」對話方塊中，執行下列其中一項操作：
- 如要對所有內容資料夾執行驗證工具，請保留「資料夾」挑選器的現有狀態 (未選取任何資料夾)，然後按一下「下一步」。
- 如要在特定內容資料夾 (以及任何子資料夾) 上執行驗證工具，請使用「資料夾」挑選工具選取要驗證的資料夾，然後按一下「下一步」。
「Review Selections」對話方塊會顯示您選取用於驗證的專案和資料夾。
在「Review Selections」對話方塊中，按一下「Validate」。
Content Validator 會針對您指定的內容執行驗證，然後顯示結果。如要瞭解如何查看結果，請參閱「查看內容驗證結果」一節。
查看內容驗證結果
Content Validator 完成驗證後，會顯示錯誤表格。驗證結果的範圍會限於您執行 Content Validator 時選取的專案和資料夾。
內容驗證結果會顯示 Looker 內容使用不存在或無法找到的模型名稱、探索名稱、檢視名稱或欄位名稱。如要進一步瞭解 Content Validator 可找出及驗證的 LookML 元素，請參閱「使用 Content Validator 修正錯誤」一節。
驗證結果會根據您在執行驗證工具時所處的模式中可用的 LookML 而定。如果您處於正式環境模式，驗證結果會反映已推送至正式環境的所有 LookML。如果您處於開發模式，驗證結果會反映已儲存的 LookML，即使 LookML 尚未推送至正式環境也一樣。
錯誤表格會顯示每項錯誤，以及包含錯誤的 Look 和圖塊清單，以及產生錯誤的基礎模型和 Explore。
您可以使用頁面右上方的「依據」分頁標籤，變更錯誤表格的版面配置：
- 錯誤：列出每個錯誤，並將發生錯誤的 Looker 內容分組。如果想一次修正多個內容中的相同錯誤，這個方法就很實用。
- 資料夾：列出每個資料夾，並將 Looker 內容分組，以便顯示錯誤。如果您只想修正特定資料夾中的錯誤，這項功能就很實用。
- 內容：列出每個含有錯誤的內容，並將錯誤分組。如果你想修正單一外觀、圖塊、篩選器等中的所有錯誤，這個選項就很實用。
：資訊主頁方塊
：資訊主頁快訊
：資訊主頁或 Look 的排程
：資訊主頁篩選器，或可監聽資訊主頁篩選器的資訊方塊欄位 (如要瞭解如何設定資訊方塊以監聽資訊主頁篩選器，請參閱新增及編輯使用者定義的資訊主頁篩選器說明文件)
除了 LookML 中的刻意變更，錯誤也可能來自拼寫錯誤或缺少的彙整。
視錯誤類型而定，Looker 會針對每個資料列提供「Replace」按鈕或「Remove」按鈕，或兩者皆有。這些按鈕提供修正錯誤的功能，詳情請參閱「使用內容驗證工具修正錯誤」一文。如要調整錯誤，您可以使用錯誤表格每行中的「Replace」和「Remove」按鈕，如下所示：
- Replace：Looker 會為每個錯誤提供「Replace」按鈕 (如要瞭解如何使用內容驗證工具替換名稱，請參閱本頁後續的「替換欄位、檢視畫面、探索和模型的名稱」一節)。
- 移除：如果 Look 或資訊方塊的「資料」部分出現欄位名稱錯誤，Looker 也會顯示「移除」按鈕 (如要瞭解如何使用內容驗證工具移除名稱，請參閱本頁後半部的「移除欄位名稱」一節)。
視「依據以下項目分組」設定而定，「取代」和「移除」按鈕會套用至單一項目 (外觀或資訊方塊)，或是多個項目：
- 如果您依「錯誤」分組，這些按鈕會套用至 Looker 執行個體中所有 Look 和圖塊的該錯誤所有出現情形，讓您在單一作業中修正所有錯誤。
- 如果您依「資料夾」或「內容」分組，這些按鈕會套用至單一 Look 或資訊方塊中出現的錯誤，讓您分別處理每個錯誤。
舉例來說，錯誤表格會依「錯誤」分組，並顯示三個內容例項，其中包含名為 customers 的不明探索。系統為這三項內容提供的動作是「取代」。按一下「Replace」會影響所有三個含有錯誤 3 x Unknown explore 'customers' 的內容例項。
在某些情況下，某些內容可能會出現多項錯誤。舉例來說，錯誤表格會依「內容」分組，並顯示名為「訂單詳細資料」的內容。「Errors」欄會顯示四個 Unknown field 錯誤，每個錯誤都有自己的「Actions」欄中的「Replace」和「Remove」動作按鈕。
此外，如果您依內容分組，還可以選擇刪除外觀。
取代欄位、檢視畫面、探索和模型的名稱
內容驗證結果會為下列元素類型提供「Replace」按鈕，方便您重新命名：
- Look 和資訊主頁方塊中的模型名稱
- 探索 Look 和資訊主頁方塊中的名稱
- 查看自訂篩選器或表格計算式中的名稱
- 在 Look 和資訊主頁資訊方塊中查看名稱
- 欄位名稱：
- 在 Look 的「資料」部分
- 在以查詢為依據的資訊主頁資訊方塊中
- 在資料表計算中參照
- 在自訂篩選器中參照
- 在自訂欄位中參照
- 在視覺化呈現設定中引用，例如柱狀圖的「系列」分頁中的「自訂」區域
- 資訊主頁資訊方塊參照此元素，以監聽資訊主頁篩選器 (這項設定會在篩選器設定視窗的「要更新的資訊方塊」分頁中設定，詳情請參閱新增及編輯使用者定義的資訊主頁篩選器說明文件)
如有任何這類錯誤，您可以使用內容驗證工具，將內容的屬性替換為等同或更為一般化的屬性，例如：
- 如果欄位導致錯誤，您可以替換或移除該欄位，也可以替換檢視畫面、探索或模型名稱。
- 如果探索名稱導致錯誤，您可以替換探索名稱或模型名稱。
- 如果模型名稱導致錯誤，您可以更換模型名稱。
以下說明如何使用內容驗證工具，取代模型中的元素名稱：
- 按一下「驗證」，執行內容驗證工具。
- 選取「Group by」設定，選擇錯誤的分組方式。舉例來說，您可以依「錯誤」分組，以便同時調整多個項目。
在錯誤表格中，按一下要修正的錯誤旁邊的「Replace」按鈕，開啟「Update in Content」對話方塊。
在「更新內容」對話方塊的「類型」部分，選取要變更的 LookML 元素類型：欄位、檢視畫面、探索或模型。Looker 會針對每個錯誤顯示適當的選項。
在「Name」部分，確認要取代的項目名稱。Content Validator 會自動填入這項資訊。
在「Replacement Name」部分中，輸入項目的新名稱。
如果您依「錯誤」分組，且有多個項目會受到影響，請按一下「顯示內容」，查看內容驗證工具會更新的項目清單。
您也可以清除清單中任何項目旁的核取方塊，讓名稱保持不變。
如要進行變更，請按一下「取代」。
移除欄位名稱
如果 Look 或資訊方塊的「資料」部分出現錯誤，錯誤表格會在錯誤右側提供「移除」按鈕。您可以使用內容驗證工具移除下列欄位：
- 在 Look 或資訊主頁圖塊的「資料」部分
- 在視覺化呈現設定中引用，例如柱狀圖的「系列」分頁中的「自訂」區域
- 資訊主頁資訊方塊參照此元素，以監聽資訊主頁篩選器 (這項設定會在篩選器設定視窗的「要更新的資訊方塊」分頁中設定，詳情請參閱新增及編輯使用者定義的資訊主頁篩選器說明文件)
您無法使用內容驗證工具從自訂篩選器、自訂欄位或表格計算式中移除欄位，因為通常您需要進行額外變更才能讓運算式正常運作。請改為使用內容驗證錯誤訊息，找出需要修正自訂篩選器、自訂欄位和表格計算式運算式的部分，然後視需要重新調整運算式。
- 按一下「驗證」，執行內容驗證工具。
- 選取「Group by」設定，選擇錯誤的分組方式。舉例來說，您可以依「錯誤」分組，這樣就能同時調整多個項目 (外觀、圖塊或兩者皆是)。
在錯誤表格中，按一下要修正的欄位錯誤旁的「移除」，開啟「從內容中移除欄位」對話方塊。
在「Remove Field from Content」對話方塊的「Field」部分，確認要移除的項目名稱。Content Validator 會自動填入這項資訊。
如果您已依「錯誤」分組，且有多個項目 (外觀、圖塊或兩者皆有)，請按一下「顯示內容」，查看內容驗證工具會更新的項目清單。
您也可以清除任何外觀或圖塊旁的核取方塊，讓名稱保持不變。
按一下「移除欄位」即可進行變更。
刪除 Look
如果您依「內容」分組錯誤表格，可以選擇刪除表格中的外觀。
如何使用內容驗證工具刪除造型：
- 按一下「驗證」，執行內容驗證工具。
- 依「內容」分組表格。
- 在錯誤表格中，按一下要刪除的造型或造型集旁邊的「選取」方塊。
- 按一下錯誤表格頂端的「刪除所有所選外觀」按鈕。
- 在確認方塊中按一下「OK」，即可刪除所選造型或造型集。
使用內容驗證工具尋找並取代
您也可以使用 Content Validator 搜尋及取代模型、探索和欄位的名稱。舉例來說，您可能會決定偏好某個欄位，並且想要在專案中進行替換，即使沒有錯誤也一樣。如要查看 Content Validator 可搜尋及取代的完整元素清單，請參閱「替換欄位、檢視畫面、探索和模型的名稱」一節。
如何使用內容驗證工具做為尋找及取代工具：
- 在「Content Validator」畫面上，按一下「Find & Replace in All Content」，開啟「Update in Content」對話方塊。
- 選取要變更的 LookML 元素類型 (欄位、檢視、探索或模型)。
- 輸入要取代的項目名稱。
- 輸入欄位、檢視畫面、探索或模型的替換名稱。
- 按一下「取代」進行變更。
注意事項
請重新執行內容驗證，查看修正結果。
請注意下列內容驗證工具的相關事項：
- 您可以變更檢視畫面、探索或模型的名稱，但無法完全移除名稱。如要瞭解可透過內容驗證工具移除的項目清單，請參閱「移除欄位名稱」一節。
- 表格運算式只能參照 Look 或資訊方塊查詢中包含的欄位。也就是說，如果您從 Look 或資訊方塊的查詢中移除欄位，但表格運算仍使用該欄位，就會收到新的內容驗證錯誤。
- 系統不會驗證已刪除並位於「垃圾桶」資料夾中的 Look。如要驗證已刪除的 Look，Looker 管理員必須先還原 Look。
- 如果您處於開發模式，驗證結果會反映已儲存的 LookML，即使尚未推送至正式環境也一樣。不過，您使用內容驗證工具所做的任何變更，都會影響使用者在正式版模式下觀看內容時的體驗。建議您在執行內容驗證工具前，先切換至正式版模式。