LookML 대시보드의 열 차트 매개변수

이 페이지에서는 dashboard.lkml 파일에서 LookML 대시보드 파라미터를 사용하여 type: looker_column의 LookML 대시보드 요소를 만드는 옵션을 설명합니다.

Looker UI를 통해 열 차트를 빌드하는 방법에 대한 자세한 내용은 열 차트 옵션 문서 페이지를 참고하세요.

사용 예시


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_column
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
stacking: normal | percent | ''
show_dropoff: true | false
ordering: none | asc | desc
column_spacing_ratio: number between 0 and 1
column_group_spacing_ratio: number between 0 and 1
hide_legend: true | false
legend_position: center | left | right
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
colors: [css_color, css_color, …]
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
   series_name: column | line | area | scatter
   # Possibly more series visualization assignments
show_view_names: true | false

## VALUE PARAMETERS
show_value_labels: true | false
show_null_labels: true | false
label_color: [css_color, css_color, …]
font_size: Npx
label_rotation: N
label_value_format: 'value formatting string'
show_totals_labels: true | false
hidden_series: [series_name, series_name, …]
show_silhouette: true | false
totals_color: css_color

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
x_axis_reversed: true | false
show_x_axis_label: true | false
x_axis_label: desired x-axis label
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

매개변수 정의

파라미터 이름 설명
기본 매개변수
name (요소용) 요소를 만듭니다.
title (요소용) 요소 이름이 사용자에게 표시되는 방식을 변경합니다.
type (요소용) 요소에 사용할 시각화 유형을 결정합니다.
height (요소용) layout: tile 및 layout: static 대시보드의 경우 tile_size 단위로 요소의 높이를 정의합니다.
width (요소용) layout: tile 및 layout: static 대시보드의 경우 tile_size 단위로 요소의 너비를 정의합니다.
top layout: static 대시보드의 경우 tile_size 단위로 요소의 위에서 아래로의 위치를 정의합니다.
left layout: static 대시보드의 경우 tile_size 단위로 요소의 왼쪽에서 오른쪽 위치를 정의합니다.
row layout: newspaper 대시보드의 요소의 위에서 아래로의 위치를 행 단위로 정의합니다.
col layout: newspaper 대시보드의 열 단위로 요소의 왼쪽에서 오른쪽 위치를 정의합니다.
refresh (요소용) 요소가 자동으로 새로고침되는 간격을 설정합니다.
note 요소의 메모를 정의하기 위해 LookML 섹션을 시작합니다. 이 파라미터에는 하위 파라미터 text, state, display이 있습니다.
쿼리 매개변수
model 요소의 쿼리에 사용할 모델을 정의합니다.
explore (요소용) 요소의 쿼리에 사용할 Explore를 정의합니다.
dimensions 요소의 쿼리에 사용할 측정기준을 정의합니다.
measures 요소의 쿼리에 사용할 측정항목을 정의합니다.
sorts 요소의 쿼리에 사용할 정렬을 정의합니다.
pivots 요소의 쿼리에 사용하기 위해 피벗해야 하는 측정기준을 정의합니다.
limit 요소의 쿼리에 사용할 행 제한을 정의합니다.
filters (요소용) 요소의 쿼리에 대해 변경할 수 없는 필터를 정의합니다.
listen filters (대시보드용)이 생성된 경우 요소의 쿼리에 대해 변경할 수 있는 필터를 정의합니다.
query_timezone 쿼리가 실행될 때 사용해야 하는 시간대를 정의합니다.
merged_queries 병합된 결과 쿼리를 정의합니다.
플롯 매개변수
stacking 누적 차트를 만들기 위해 계열을 서로 위에 쌓습니다.
show_dropoff 데이터 포인트 간의 백분율 변화를 보여주는 화살표를 추가합니다.
ordering 누적 또는 누적 비율 차트에서 계열 값의 순서를 설정합니다.
column_spacing_ratio 그룹 내 열 사이의 간격을 설정합니다.
column_group_spacing_ratio 열 그룹 사이의 간격을 0~1 사이의 값으로 설정합니다.
hide_legend 차트 범례를 숨깁니다.
legend_position 범례를 차트의 왼쪽, 가운데 또는 오른쪽에 표시할지 여부를 지정합니다.
hidden_fields 쿼리에 사용되지만 차트에서 숨겨지는 필드를 지정합니다.
limit_displayed_rows 결과 내 위치에 따라 시각화에서 행을 표시하거나 숨깁니다.
limit_displayed_rows_values 시각화에서 표시하거나 숨길 행을 지정합니다. 이 매개변수에는 show_hide, first_last, num_rows 하위 매개변수가 있습니다.
시리즈 매개변수
colors 계열이 표시되는 순서에 따라 차트 계열의 색상을 설정합니다.
series_colors 계열 이름을 기반으로 차트 계열의 색상을 설정합니다.
series_labels 계열 이름이 사용자에게 표시되는 방식을 변경합니다.
series_types 각 계열의 유형을 정의하여 시각화 유형을 혼합합니다.
show_view_names 차트 라벨에서 뷰 이름을 숨깁니다.
값 매개변수
show_value_labels 데이터 포인트 옆에 라벨을 표시합니다.
show_null_labels 라벨이 표시될 때 null 라벨을 차트에 표시할지 여부를 결정합니다.
label_color 쉼표로 구분된 색상 값 목록을 지정합니다.
font_size 값 라벨의 글꼴 크기를 설정합니다.
label_rotation stacking이 기본값 ('')으로 설정된 경우 값 라벨의 회전을 -360~360 사이의 값으로 설정합니다.
label_value_format 값 라벨의 Excel 스타일 형식 지정을 지정합니다.
show_totals_labels stacking이 normal로 설정된 경우 차트에서 데이터 포인트의 각 스택 그룹에 총계를 표시할지 여부를 지정합니다.
hidden_series 요소가 로드될 때 차트 계열을 숨깁니다.
show_silhouette stacking이 normal로 설정된 경우 사용 중지된 계열의 옅은 음영 표시를 표시합니다.
totals_color stacking이 normal로 설정된 경우 총계 라벨의 색상을 지정합니다.
X축 매개변수
x_axis_scale X축 배율을 계산하는 방법을 지정합니다.
x_axis_reversed x축의 방향을 지정합니다.
show_x_axis_label x축 라벨을 숨깁니다.
x_axis_label 맞춤 x축 라벨을 정의합니다.
show_x_axis_ticks x축에 눈금을 표시합니다.
x_axis_gridlines X축에서 그리드 선을 확장합니다.
x_axis_label_rotation x축 라벨을 지정된 각도만큼 회전합니다.
x_axis_datetime_label x축 라벨이 날짜인 경우 x축 라벨의 형식 문자열을 지정합니다.
x_axis_zoom x축을 따라 확대/축소를 허용할지 여부를 지정합니다.
Y축 매개변수
y_axis_gridlines Y축에서 격자선을 확장합니다.
y_axis_reversed x축의 방향을 설정합니다.
reference_lines 차트에 참조선을 추가합니다.
y_axis_zoom y축을 따라 확대/축소를 허용할지 여부를 지정합니다. x_axis_zoom: false인 경우 사용 중지됩니다.
고급 시각화 구성 매개변수
advanced_viz_config 여러 시각화 설정을 재정의할 수 있는 HighCharts JSON 스니펫을 허용합니다.

