變更「探索」選單和欄位挑選器

您可以使用多個 LookML 參數，變更欄位在使用者介面中的顯示方式，而不必變更基礎 LookML，讓「探索」更符合使用者需求。本頁面將概略說明 LookML 參數，說明如何修改 Looker 探索選單和欄位挑選器的外觀。

在 Looker 中，使用者可以透過「探索」選單查看列出的探索。	在「探索」中，使用者可以使用欄位挑選器，選取用於查詢資料的欄位 (維度和指標)。

本頁列出每個常用的參數，並附上完整參考頁面的連結、簡短的功能說明，以及功能圖片。

如要瞭解如何打造友善的 Explore 體驗，請參閱「最佳做法：為 Looker 使用者打造良好體驗」最佳做法頁面。

探索名稱和選單

本節將說明「探索」選單中「探索」名稱和外觀的預設行為，接著說明可讓您變更該行為的 LookML 參數：

• label (型號)
• label (探索)
• group_label (探索)
• description (探索)
• hidden (探索)

探索選單的預設行為

模型名稱

根據預設，「探索」選單會依模型名稱排序，而模型名稱則是根據各模型檔案的名稱決定。「探索」選單會顯示格式化的模型名稱，其中底線會變成空格，每個字詞都會大寫。每個模型名稱下方都會列出該模型檔案中定義的探索。

探索名稱

選單中每個「探索」的名稱，皆取自模型檔案中的對應 explore 參數。與模型名稱一樣，探索名稱在選單中會採用特定格式，底線會變成空格，每個字詞都會大寫。「探索」名稱也會顯示為欄位挑選工具面板中的「探索」標題。

在以下範例中，order_items Explore 是在模型檔案 e_commerce_model.model 中定義：

explore: order_items {
  join: orders {
    type: left_outer
    sql_on: ${order_items.order_id} = ${orders.id} ;;
    relationship: many_to_one
  }
}

order_items 探索功能會在「探索」選單和欄位挑選器中顯示為「訂單項目」。

「探索」選單：	欄位挑選器：

如要進一步瞭解模型檔案，請參閱「瞭解模型和檢視檔案」說明文件頁面。如要進一步瞭解如何定義探索，請參閱 explore 參數說明文件頁面。

label (模型)

模型的 label 參數會在「探索」選單中重新命名模型，但不會變更 LookML 中的參照方式。探索網址、Looker IDE 和 SQL Runner 仍會顯示實際的模型名稱；LookML 和管理員設定中引用模型的方式則維持不變。

根據預設，模型 market_research.model 會在「探索」選單中顯示為「市場研究」。

您可以使用 label 參數，在「探索」選單中重新命名模型。舉例來說，您可以將 label: "Marketing R&D" 程式碼新增至 market_research.model 模型檔案：

label: "Marketing R&D"

在本例中，Looker 會在「探索」選單中顯示以下模型名稱：

label (探索)

Explore 的 label 參數會在「Explore」選單和「Explore」頁面中重新命名 Explore，但不會變更 LookML 中的參照方式。

如未使用 label 參數，系統會根據預設行為顯示探索名稱。

group_label (探索)

Explore 的 group_label 參數會變更「探索」選單的預設機構。group_label 可讓您定義自訂標題，並在該標題下方列出一個或多個探索，而非在模型名稱下方列出每個探索。

在這個範例中，「探索」頁面會在「線上商店查詢」群組標籤下列出「客戶」、「商品目錄」、「訂購商品」和「使用者資料」：

description (探索)

您可以使用探索項目的 description 參數，在 UI 中新增探索項目說明，讓使用者在建立探索項目查詢時取得其他資訊。

使用者只要將滑鼠游標懸停在欄位挑選器頂端的「探索」名稱旁的資訊圖示上，即可查看說明。資訊圖示也會顯示在「探索」的下拉式清單中。如果您未明確為探索內容新增說明，系統就不會顯示說明。

hidden (探索)

探索的 hidden 參數會隱藏「探索」選單中的探索，根據預設，hidden 會關閉，並顯示「探索」畫面。hidden 不會隱藏 LookML，也不會禁止透過網址存取「探索」。hidden 並非安全性功能，而是呈現功能。

舉例來說，在下列範例中，將 LookML 程式碼 hidden: yes 新增至 inventory 探索的 LookML，即可隱藏探索選單中的「Inventory」探索：

explore: inventory {
  hidden: yes

  join: order_facts {
    view_label: "Orders"
    relationship: many_to_one
    sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
  }
}

欄位挑選器

本節將說明欄位挑選工具的預設行為，接著說明可讓您變更該行為的 LookML 參數。

