使用物件瀏覽器面板瀏覽專案

Looker IDE 中的物件瀏覽器面板可讓您在同一個位置查看專案中的所有物件,以及這些物件之間的階層關係。這項功能可讓您透過檔案或資料夾瀏覽專案,是實用的替代方案。

查看專案中的物件

物件瀏覽器面板會顯示專案中定義的模型、探索、檢視畫面和欄位,以及物件階層和每個物件的類型。如果專案也包含匯入的檔案,請參閱本頁稍後的部分,進一步瞭解如何查看這些物件

如要使用物件瀏覽器面板,請按一下 IDE 導覽列中的「Object Browser」圖示

物件瀏覽器面板會依類型分組物件,且物件會依各類型中的字母順序排序。您可以使用物件瀏覽器面板,透過展開或收合物件來顯示或隱藏物件的階層。

您可以收合和展開模型、探索和檢視畫面,以顯示或隱藏其中包含的物件。在物件瀏覽器面板中,選取物件名稱左側的箭頭,即可收合或展開物件。根據預設,物件瀏覽器面板會展開專案中的任何模型,並顯示模型中定義的 Explore 清單。

查看物件類型

物件瀏覽器面板會列出下列物件類型:

您可以在物件瀏覽器面板中將滑鼠游標懸停在物件名稱上,查看專案中的物件類型。

物件瀏覽器面板會顯示圖示和文字標籤,用於識別物件類型:

  • :模型
  • - 探索
  • - 檢視
  • - 維度
  • - 維度群組
  • - 測量
  • - 篩選器
  • - 參數

將滑鼠游標懸停在物件瀏覽器面板中的欄位名稱上,即可查看欄位的 type 子參數值。在以下範例中,id 物件左側的圖示表示這是維度,將滑鼠游標懸停在 id 維度上,則會顯示這是 type: number 維度:

物件瀏覽器會在樣本 ID 欄位名稱旁顯示維度圖示,並在游標懸停時顯示數值類型。

您可以使用下列任一方法,直接從物件瀏覽器面板前往物件的 LookML:

按一下物件名稱

如要前往物件的 LookML,請按照下列步驟操作:

  1. 在物件瀏覽器面板中,按一下物件名稱。
  2. IDE 會開啟定義物件的檔案,並將游標置於物件宣告的第一行。

搜尋物件

如要搜尋物件或檔案,請按照下列步驟操作:

  1. 在物件瀏覽器面板中,按一下「跳到物件或檔案」圖示

    或者,使用鍵盤快速鍵 Command-J (Mac) 或 Ctrl+J (Windows)。

  2. 輸入搜尋字詞。Looker 會列出與搜尋字詞相符的物件和檔案。

特殊情況

在物件瀏覽器面板中查看匯入的物件

從其他專案匯入檔案並在現行專案中加入這些匯入的檔案後,您也可以使用物件瀏覽器面板查看匯入的物件。

舉例來說,假設您在專案的資訊清單檔案中使用 local_dependency 參數,匯入名為 e_redlook 的本機專案,其中包含名為 product_facts 的檢視畫面:


# Your project
project_name: "e_thelook"

# The project to import
local_dependency: {
 project: "e_redlook"
}

如要讓模型使用 product_facts 檢視畫面,您可以加入該檢視畫面並建立 product_facts 探索:


include: "//e_redlook/views/product_facts.view"
explore: product_facts {}

接著,您可以在物件瀏覽器面板中查看 product_facts Explore,並展開 Explore 來顯示其中包含的任何檢視畫面和欄位。

從匯入的專案中選取物件時,Looker 會開啟定義該物件的檔案。由於該檔案是匯入的專案檔案,因此屬於唯讀檔案。

在物件瀏覽器面板中查看已擴充的物件

如果專案包含的檢視畫面或探索功能擴充其他檢視畫面或探索功能,您可以使用物件瀏覽器面板查看並前往擴充物件的 LookML。當您展開擴展其他檢視畫面的檢視畫面時,物件檢視器面板會顯示基本檢視畫面的欄位,以及您在擴展檢視畫面中新增的任何欄位。

舉例來說,下列檢視畫面檔案定義了名為 user_with_age_extension 的檢視畫面,該檢視畫面會擴充另一個名為 users_extended 的檢視畫面,並新增欄位:

include: "/views/users_extended.view"

view: user_with_age_extension {
  extends: [users_extended]

  dimension: age {
    type: number
    sql: ${TABLE}.age ;;
  }

  dimension: zip {
    type: zipcode
    sql: ${TABLE}.zip ;;
  }
}

物件瀏覽器面板現在會顯示在基礎 users_extended 檢視畫面中定義的欄位,以及在 user_with_age_extension 檢視畫面中定義的新欄位。

您可以在物件瀏覽器面板中選取延伸物件的名稱,前往該物件的 LookML

在物件瀏覽器面板中查看精細物件

您可以使用物件瀏覽器面板查看精細檢視畫面或「探索」的內容,或是前往 LookML,查看專案中的精細檢視畫面。

物件瀏覽器面板會將精緻化項目和 Explore 或 View 列為單一物件,而非分別顯示精緻化項目和其基礎物件。如果您使用精進功能在檢視畫面中加入欄位,或是將檢視畫面加入探索,系統會將您新增的欄位或檢視畫面,與原始檢視畫面的內容一併顯示。

在物件瀏覽器面板中,點選精緻化檢視畫面或精緻化探索名稱時,IDE 會開啟 LookML 中定義精緻化內容的程式碼行。如果檢視畫面或探索功能已經過多次精修,IDE 會根據包含順序前往該物件的最後一次精修。

舉例來說,假設您想在名為 user_with_age_extension 的檢視畫面中新增新維度 country,但不修改檢視畫面原始的 LookML。如要精進 user_with_age_extension 檢視畫面,請使用 view 參數,並在檢視畫面名稱前方加上加號 (+):


view: +user_with_age_extension {

  dimension: country {
    type: string
    map_layer_name: countries
    sql: ${TABLE}.country ;;
  }
}

在物件瀏覽器面板中展開 user_with_age_extension 檢視畫面後,系統會一併顯示 country 欄位和檢視畫面原始欄位。

在專案中新增精細設定時,請留意精細設定的套用順序。精修內容會在單一檔案中逐行向下套用,如果物件在多個檔案中精修多次,則會依照檔案的加入順序套用。如要瞭解精確化項目的套用順序,請參閱 LookML 精確化項目說明文件頁面。