기본 매개변수

LookML 대시보드 요소를 정의할 때는 name 및 type 기본 매개변수의 값을 하나 이상 지정해야 합니다. title, height, width과 같은 기타 기본 매개변수는 대시보드의 요소 모양과 위치에 영향을 미칩니다.

name

이 섹션에서는 대시보드 요소의 일부인 name 매개변수를 참조합니다.

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

각 name 선언은 새 대시보드 요소를 만들고 이름을 할당합니다. 요소 이름은 고유해야 합니다. layout: grid 대시보드를 사용하는 경우 elements 매개변수에서 이름이 참조되는 경우가 있습니다.

- name: orders_by_date

title

이 섹션에서는 대시보드 요소의 일부인 title 매개변수를 참조합니다.

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

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

title 매개변수를 사용하면 요소의 이름이 사용자에게 표시되는 방식을 변경할 수 있습니다. 지정하지 않으면 제목은 기본적으로 요소 name입니다.

다음 예를 참조하세요.

- name: sales_overview
  title: '1) Sales Overview'

이 형식을 사용하면 요소가 매출 개요로 표시되는 대신 1) 매출 개요로 표시됩니다.

type

이 섹션에서는 대시보드 요소의 일부인 type 매개변수를 참조합니다.

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

type은 type (조인용) 매개변수 문서 페이지에 설명된 대로 조인의 일부로도 사용할 수 있습니다.

type는 측정기준, 필터, 파라미터 유형 문서 페이지에 설명된 대로 측정기준의 일부로도 사용할 수 있습니다.

type는 측정 유형 문서 페이지에 설명된 측정의 일부로도 사용할 수 있습니다.

type 매개변수는 요소에 사용될 시각화 유형을 결정합니다.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

다양한 유형의 LookML 대시보드 요소에 대한 개요는 type (LookML 대시보드용) 문서 페이지를 참고하세요.

height

이 섹션에서는 대시보드 요소의 일부인 height 매개변수를 참조합니다.

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

tile 또는 static 레이아웃이 있는 대시보드의 경우

height 매개변수는 layout: tile 및 layout: static 대시보드의 요소 높이를 tile_size (픽셀로 정의됨) 단위로 정의합니다.

예를 들어 다음 코드는 tile_size: 100 및 height: 4을 지정하여 orders_by_date 요소의 높이를 400픽셀로 만듭니다.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

newspaper 레이아웃이 있는 대시보드

height 매개변수는 layout: newspaper 대시보드의 요소 높이를 행 단위로 정의합니다.

신문 레이아웃이 있는 대시보드는 기본적으로 요소 높이가 6개 행 또는 약 300픽셀입니다. preferred viewer 매개변수가 dashboards-next로 설정된 대시보드의 최소 높이는 1행입니다. preferred viewer 매개변수가 dashboards로 설정된 대시보드의 최소 높이는 2개 행입니다.

