라벨 (필드용)

이 섹션에서는 필드의 일부인 label 매개변수를 설명합니다.

label는 label (모델용) 매개변수 문서 페이지에 설명된 대로 모델의 일부로 사용할 수도 있습니다.

label는 label(탐색용) 매개변수 문서 페이지에 설명된 탐색의 일부로 사용할 수도 있습니다.

label는 label(뷰용) 매개변수 문서 페이지에 설명된 뷰의 일부로 사용할 수도 있습니다.

label는 대시보드 참조선 매개변수 문서 페이지에 설명된 참조선의 일부로 사용할 수도 있습니다.

용도

view: view_name {
dimension: field_name {
label: "원하는 라벨 이름"
}
}
계층 구조
view
필드 유형
label
가능한 필드 유형
측정기준, 측정기준 그룹, 측정, 필터, 매개변수

결제 가능
문자열

정의

label를 사용하면 필드 이름이 필드 선택 도구와 탐색의 데이터 표에 표시되는 방식을 선택할 수 있어 탐색을 더 사용자 친화적으로 만드는 데 도움이 됩니다. 라벨이 지정되지 않으면 기본적으로 필드 이름이 지정됩니다.

라벨은 Explore에 표시된 필드에만 영향을 미치며 LookML에서 필드를 참조하는 방식에는 영향을 미치지 않습니다. 라벨이 있는 필드는 LookML 파일의 일반 ${view_name.field_name} 구문으로 계속 참조됩니다.

label를 사용한 유동 변수

Liquid 변수를 label 매개변수와 함께 사용할 수 있습니다. 유동 변수를 사용하면 모델 또는 탐색에 관한 정보, 필드에 적용되는 필터, 사용자 속성 값과 같은 데이터에 액세스할 수 있습니다. Liquid 변수를 사용해 label 값을 동적으로 변경하여 필드 선택 도구와 데이터 시각화에서 필드의 모양을 변경할 수 있습니다.

_filters과 같이 필터를 기반으로 값을 반환하거나 in_query과 같은 쿼리를 먼저 실행해야 하는 유동 변수는 필드 선택 도구의 필드 이름을 변경하지 않습니다. 이 경우 필드 이름은 결과 시각화에서만 변경됩니다.

예를 들어 Liquid 변수 {{ _user_attributes['name_of_attribute'] }}는 Liquid 변수를 지정된 사용자 속성 값으로 대체합니다. 사용자에게 이름이 'John Smith'인 name이라는 사용자 속성이 있으면 다음 label 구문은 필드 선택 도구의 필드 이름을 John Smith로 변경합니다.

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

다음 예에서 name 측정기준은 _user_attributes['name_of_attribute'] Liquid 변수와 함께 Liquid {% dynamic if %} {% dynamic else %} {% dynamic endif %} 구조를 사용하여 company 사용자 속성에 따라 label 값을 변경합니다.

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

이 고객센터 도움말에서 Liquid 변수와 함께 label를 사용하여 동적 라벨을 정의하는 예시를 추가로 확인할 수 있습니다.

예

이 측정값은 필드 선택 도구에서 고객 수 구분 대신 고객 수로 표시됩니다.

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

고려사항

IDE가 뷰에서 중복 라벨을 플래그 지정

동일한 뷰에서 중복 필드 라벨을 방지하기 위해 Looker IDE에서는 LookML 뷰 파일에 있는 중복된 필드 라벨의 줄 번호에 정보 아이콘을 표시합니다. 줄 번호에 대한 정보 아이콘 위로 마우스를 가져가면 뷰에 이미 라벨이 있는 필드가 도움말에 표시됩니다.

IDE에서 label 문의 텍스트를 클릭하면 Looker IDE에 동일한 정보가 빠른 도움말에 표시됩니다.