view_label (適用於探索)

本頁面是指 探索中的 view_label 參數。

view_label 也可做為聯結的一部分，詳情請參閱view_label (適用於聯結) 參數說明文件頁面。

view_label 也可做為維度、指標或篩選條件的一部分，詳情請參閱view_label (適用於欄位) 參數說明文件頁面。

用量

explore: explore_name {
  view_label: "desired label for the view"
}
階層
explore
view_label
預設值
探索名稱

接受
一個字串

定義

view_label 會變更欄位挑選器中，探索基本檢視畫面欄位群組的標籤方式。

有時，view_label 會在檢視名稱前方加上底線，以便按字母順序排序，成為欄位挑選器中的頂端檢視。此外，如果出於建模目的需要多個檢視畫面，但就業務使用者而言，這些檢視畫面代表相同的實體，您也可以使用這項功能。舉例來說，您可能在 LookML 中定義了一個檢視區塊為 customer，另一個為 customer_facts，並希望保留這些名稱以供建模。不過，對商家使用者而言，這兩者都顯示為「客戶」可能比較合理。

如要變更欄位名稱，請使用 label 參數。

範例

讓「探索」customer_facts顯示在商家使用者的「顧客」檢視畫面中：

explore: customer_facts {
  view_label: "Customers"
}

讓使用者在「產品資訊」檢視畫面中看到「探索」product_facts：

explore: product_facts {
  view_label: "Product Info"
}

注意事項

view_label 除了變更欄位挑選器外觀外，沒有其他作用

變更「探索」的 view_label 時，只有欄位挑選器會受到影響。「探索」在「探索」選單中的顯示方式，以及在 LookML 中參照欄位的方式，都不會改變。

使用 view_label 合併多個檢視畫面時，請遵循大小寫規則

如要將「探索」基本檢視區塊的欄位與「探索」已聯結檢視區塊的欄位合併至欄位挑選器，請務必確認 view_label 中使用的字體大小寫正確無誤。您使用的大小寫必須與欄位挑選器中顯示的檢視區塊名稱相符。我們來看看這個例子

explore: product {
  view_label: "Product Info"
  join: product_info {
    sql_on: ${product.product_id} = ${product_info.product_id} ;;
  }
}

product_info 在欄位挑選器中會顯示為「Product Info」，每個字都會大寫，底線則會改為空格。因此，我們使用 view_label: 'Product Info' 而不是 view_label: 'product_info'。

欄位的 view_label 優先於探索的 view_label

如果「探索」中的欄位有 view_label，該欄位會顯示在自己的 view_label 下方，而不是「探索」的 view_label。請看這個範例，其中「探索」和維度都有 view_label 值。

在模型檔案中，探索會以 view_label: "View Label on Explore" 定義：

explore: us_births {
  label: "US births"
  view_label: "View Label on Explore"
}

在 us_births.view 檔案中，state 維度會以 view_label: "View Label on Field" 定義：


view: us_births {
  label: "US births"

  dimension: state {
    view_label: "View Label on Field"
    type: string
    sql: ${TABLE}.state ;;
  }

在本例中，state 維度的 view_label 會覆寫探索的 view_label，因此在探索中，state 維度會顯示在「在欄位上查看標籤」view_label 下方。

view_label 影響「探索」的基本檢視畫面

這個參數與 view_label (用於彙整) 類似，但會影響探索的基本檢視區塊，而非彙整的檢視區塊。與label (適用於檢視區塊) 不同，這個參數只會影響該探索中的基本檢視區塊。