예를 들어 다음 코드는 요소를 12개 행 높이로 설정합니다. 이는 기본값으로 설정된 다른 요소의 두 배 높이입니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

이 섹션에서는 대시보드 요소의 일부인 width 매개변수를 참조합니다.

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

width 매개변수는 layout: tile 및 layout: static 대시보드의 요소 너비를 tile_size 단위로 정의합니다.

예를 들어 다음 코드는 tile_size: 100 및 width: 4을 지정하여 orders_by_date 요소의 너비를 400픽셀로 만듭니다.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

width 매개변수는 layout: newspaper 대시보드의 요소 너비를 열 단위로 정의합니다.

신문 레이아웃이 있는 대시보드는 기본적으로 너비가 24열입니다.

예를 들어 다음 코드는 대시보드 너비의 절반으로 요소를 설정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

top 매개변수는 layout: static 대시보드의 요소의 상단에서 하단까지의 위치를 tile_size 단위로 정의합니다.

예를 들어 다음 코드는 tile_size: 100 및 top: 4를 지정하여 orders_by_date 요소의 상단 가장자리를 대시보드 상단에서 400픽셀 떨어진 위치에 배치합니다.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

left 매개변수는 layout: static 대시보드의 요소 위치를 tile_size 단위로 정의합니다.

예를 들어 다음 코드는 tile_size: 100 및 left: 4를 지정하여 orders_by_date 요소의 왼쪽 가장자리를 대시보드의 왼쪽에서 400픽셀 떨어진 위치에 배치합니다.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

layout: newspaper 대시보드의 경우 row 매개변수는 요소의 상단 가장자리가 배치되는 행을 정의합니다.

대시보드는 대시보드 상단의 행 0부터 시작합니다. 신문 레이아웃이 적용된 대시보드의 기본 요소 높이는 6개 행입니다. 즉, 대시보드 상단의 대시보드 요소 (row: 0)는 기본적으로 0~5행을 차지합니다.

각 행의 높이는 50픽셀이므로 6개 행의 기본 요소 높이는 300픽셀입니다.

예를 들어 다음 코드는 대시보드의 두 번째 요소 행에 설정할 요소를 설정합니다. 요소가 기본 높이로 설정되어 있다고 가정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

layout: newspaper 대시보드의 경우 col 매개변수는 요소의 왼쪽 가장자리가 배치되는 열을 정의합니다.

대시보드는 24개 열로 나뉩니다. 대시보드는 대시보드의 왼쪽에서 열 0으로 시작합니다. 신문 레이아웃이 있는 대시보드는 기본적으로 요소 너비가 8개 열입니다. 즉, 대시보드의 왼쪽 (col: 0)에 있는 대시보드 요소는 기본적으로 0~7 열을 차지합니다.

예를 들어 다음 코드는 대시보드의 요소 중 세 번째 열에 설정할 요소를 설정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

이 섹션에서는 대시보드 요소의 일부인 refresh 매개변수를 참조합니다.

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

refresh 매개변수를 사용하면 요소가 주기적으로 자동으로 새로고침되어 최신 데이터를 가져올 수 있습니다. 이 기능은 사무실 TV와 같이 대시보드가 지속적으로 표시되는 설정에서 유용합니다. 이 매개변수가 적용되려면 대시보드가 브라우저 창에서 열려 있어야 합니다. 이 설정은 대시보드 캐시를 '사전 워밍'하기 위해 백그라운드에서 실행되지 않습니다.

새로고침 빈도는 초, 분, 시간, 일 단위의 숫자 (소수점 없음)로 지정할 수 있습니다. 예를 들면 다음과 같습니다.

- name: orders_by_date
  refresh: 2 hours

짧은 새로고침 간격을 설정할 때는 주의하세요. 요소의 쿼리가 리소스 집약적인 경우 특정 요소가 원하는 것보다 데이터베이스에 더 많은 부담을 줄 수 있습니다.

note

다음과 같이 요소에 설명 메모를 추가할 수 있습니다.

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note에는 하위 매개변수 text, state, display이 있습니다.

text

text 하위 매개변수는 메모에 표시되는 텍스트를 지정합니다. 텍스트는 현지화할 수 있습니다.

state

state 하위 매개변수는 요소의 너비 내에서 한 행에 맞지 않을 정도로 큰 경우 메모리가 collapsed인지 expanded인지 결정합니다. collapsed를 선택하고 메모가 너무 긴 경우 전체 메모를 읽는 데 사용할 수 있는 클릭 가능한 생략 부호 (...)로 메모가 끝납니다.

display

display 하위 매개변수는 요소에 메모가 표시되는 위치를 결정합니다. above는 요소 상단에 메모를 배치하고, below는 요소 하단에 메모를 배치하며, hover는 사용자가 메모를 보려면 요소 위로 마우스를 가져가야 합니다.

쿼리 파라미터

