LookML 物件中繼資料

擁有 develop 權限的使用者,可以在 Looker IDE 中繼資料面板中查看與物件相關的相關資訊。

如要在 Looker IDE 中查看中繼資料面板,請按照下列步驟操作:

  1. 前往專案檔案
  2. 如要開啟快速說明面板,請選取「快速說明」圖示
  3. 在 LookML 程式碼編輯器中,將游標移至中繼資料面板中您想進一步瞭解的物件。
  4. 在快速說明面板中,選取「中繼資料」分頁標籤,開啟中繼資料面板。

中繼資料面板會使用名稱和代表物件類型的圖示來識別物件 (如要瞭解所有可能的物件類型圖示,請參閱「使用物件瀏覽器面板瀏覽專案」說明文件頁面)。

如果 LookML 物件用於多個模型,中繼資料面板會提供下拉式選單,讓您選取要查看中繼資料的模型。

中繼資料面板中顯示的資訊取決於所選 LookML 物件類型,以及所選物件在專案中的使用方式。您可以使用中繼資料,進一步瞭解專案的各個面向,如以下各節所述。

模型的中繼資料

如果您選取模型檔案,中繼資料面板會顯示下列部分:

  • 資訊主頁:列出模型中包含的所有 LookML 資訊主頁,並提供 LookML 專案中定義的連結
  • 「探索」:列出模型中包含的所有「探索」,並提供 LookML 專案中定義的連結
  • Views:列出模型中包含的任何 View,並提供 LookML 專案中定義的連結

每個區段的標題也會顯示各類型物件的數量。

檢視畫面中繼資料

如果您選取檢視參數,中繼資料面板會顯示以下資訊,說明檢視畫面在專案中的使用方式:

  1. 檢視畫面名稱和詳細資料:檢視畫面名稱和代表檢視畫面物件類型的圖示 (如要查看所有可能的物件類型圖示,請參閱「使用物件瀏覽器面板瀏覽專案」說明文件)。中繼資料面板也會提供檔案名稱,以及檔案 LookML 中定義檢視畫面的行號 (以及專案中檢視畫面的連結)。
  2. 「Used in [number] models」選單:顯示包含此檢視畫面的型錄清單,其中 [number] 代表包含此檢視畫面的型錄數量。舉例來說,如果某個檢視畫面在兩個模型中使用,中繼資料面板就會顯示「Used in 2 models」文字。
  3. 主鍵:檢視畫面的主鍵
  4. 基本檢視表:使用此檢視表做為基本檢視表的探索。
  5. 已加入:探索這個檢視畫面已加入哪些檢視畫面。

如果檢視畫面含有擴充功能精緻化,這些項目也會顯示在中繼資料面板中。

探索的中繼資料

如果您選取 explore 參數,中繼資料面板會顯示以下資訊,說明 Explore 在專案中使用的情形:

  1. 「探索」名稱和詳細資料:代表物件類型的「探索」名稱和圖示 (如要瞭解所有可能的物件類型圖示,請參閱「使用物件瀏覽器面板瀏覽專案」說明文件)。中繼資料面板也會提供檔案名稱,以及檔案 LookML 中定義探索的列號 (以及專案中探索的連結)。
  2. 基本檢視畫面:探索的基本檢視畫面 (用於建立探索的起點)。
  3. 已彙整的檢視畫面:已彙整至基礎檢視畫面的其他檢視畫面。

如果探索包含擴充資料精緻資料,這些資料也會顯示在中繼資料面板中。

欄位中繼資料

如果您選取欄位,中繼資料面板會顯示以下資訊,說明該欄位在專案中的使用方式:

  1. 欄位名稱和詳細資料:欄位名稱和代表其物件類型的圖示 (如要查看所有可能的物件類型圖示,請參閱「使用物件瀏覽器面板瀏覽專案」說明文件)。除了顯示欄位類型,這個面板也會提供檔案名稱,以及檔案 LookML 中定義欄位的行號 (以及專案中欄位的連結)。
  2. Used in [number] models 選單:顯示包含此欄位檢視的模型清單。
  3. 位於下列檢視表:使用這個欄位的檢視表。

擴充功能的中繼資料

在 LookML 程式碼編輯器中選取 viewexplore 參數時,「中繼資料」面板的「Extended by」部分會顯示該物件的所有擴充功能

舉例來說,請考慮下列 LookML 程式碼範例,其中 aircraft_extended Explore 會擴充 aircraft Explore:

explore: aircraft {
  view_name: aircraft
  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

如果您為 aircraft Explore 選取 LookML 定義,中繼資料面板會在「Extended by」部分列出 aircraft_extended。按一下「Extended by」部分中的連結,直接前往定義 aircraft_extended 的 LookML。

如果您在 aircraft_extended Explore 的定義中點選,中繼資料面板會提供下列有關擴充 aircraft Explore 的資訊:

  • 已彙整的檢視畫面:列出已彙整至 aircraft「探索」的所有檢視畫面。
  • 擴展:列出所選探索功能擴展的物件。在本例中,這是 aircraft 探索。

在這些範例中,擴充和擴充的 explore 參數在同一個檔案中彼此相鄰,但這並非一律如此。您無法從參數中判斷是否已擴充,尤其是因為擴充和擴充物件可能位於不同的 LookML 檔案中。中繼資料面板會提供相關物件的背景資訊,無論物件定義在何處皆然。

精修的中繼資料

中繼資料面板可讓您輕鬆查看檢視畫面或探索是否已將精緻化新增至物件。中繼資料面板的「精修」部分會顯示已新增至物件的精修次數,您可以使用連結前往每個精修的 LookML。

與擴充功能一樣,您無法只透過 LookML 判斷物件是否已精細化,尤其是精細化 LookML 可能位於其他檔案中。您可以透過中繼資料面板查看物件是否已經過精緻化,如果有,您可以直接前往 LookML 進行精緻化。

匯入專案的中繼資料

中繼資料面板包含匯入專案中的物件相關資訊,包括連結,可前往定義物件的匯入檔案。舉例來說,如果選取以匯入的檢視畫面檔案為基礎的探索,LookML 就會在「中繼資料」面板中顯示匯入的檢視畫面檔案資訊。

您可以從中繼資料面板中點選連結,前往已匯入檔案中定義物件的部分。

此外,您也可以在 IDE 檔案瀏覽器中,按一下匯入的專案資料夾中的物件,查看匯入檔案的中繼資料。