如要變更資料檢視名稱在欄位選擇器中的顯示方式，請使用下列方法：

• view_label (探索)
• view_label (join)
• label (檢視)

如要變更個別欄位名稱在欄位挑選器中的顯示方式，請使用下列方法：

• description (欄位)
• hidden (欄位)
• label (欄位)
• fields (欄位)

您可以使用下列方法，變更欄位在欄位挑選器中的排列方式：

• view_label (欄位)
• group_label (欄位)

欄位挑選器的預設行為

根據預設，欄位挑選器會依據 LookML view 參數指定的檢視畫面，以標題分類。每個檢視畫面的欄位都會在欄位挑選器中分組。欄位類型 (維度、維度群組、評估、篩選欄位和參數欄位) 會決定欄位在檢視畫面中顯示的位置。除非使用 label 參數變更顯示名稱，否則欄位挑選器會顯示格式化的 LookML 檢視畫面或欄位名稱，其中底線會變更為空格，每個字詞都會大寫。

在以下範例中，Looker 會在欄位挑選器中將 accounts 檢視區塊顯示為 Accounts，這是預設行為：

view: accounts {
  sql_table_name: accounts ;;
}

以下範例說明預設情況下，維度、維度群組和評量項目的名稱顯示方式。相同的格式會套用至所有篩選器欄位和參數欄位的名稱。

dimension: account_number {
  primary_key: yes
  type: number
  sql: ${TABLE}.account_number ;;
}

dimension: name {
  type: string
  sql: ${TABLE}.name ;;
}

dimension_group: created {
  type: time
  timeframes: [raw, time, date, week, month, quarter, year]
  sql: ${TABLE}.created_date ;;
}

measure: average_annual_revenue {
  type: average
  sql: ${annual_revenue} ;;
  value_format_name: custom_amount_value_format
}

在這個範例中，欄位挑選器會顯示 account_number 和 name 維度的預設欄位名稱「帳號」、「名稱」、「建立日期」和「平均年度收益」，以及 created 維度群組和 average_annual_revenue 評估資料。

如果您變更欄位的名稱，欄位挑選器會採用新名稱，但您可能會想新增 alias 參數，並使用該欄位的舊名稱。該參數會為可能出現在查詢網址中的欄位提供替代名稱。當模型中的欄位名稱變更，但有些人已分享資料連結，而您想讓這些現有網址繼續運作時，這項功能就很實用。

view_label (探索)

Explore 的 view_label 參數會變更 Explore 基礎檢視畫面中欄位群組在欄位挑選器中的標示方式，但不會變更 LookML 中 Explore 及其欄位的參照方式。

舉例來說，如果您將檢視畫面 order_facts 與名為 order_items 的探索畫面彙整，可以使用 view_label 參數，在欄位挑選器中設定 Looker 為 order_facts 檢視畫面顯示的標籤，如下所示：

explore: order_items {
  label: "Order Items"
  join: order_facts {
    view_label: "Orders and more"
    relationship: many_to_one
    sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
  }
}

在本範例中，order_facts 檢視畫面會在「訂購商品」探索的欄位挑選器中顯示為「訂單和其他資訊」。

view_label (加入)

彙整作業的 view_label 參數可讓您在欄位挑選器中，將一個檢視畫面中的欄位分組至另一個檢視畫面的名稱下方。如果您未明確將 view_label 新增至彙整作業，view_label 的預設值會是彙整作業的名稱。

舉例來說，您可以將 products 檢視畫面彙整至 product_facts 探索資料：

explore: product_facts {
  join: products {
    type: left_outer
    sql_on: ${product_facts.product_id} = ${products.id} ;;
    relationship: many_to_one
  }
}

在本例中，由於未指定檢視標籤，因此 products 檢視畫面的欄位會在欄位挑選器的「Products」檢視標籤下分組，與「Product Facts」檢視畫面分開：

您可以使用 view_label 參數，在已彙整的 products 檢視畫面中新增檢視畫面標籤，如以下範例所示：

explore: product_facts {
  join: products {
    view_label: "Product Facts"
    type: left_outer
    sql_on: ${product_facts.product_id} = ${products.id} ;;
    relationship: many_to_one
  }
}

這會在欄位挑選器的「Product Facts」檢視標籤下，將 products 檢視畫面中的欄位分組：

label (次觀看)

檢視畫面的 label 參數會變更檢視畫面在欄位選擇器中的標籤方式，但不會變更 LookML 中的參照方式。如果未指定，標籤會預設為檢視畫面的名稱。與 view_label (探索) 和 view_label (彙整) 不同，這個參數會影響所有使用該檢視畫面的探索。