LookML 대시보드 요소를 정의할 때는 model 및 explore 쿼리 매개변수의 값을 하나 이상 지정해야 하며, dimensions 매개변수 또는 measures 매개변수를 사용하여 필드를 하나 이상 지정해야 합니다. 다른 쿼리 매개변수를 사용하여 대시보드 요소에 데이터가 표시되는 방식을 제어할 수도 있습니다.

model

model 매개변수는 요소 쿼리에 사용할 모델을 정의합니다. 지정하지 않으면 대시보드가 있는 모델로 기본 설정됩니다.

- name: orders_by_date
  model: ecommerce

model 매개변수는 LookML 상수를 허용합니다. 프로젝트의 매니페스트 파일에서 상수를 정의한 다음 "@{constant_name}" 구문을 사용하여 상수를 model의 값으로 설정할 수 있습니다. 상수를 사용하면 한 곳에서 모델의 이름을 정의할 수 있으며, 이는 여러 대시보드 요소에서 사용되는 모델의 이름을 업데이트하는 경우에 특히 유용합니다.

LookML 대시보드에서 상수를 사용하는 방법에 대한 자세한 내용과 예는 constant 매개변수 문서 페이지를 참고하세요.

explore

이 섹션에서는 대시보드 요소의 일부인 explore 매개변수를 참조합니다.

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

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

explore 매개변수는 요소 쿼리에 사용할 Explore를 정의합니다.

- name: orders_by_date
  explore: order

explore 매개변수는 LookML 상수를 허용합니다. 프로젝트의 매니페스트 파일에서 상수를 정의한 다음 "@{constant_name}" 구문을 사용하여 상수를 explore의 값으로 설정할 수 있습니다. 상수를 사용하면 한 곳에서 Explore 이름을 정의할 수 있으며, 이는 여러 대시보드 요소에서 사용되는 Explore 이름을 업데이트하는 경우에 특히 유용합니다.

LookML 대시보드에서 상수를 사용하는 방법에 대한 자세한 내용과 예는 constant 매개변수 문서 페이지를 참고하세요.

dimensions

dimensions 매개변수는 요소 쿼리에 사용할 측정기준을 정의합니다. view_name.dimension_name 구문을 사용하여 측정기준을 지정합니다. 쿼리에 dimensions가 없는 경우 포함하지 마세요.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

measures 매개변수는 요소 쿼리에 사용할 측정치를 정의합니다. view_name.measure_name 구문을 사용하여 측정치를 지정합니다. 쿼리에 measures가 없는 경우 포함하지 마세요.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

sorts 매개변수는 요소 쿼리에 사용할 정렬을 정의합니다. 기본 정렬이 먼저 나열되고 보조 정렬이 그 다음에 나열되는 방식입니다. view_name.field_name 문법을 사용하여 측정기준 또는 측정값을 지정합니다. Looker의 기본 정렬 순서를 사용하려면 sorts를 포함하지 마세요. 내림차순 정렬에는 desc 접미사가 붙고 오름차순 정렬에는 접미사가 필요하지 않습니다.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

pivots

pivots 매개변수는 요소 쿼리에 대해 피벗해야 하는 측정기준을 정의합니다. view_name.dimension_name 구문을 사용하여 측정기준을 지정합니다. 쿼리에 pivots가 없는 경우 포함하지 마세요.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

limit

limit 매개변수는 요소 쿼리에 사용해야 하는 행 제한을 정의합니다. 이 한도는 피벗이 적용되기 전의 행 수에 적용됩니다.

- name: orders_by_date
  limit: 100

filters

이 섹션에서는 대시보드 요소의 일부인 filters 매개변수를 참조합니다.

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

filters는 filters 파라미터 문서 페이지에 설명된 대로 측정의 일부로 사용할 수도 있습니다.

filters 매개변수는 요소의 쿼리에 사용해야 하는 변경 불가능한 필터를 정의합니다. 사용자가 대시보드에서 변경할 수 있는 필터를 사용하려면 대시보드용 filters를 사용하여 필터를 설정한 다음 listen를 사용하여 요소에 적용해야 합니다.

filters의 구문은 다음과 같습니다.

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

각 필터는 Looker 필터 표현식 또는 값 상수를 허용할 수 있습니다. 필터 표현식에서 _localization 또는 _user_attributes Liquid 변수를 사용하여 유연한 필터 값을 사용할 수도 있습니다.

listen

대시보드 필터를 사용하면 뷰어가 대시보드 요소에 표시되는 데이터를 대화식으로 미세 조정할 수 있습니다. LookML 대시보드의 filters 매개변수를 사용하여 대시보드 필터를 정의합니다. 그런 다음 listen 파라미터를 사용하여 대시보드 요소를 대시보드 필터에 연결합니다.

listen의 문법은 다음과 같습니다.

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

listen 매개변수를 요소에 추가한 다음 view_name.field_name 구문을 사용하여 필터 이름, 콜론, 필터가 적용될 필드 참조를 차례로 제공합니다. 예를 들어 사용자가 UI의 필터 필드에 날짜를 입력해야 하는 날짜라는 필터를 만들 수 있습니다. 그런 다음 사용자가 입력한 값을 다음과 같이 orders_by_date 요소에 적용할 수 있습니다.

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

