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

您可以在 Looker IDE 的物件瀏覽器面板中,集中查看專案中的所有物件,以及這些物件之間的階層式關係。這項功能可做為依檔案或資料夾瀏覽專案的實用替代方案。

查看專案中的物件

物件瀏覽器面板會顯示專案中定義的模型、探索、檢視區塊和欄位,以及物件的階層和每個物件的類型。如果專案也包含匯入的檔案,請參閱本頁稍後的檢視這些物件一節,瞭解更多詳細資料。

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

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

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

查看物件類型

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

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

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

  • - 模型
  • - 探索
  • - 檢視
  • - 維度
  • — 維度群組
  • - 評估
  • - 篩選器
  • - 參數

將滑鼠游標懸停在物件瀏覽器面板中的欄位名稱上,即可顯示欄位 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,並展開「探索」來顯示其中包含的任何檢視區塊和欄位。

從匯入的專案選取物件時,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,瞭解專案中的精簡項目。

物件瀏覽器面板會將精修項目和其建構的探索或檢視畫面列為單一物件,而非分別顯示精修項目和基礎物件。如果您使用精簡功能將欄位新增至檢視區塊,或將檢視區塊加入探索,系統會一併顯示您新增的欄位或檢視區塊,以及原始檢視區塊的內容。

在物件瀏覽器面板中,按一下精細檢視或精細探索的名稱時,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 精細化」說明文件頁面。