標籤 (適用於欄位)

本節是指屬於欄位的 label 參數。

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

label 也可做為「探索」的一部分，詳情請參閱label (適用於「探索」) 參數說明文件頁面。

label 也可做為檢視區塊的一部分，詳情請參閱label (適用於檢視區塊) 參數說明文件頁面。

label 也可做為參考線的一部分，詳情請參閱「資訊主頁參考線參數」說明文件頁面。

用量

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}
階層
view
欄位類型
label
可能的欄位類型
維度、維度群組、指標、篩選器、參數

接受
一個字串

定義

label 可讓您選擇欄位名稱在欄位挑選器和探索資料表中的顯示方式，讓探索項目更易於使用。如未指定標籤，標籤預設為欄位名稱。

使用 label 的 Liquid 變數

您可以搭配 label 參數使用 Liquid 變數。您可以使用 Liquid 變數存取資料，例如模型或「探索」的相關資訊、套用至欄位的篩選器，以及使用者屬性值。您可以使用 Liquid 變數動態變更 label 值，進而變更欄位挑選器和資料視覺化中的欄位外觀。

如果 Liquid 變數會根據篩選條件傳回值 (例如 _filters)，或需要先執行查詢 (例如 in_query)，則欄位挑選器中的欄位名稱不會變更。在這種情況下，欄位名稱只會在產生的視覺化效果中變更。

舉例來說，Liquid 變數 {{ _user_attributes['name_of_attribute'] }} 會將 Liquid 變數替換為指定使用者屬性的值。如果使用者有名為「name」的使用者屬性，且值為「John Smith」，則下列 label 語法會將欄位挑選器中的欄位名稱變更為「John Smith」：

label: "{{ _user_attributes['name'] }}"

在下一個範例中，name 維度會使用 Liquid {% if %} {% else %} {% endif %} 結構和 _user_attributes['name_of_attribute'] Liquid 變數，根據公司使用者屬性變更 label 值：

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

如要查看更多使用 label 和 Liquid 變數定義動態標籤的範例，請參閱「在標籤中使用 Liquid 的有趣方式」最佳做法頁面。

範例

在欄位挑選器中，將這項指標顯示為「顧客人數」，而非「不重複顧客人數」。

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

注意事項

IDE 會標示檢視區塊中的重複標籤

為避免同一檢視區塊中的欄位標籤重複，Looker IDE 會在 LookML 檢視區塊檔案中，於任何重複欄位標籤的行號旁顯示資訊圖示。如果將滑鼠游標懸停在行號旁的資訊圖示上，工具提示會指出檢視畫面中已有標籤相同的欄位。

如果您在 IDE 中選取 label 陳述式的文字，Looker IDE 會在「快速說明」面板中顯示相同資訊：