filters 파라미터와 listen 파라미터를 사용하여 개별 대시보드 요소에 대시보드 필터를 적용하는 추가 예는 LookML 대시보드 빌드를 참고하세요.

query_timezone

query_timezone 매개변수는 쿼리가 실행될 시간대를 지정합니다. 시간대 옵션은 timezone 값 문서 페이지에 표시됩니다. 뷰어의 시간대를 사용하여 쿼리를 실행하려면 값을 user_timezone로 할당하면 됩니다.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

merged_queries

merged_queries 매개변수를 사용하면 여러 쿼리의 결과를 단일 대시보드 요소로 결합할 수 있습니다. 요소의 merged_queries 매개변수 내에서 각 소스 쿼리를 정의하고 join_fields 하위 매개변수를 사용하여 결과를 병합하는 방법을 지정합니다.

다음 샘플 LookML 코드는 병합된 결과 type: looker_grid 요소를 만듭니다. 이 예에서는 merged_queries 매개변수를 사용하여 두 개의 개별 쿼리의 데이터를 단일 표 차트로 결합하는 대시보드 요소를 만듭니다.

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

이 예에서 대시보드 요소는 ecommerce 모델의 users Explore를 기반으로 하는 두 소스 쿼리의 데이터를 결합합니다. 기본 쿼리에는 users.state, users.count, users.city 필드가 포함되어 있으며 users.count 필드를 기준으로 결과를 정렬합니다. 두 번째 소스 쿼리에는 users.state 및 users.city 필드가 포함되어 있으며 users.state 필드를 기준으로 결과를 정렬합니다.

join_field 매개변수는 users.state 및 users.city 필드의 일치하는 값을 기반으로 소스 쿼리를 병합합니다.

listen 매개변수는 두 쿼리에 모두 State 필터를 적용하므로 대시보드 보기 권한 사용자는 특정 주를 선택하여 대시보드 타일에 표시되는 쿼리 결과를 세부적으로 조정할 수 있습니다.

예: 회사 데이터 병합

company_info 및 companies이라는 두 개의 Explore에 있는 회사 정보를 결합하는 병합된 쿼리를 만들려고 한다고 가정해 보겠습니다. 각 탐색 분석의 ipo.stock_symbol, companies.name, companies.contact_email 필드에 대한 쿼리를 결합하여 회사 이름, 회사 연락처 이메일, IPO 연도, 주식 기호, 직원 수, 직업 수를 반환하는 쿼리를 만들려고 합니다. LookML에서 병합된 쿼리 요소를 다음과 같이 정의할 수 있습니다.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

병합된 쿼리 요소에 필터 적용

병합된 쿼리 요소의 이전 예에서는 filters 매개변수를 사용하여 각 소스 쿼리 내에서 하드 코딩된 필터를 직접 적용하는 방법을 보여줍니다. 예를 들어 기본 쿼리의 companies.contact_email: "-NULL" 및 ipo.valuation_amount: NOT NULL 필터는 유효한 연락처 이메일과 평가가 있는 회사로 결과를 제한합니다. 이러한 쿼리 수준 필터는 쿼리를 병합하기 전에 데이터를 사전 필터링하며 사용자가 변경할 수 없습니다.

각 소스 쿼리의 정의 내에서 listen 매개변수를 사용하여 병합된 쿼리 요소에 대시보드 필터를 적용할 수도 있습니다. 예를 들어 LookML 대시보드의 filters 매개변수를 사용하여 대시보드 수준에서 정의한 Industry이라는 대시보드 필터가 있다고 가정해 보겠습니다.

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

두 소스 쿼리의 companies.industry 필드에 Industry 필터를 적용하려면 병합된 쿼리의 소스 쿼리 정의에 각각 listen 매개변수를 다음과 같이 추가합니다.

listen:
  Industry: companies.industry

예를 들어 다음 샘플 코드는 이전 예의 병합된 결과 요소에 있는 두 소스 쿼리에 Industry 필터를 추가합니다.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

이 추가 기능으로 사용자가 Industry 대시보드 필터와 상호작용하면 병합된 쿼리 요소의 해당 소스 쿼리가 그에 따라 필터링됩니다.

플롯 매개변수

이 섹션에 설명된 대부분의 매개변수는 열 차트의 시각화 편집기에 있는 플롯 섹션의 옵션에 해당합니다.

stacking

stacking 매개변수는 계열이 차트에 시각적으로 클러스터링되는 방식을 지정합니다.

  • normal: 일반 누적 열 차트와 같이 막대, 선, 점을 서로 위에 쌓습니다.

  • percent: 막대, 선, 점을 누적하여 차트의 총 채우기를 100% 로 설정하고 y축 값을 백분율로 설정합니다.

  • '': 막대, 선, 점이 누적되지 않고 그룹화됩니다.

stacking: normal | percent | ''

## default value: ''

show_dropoff

show_dropoff 매개변수는 차트 전체에서 변화율 화살표의 모양을 전환합니다. 각 계열에 대해 이러한 화살표는 이전 값의 비율을 왼쪽에서 오른쪽으로 표시합니다.