舉例來說，您可以使用 label 參數為 inventory_items 檢視畫面指定標籤，如下所示：

view: inventory_items {
  label: "Items in Inventory"
  sql_table_name: inventory_items ;;
}

在本例中，欄位選擇器會為 inventory_items 檢視畫面顯示「Items in Inventory」標籤，而非預設的「Inventory Items」標籤。

description (欄位)

您可以將 description 新增至任何欄位。針對 BigQuery 連線，如果您從資料庫產生 LookML 專案，Looker 會自動使用 BigQuery 欄位中繼資料 (如有) 中的說明，填入欄位說明。

使用者可以在多個地方看到這項說明。當使用者在欄位挑選器中選取欄位名稱右側的資訊圖示時，Looker 就會顯示說明。

此外，當使用者在探索、資訊主頁或 Look 中，將滑鼠游標懸停在資料表或資料表圖表視覺化資料的欄名稱上時，Looker 也會顯示說明。

hidden (欄位)

根據預設，系統會在欄位挑選器中顯示檢視畫面中指定的欄位。欄位的 hidden 參數會隱藏欄位挑選器中的欄位。

隱藏欄位如果手動新增至網址，仍可在 UI 中存取，並會顯示在部分 Looker 視窗中。因此，請將 hidden 視為一種讓欄位挑選器保持簡潔的方式，而非安全性功能。

舉例來說，在以下範例中，將 LookML 程式碼 hidden: yes 新增至 product_id 維度的 LookML，即可隱藏欄位挑選器中的「產品 ID」維度：

dimension: product_id {
  hidden: yes
  type: number
  sql: ${TABLE}.product_id ;;
}

fields (欄位)

您可以使用 fields 參數，指定要從「探索」的基本檢視畫面和彙整作業中，在欄位挑選器中顯示哪些欄位。如果您未使用 fields 參數，Looker 會公開所有欄位。

如要指定要在欄位挑選器中顯示的欄位，請使用以半形逗號分隔的欄位或集合清單。如要指定要從欄位挑選工具隱藏的欄位，請使用 ALL_FIELDS* 集合，並以半形逗號分隔要排除的欄位或集合清單，每個項目前面加上連字號 (-)。

舉例來說，您可以使用下列 LookML 程式碼，只顯示欄位挑選器中 aircraft Explore 的部分欄位：

explore: aircraft {
  fields: [
    aircraft.aircraft_model_code,
    aircraft.aircraft_engine_code,
    aircraft.count,
    aircraft.city,
    aircraft.country,
    aircraft.zip,
   ]
}

在這個範例中，「Aircraft」探索資料只會顯示「Aircraft Model Code」、「Aircraft Engine Code」、「City」、「Country」和「Zip」維度，以及欄位挑選器中的「Count」評量。

label (欄位)

欄位的 label 參數可讓您變更欄位名稱在欄位挑選器中的顯示方式，而不必變更 LookML 中的參照方式。如果未指定標籤，標籤預設為欄位名稱。

舉例來說，您可以使用 label 參數為 cost 維度設定標籤，如下所示：

dimension: cost {
  label: "price"
  type: number
  sql: ${TABLE}.cost ;;
}

在這個範例中，「成本」維度在欄位挑選器中具有「價格」標籤。

view_label (欄位)

欄位的 view_label 參數可讓您變更在欄位挑選器中列出欄位的檢視畫面名稱，而不必變更 LookML 中對該欄位的參照方式。如果未指定標籤，欄位會顯示在定義標籤的檢視畫面標籤下方。

舉例來說，您可以使用 view_label 參數，如以下所示，為 cost 維度指定檢視標籤：

dimension: cost {
  view_label: "Cost Information"
  type: number
  sql: ${TABLE}.cost ;;
}

在這個範例中，Looker 會在欄位挑選器的「費用資訊」檢視標籤下方顯示「費用」維度。

group_label (欄位)

group_label 參數可讓您在欄位挑選器的檢視畫面中，將欄位合併至常見的下拉式選單中。

在這個範例中，「Shipping Info」群組包含「Shipping City」、「Shipping Country」和「Shipping State」欄位：

group_item_label (欄位)

當欄位顯示在群組標籤下方時，可能不需要在欄位挑選器中顯示完整的欄位名稱或標籤。在先前顯示的 group_label (欄位) 範例中，群組標籤已指出這些欄位與運送相關。在這種情況下，您可以將 group_item_label 參數新增至每個已分組的欄位，變更這些欄位在群組標籤下方的顯示方式。

在這個範例中，「Shipping Info」群組包含「City」、「Country」和「State」欄位：