show_dropoff: true | false

## default value: false

ordering

ordering 매개변수를 사용하면 각 슬라이스 크기별로 누적 또는 누적 비율 차트의 각 슬라이스를 정렬할 수 있습니다.

  • none (또는 값이 지정되지 않음): 계열 값이 데이터 테이블의 위치에 따라 정렬됩니다.
  • asc: 가장 작은 계열 값이 하단에 배치되고 열 스택의 상단으로 갈수록 값이 증가합니다.
  • desc: 가장 큰 값이 하단에 배치되고 상단으로 갈수록 값이 작아집니다.

column_spacing_ratio

column_spacing_ratio 매개변수는 그룹 내 열 사이의 간격을 설정합니다. LookML에서 ''를 사용하여 지정된 기본 그룹화 설정으로 stacking가 설정된 차트에 사용할 수 있습니다. 이 매개변수는 0~1 사이의 값을 허용합니다. 0는 그룹 내 열 사이의 최소 간격과 연결되고 1는 그룹 내 열 사이의 최대 간격과 연결됩니다.


column_space_ratio: number between 0 and 1

column_group_spacing_ratio

column_group_spacing_ratio 매개변수는 열 그룹 사이의 간격을 설정합니다. 이 매개변수는 0~1 사이의 값을 허용합니다. 0는 열 그룹 간의 최소 간격과 연결되고 1는 열 그룹 간의 최대 간격과 연결됩니다.


column_group_spacing_ratio: number between 0 and 1

hide_legend

이 선언은 시각화에서 범례를 숨깁니다.

hide_legend: true | false

## default value: false

legend_position

hide_legend이 false로 설정되어 있고 계열이 두 개 이상인 경우 legend_position 매개변수를 사용하여 계열 범례를 차트 왼쪽, 가운데, 오른쪽에 표시할지 지정할 수 있습니다.

legend_position: center | left | right

## default value: false

hidden_fields

hidden_fields 매개변수는 쿼리에서 사용되지만 차트에서 숨겨진 필드를 나타냅니다(있는 경우). 숨겨진 필드는 Explore의 데이터 테이블 섹션에 표시됩니다.

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

limit_displayed_rows 매개변수를 사용하면 결과 내 위치에 따라 시각화에서 행을 표시하거나 숨길 수 있습니다. 예를 들어 시각화에 7일 이동 평균이 표시될 경우 처음 6개 행을 숨길 수 있습니다. 이 값을 true로 설정하면 limit_displays_rows_values 매개변수와 하위 매개변수를 사용하여 이 값이 적용되는 시각화의 값과 위치를 지정할 수 있습니다.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

limit_displayed_rows와 함께 limit_displayed_rows_values 매개변수와 하위 매개변수 show_hide, first_last, num_rows를 사용하여 시각화에서 표시하거나 숨길 행을 지정합니다. 샘플 사용은 limit_displayed_rows 섹션을 참고하세요.

show_hide

show_hide 하위 매개변수는 시각화에서 특정 행을 숨길지 여부를 설정합니다. 시각화에 제한된 행 수만 표시하려면 show_hide를 show로 설정하고, 시각화에서 특정 행을 제외하려면 show_hide를 hide로 설정합니다.

first_last

first_last 하위 매개변수는 숨기거나 표시할 행이 결과 집합에서 첫 번째 행인지 마지막 행인지를 설정합니다. first_last을 first로 설정하면 첫 번째 행이 표시되거나 숨겨지고, first_last을 last로 설정하면 마지막 행이 표시되거나 숨겨집니다.

num_rows

num_rows 하위 매개변수는 숨기거나 표시할 행 수를 설정합니다. 예를 들어 num_rows: '10'는 시각화에서 결과 집합의 처음 또는 마지막 10개 행을 표시하거나 숨깁니다.

시리즈 매개변수

이 섹션에 설명된 매개변수는 열 차트의 시각화 편집기 계열 섹션의 옵션에 해당합니다.

colors

colors 매개변수는 계열의 색상 목록을 지정합니다. 목록의 첫 번째 색상은 첫 번째 데이터 계열에 해당합니다. 나열된 색상보다 계열이 더 많으면 색상이 처음부터 다시 시작됩니다.


colors: [blue, orange, yellow, red, purple]

색상을 지정하는 모든 차트 속성의 경우 색상 값은 #2ca6cd와 같은 16진수 문자열 또는 mediumblue와 같은 CSS 이름 지정 색상 문자열을 사용할 수 있습니다.

series_colors

name: value 쌍을 사용하여 계열 이름에 따라 계열의 색상을 설정합니다.

피벗된 차트의 경우 계열 이름은 피벗 이름입니다.

series_colors:
  'Yes': skyblue
  'No': '#000000'

측정값이 여러 개인 차트의 경우 계열 이름은 측정값 필드 이름입니다.

series_colors:
  inventory_items.count: crimson
  orders.count: green

계열 이름이 series_colors에 나열되지 않으면 차트가 colors에 제공된 색상 목록으로 기본 설정됩니다. colors이 설정되지 않은 경우 차트는 기본 색상 구성표로 대체됩니다.

series_labels

name: label 쌍을 사용하여 계열 이름을 기반으로 하나 이상의 계열의 라벨을 설정합니다.

피벗된 차트의 경우 계열 이름은 피벗 이름입니다.

series_labels:
  'Yes': iOS Users
  'No': Android Users

측정값이 여러 개인 차트의 경우 계열 이름은 측정값 필드 이름입니다.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

series_types

series_type 매개변수를 사용하면 동일한 시각화에서 다양한 데카르트 좌표계 차트 유형을 사용할 수 있습니다. 이 매개변수를 사용하여 변경할 각 계열에 차트 유형을 할당합니다. 유형 옵션은 line, column, bar, area, scatter입니다.

series_types:
  series_a_name: column
  series_b_name: line

모든 계열은 선택한 초기 차트 유형으로 기본 설정되며, 이후에 개별 계열을 수정할 수 있습니다.

show_view_names

show_view_names 매개변수는 축 이름, 열 이름과 같은 차트 라벨에 뷰 이름이 표시되는지 여부를 결정합니다.

show_view_names: true | false

## default value: true

값 매개변수

이 섹션에 설명된 매개변수는 열 차트의 시각화 편집기에서 값 섹션의 옵션에 해당합니다.

show_value_labels

데이터 포인트 옆에 막대, 선 또는 점의 값을 표시합니다.

show_value_labels: true | false

## default value: false

show_null_labels

show_value_labels이 true로 설정된 경우 null 열 또는 막대에 라벨을 표시할지 여부를 결정합니다.

show_null_labels: true | false

## default value: false

labelColor

labelColorEnabled이 true로 설정된 경우 labelColor 매개변수를 사용하여 라벨과 비율의 맞춤 색상을 지정합니다. labelPosition이 inline로 설정된 라벨은 선택한 색상으로 표시되고 차트 양쪽의 라벨은 선택한 색상보다 약 40% 더 어두워집니다.


labelColor: "#4FBC89"

font_size

10px 또는 12px과 같은 유효한 CSS 크기를 사용하여 값 라벨의 글꼴 크기를 설정합니다.


font_size: 14px

label_rotation

값 라벨의 순환을 설정합니다. 이 매개변수에는 -360에서 360 사이의 값이 사용됩니다. 이러한 숫자는 라벨을 순환하는 도수를 의미합니다. 이 매개변수는 stacking가 기본값 ('')으로 설정된 경우에만 사용할 수 있습니다.


label_rotation: -45

label_value_format

label_value_format 매개변수는 기본 측정기준 또는 측정값에 적용된 형식과 관계없이 값에 적용할 형식을 지정합니다. 이 필드에는 Excel 스타일의 형식이 사용됩니다. label_value_format를 지정하지 않으면 값이 기본 측정기준 또는 측정값 형식으로 표시됩니다.

숫자 필드에 커스텀 형식 추가 문서 페이지에서 이러한 형식을 지정하는 방법을 자세히 알아보세요. 하지만 Looker에서는 색상 형식이 지원되지 않습니다.

label_value_format LookML 대시보드 매개변수에 사용된 형식은 value_format LookML 매개변수에 사용된 형식과 동일하지만, value_format LookML 매개변수를 사용하기 위해서는 형식 지정 문자열을 큰따옴표로 묶어야 합니다.


label_value_format: '0.00'

show_totals_labels

차트에서 데이터 포인트의 각 스택 그룹에 총계를 표시할지 여부를 설정합니다. 이 매개변수는 stacking가 normal로 설정된 경우에만 사용할 수 있습니다.


show_totals_labels: true | false

hidden_series

hidden_series 매개변수는 차트에서 사용 중지될 계열을 지정합니다. 즉, 계열이 차트 범례에 표시되지만 회색으로 표시됩니다. 사용자는 차트 범례에서 사용 중지된 계열을 클릭하여 사용 설정할 수 있습니다. 따라서 hidden_series이 hide_legend: true과 함께 원하는 대로 작동하지 않을 수 있습니다.

피벗된 차트의 경우 계열 이름은 피벗 이름입니다.

hidden_series: ['Yes', 'No']

측정항목이 여러 개인 차트의 경우 계열 이름은 측정항목 필드 이름입니다.

hidden_series: [inventory_items.count, orders.count]

show_silhouette 매개변수와 함께 사용하면 사용 중지된 계열이 차트 자체에 옅은 음영으로 표시되는지 여부를 지정할 수 있습니다.

show_silhouette

show_silhouette 매개변수가 true로 설정되고 stacking이 normal로 설정되면 사용 중지된 계열이 약간의 음영이 있는 실루엣으로 표시됩니다.


show_silhouette: true | false

totals_color

이 매개변수는 차트의 총계 라벨 색상을 정의합니다. totals_color 매개변수는 stacking이 normal로 설정된 경우에만 사용할 수 있습니다.


totals_color: "#2ca6cd"

X축 매개변수

이 섹션에 설명된 매개변수는 열 차트의 시각화 편집기 X 섹션의 옵션에 해당합니다.

x_axis_scale

이 매개변수는 x축 배율이 계산되는 방식을 결정합니다.

  • auto: 기본 데이터로부터 배율이 추론됩니다. 기본 설정입니다.
  • ordinal: 데이터가 균일한 간격의 개별 항목으로 표시됩니다.
  • time: 데이터가 시간으로 표시되고 축에 적절한 라벨이 지정됩니다. 기본 데이터를 날짜로 변환할 수 없는 경우 이 방법은 작동하지 않습니다.
x_axis_scale: auto | ordinal | time

## default value: auto

x_axis_reversed

이 매개변수는 x축의 방향을 설정합니다. x_axis_reversed이 false로 설정되면 값이 왼쪽에서 오른쪽으로 증가합니다. true로 설정하면 값이 왼쪽에서 오른쪽으로 감소합니다.


x_axis_reversed: true | false

show_x_axis_label

이 매개변수는 x축에 라벨을 표시할지 여부를 결정합니다.

show_x_axis_label: true | false

## default value: true

x_axis_label

이 매개변수는 x축의 라벨을 지정합니다. show_x_axis_label이 true로 설정된 경우 이 매개변수를 사용할 수 있습니다.

x_axis_label: Order Date

show_x_axis_ticks

이 매개변수는 X축에 값 라벨을 표시할지 여부를 결정합니다.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

이 매개변수는 격자선이 x축에서 확장되는지 여부를 결정합니다.

x_axis_gridlines: true | false

## default value: false

x_axis_label_rotation

x_axis_label_rotation 매개변수는 x축 라벨의 회전을 각도로 정의합니다. 이 매개변수에는 -360에서 360 사이의 값이 사용됩니다. 이러한 숫자는 라벨을 순환하는 도수를 의미합니다.

x_axis_label_rotation: -45

x_axis_datetime_label

이 매개변수는 x축 라벨이 날짜인 경우 x축 라벨의 형식 문자열을 지정합니다. x_axis_scale이 time로 설정되지 않은 경우 아무 작업도 실행되지 않습니다.


x_axis_datetime_label: '%b %d'

시간 형식 지정에 대한 자세한 내용은 차트의 시간 형식 지정 문서 페이지를 참고하세요.

x_axis_zoom

이 매개변수는 사용자가 시각화의 x축을 확대할 수 있는지 여부를 지정합니다. x_axis_zoom이 true로 설정된 경우 확대/축소가 가능합니다. x_axis_zoom이 false로 설정된 경우 확대/축소는 사용할 수 없습니다.

x_axis_zoom이 false로 설정되면 y_axis_zoom이 사용 중지됩니다.

x_axis_zoom: true | false

# default value: true

Y축 파라미터

공사 중: 페이지의 이 섹션을 업데이트하는 중입니다. 그동안 열 차트 옵션 문서 페이지에서 y축에 해당하는 시각화 메뉴 옵션을 확인하세요.

이 섹션에 설명된 매개변수는 열 차트의 시각화 편집기 Y 섹션의 옵션에 해당합니다.

y_axis_gridlines

이 매개변수는 격자선이 y축에서 확장되는지 여부를 결정합니다.

y_axis_gridlines: true | false

## default value: true

y_axis_reversed

이 매개변수는 y축의 방향을 설정합니다. y_axis_reversed가 false로 설정되면 값이 축을 따라 위로 증가합니다. true로 설정하면 값이 축을 따라 아래로 감소합니다.


## y_axis_reversed: true | false

# default value: false

reference_lines

이 매개변수는 참조선과 영역을 지정하는 값의 배열을 지정합니다.

참조선 설정에 대한 자세한 내용은 대시보드 참조선 파라미터 문서 페이지를 참고하세요.


reference_lines:
   # reference line options

y_axis_zoom

이 매개변수는 사용자가 시각화의 y축을 확대할 수 있는지 여부를 지정합니다. y_axis_zoom이 true로 설정된 경우 확대/축소가 가능합니다.

y_axis_zoom이 false로 설정되면 사용자는 y축의 작은 부분을 확대할 수 없습니다. 하지만 x_axis_zoom 매개변수가 true로 설정된 경우 사용자는 x축의 더 작은 부분으로 확대할 수 있습니다.

x_axis_zoom이 false로 설정되면 y_axis_zoom이 사용 중지됩니다.

y_axis_zoom: true | false

# default value: true

고급 시각화 구성 매개변수

이 섹션에 설명된 매개변수는 시각화 편집기의 플롯 섹션에서 차트 구성 수정 버튼을 클릭하여 차트에 적용할 수 있는 선택적 차트 구성 재정의에 해당합니다.

advanced_vis_config

이 매개변수는 여러 시각화 설정을 재정의하고 새로운 기능을 제공하는 HighCharts JSON 스니펫을 허용합니다. HighCharts JSON을 사용하여 일반적인 사용 사례를 달성하는 예시는 차트 구성 편집기를 사용하여 시각화 맞춤설정 문서 페이지를 참고하세요.


advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null