이 페이지에서는 dashboard.lkml
파일의 LookML 대시보드 매개변수를 사용하여 type: looker_map
의 LookML 대시보드 요소를 만들고 수정하기 위한 매개변수를 설명합니다.
Looker UI를 통해 대화형 지도 차트를 작성하는 방법에 대한 자세한 내용은 지도 차트 옵션 문서 페이지를 참조하세요. 대화형 지도 차트를 만드는 데 필요한 필드 유형에 대한 자세한 내용은 아래의 쿼리 매개변수 섹션을 참고하세요.
사용 예시
N
는 숫자 값이 필요함을 나타냅니다. 작은따옴표는 설명 텍스트이며 실시간 코드에 포함해서는 안 됩니다.
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_map
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
fields: [view_name.field_name, view_name.field_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'
listen:
dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
## PLOT PARAMETERS
map_plot_mode: points | automagic_heatmap | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: 'number between 0 and 1'
## MAP PARAMETERS
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
satellite | streets | outdoors | traffic_day | traffic_night
map_position: fit_data | custom
map_latitude: 'latitude value'
map_longitude: 'longitude value'
map_zoom: N
map_scale_indicator: 'off' | metric | imperial | metric_imperial
map_pannable: true | false
map_zoomable: true | false
show_view_names: true | false
show_legend: true | false
show_region_field: true | false
draw_map_labels_above_data: true | false
## POINT PARAMETERS
map_marker_type: circle | icon | circle_and_icon | none
map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
building | camera | car | checkmark | coffee | comment | envelope | file |
gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
microphone | music | person | phone | restaurant | school | shopping_cart |
star | suitcase | taxi | tree | trophy | truck | university | wrench
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed: N
map_marker_radius_min: N
map_marker_radius_max: N
map_marker_proportional_scale_type: linear | log
map_marker_units: meters | pixels
map_marker_color_mode: value | fixed
map_marker_color: ['color value']
## VALUE PARAMETERS
map_value_colors: ['one or more color values']
quantize_map_value_colors: true | false
reverse_map_value_colors: true | false
map_value_scale_clamp_min: N
map_value_scale_clamp_max: N
매개변수 정의
매개변수 이름 | 설명 | |
---|---|---|
기본 매개변수 | ||
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 (요소용) |
요소의 쿼리에 사용할 탐색을 정의합니다. | |
fields |
요소의 쿼리에 사용할 필드를 정의합니다. dimensions 및 measures 대신 사용할 수 있습니다. |
|
dimensions |
요소의 쿼리에 사용할 측정기준을 정의합니다. | |
measures |
요소의 쿼리에 사용할 측정값을 정의합니다. | |
sorts |
요소의 쿼리에 사용할 정렬을 정의합니다. | |
pivots |
요소의 쿼리에 사용하도록 피봇팅해야 하는 측정기준을 정의합니다. | |
limit |
요소의 쿼리에 사용할 행 한도를 정의합니다. | |
column_limit |
요소의 쿼리에 사용할 열 한도 정의 | |
filters (요소용) |
요소의 쿼리에 대해 변경할 수 없는 필터를 정의합니다. | |
listen |
filters (대시보드용)이 생성된 경우 요소의 쿼리에 대해 변경할 수 있는 필터를 정의합니다. |
|
query_timezone |
쿼리 실행 시 사용해야 하는 시간대를 정의합니다. | |
플롯 매개변수 | ||
map_plot_mode |
type: looker_map 요소에 위치 데이터를 표시하는 방식을 정의합니다. |
|
heatmap_gridlines |
히트맵 요소에 사용되는 각 격자선 주위에 테두리 추가 | |
heatmap_gridlines_empty |
heatmap_gridlines 가 true 로 설정된 히트맵의 경우 연결된 데이터가 없는 지도 지역의 윤곽선을 표시합니다. |
|
heatmap_opacity |
히트맵에 사용되는 색상의 불투명도를 정의합니다. | |
지도 매개변수 | ||
map_tile_provider |
백그라운드 지도의 유형 및 지도 라벨의 표시 여부를 정의합니다. | |
map_position |
표시되는 지도의 중심점과 확대/축소 수준을 정의합니다. | |
map_latitude |
map_position 이 custom 로 설정된 지도의 위도를 정의합니다. |
|
map_longitude |
map_position 이 custom 로 설정된 지도의 경도를 정의합니다. |
|
map_zoom |
map_position 가 custom 로 설정된 지도의 확대/축소를 정의합니다. |
|
map_scale_indicator |
지도 축척 표시 여부와 표시 단위 유형을 설정합니다. | |
map_pannable |
사용자가 지도를 드래그하여 위치를 변경할 수 있는지를 설정합니다. | |
map_zoomable |
사용자가 지도를 확대/축소할 수 있는지 여부를 설정합니다. | |
show_view_names |
지도 도움말에 필드 이름을 뷰 이름과 함께 표시할지 여부를 설정합니다. | |
show_legend |
시각화의 오른쪽 하단에 지도 범례를 표시할지 여부를 설정합니다. | |
show_region_field |
지도의 도움말에 지역 정보를 표시할지 여부를 설정합니다. | |
draw_map_labels_above_data |
히트맵 위 또는 아래에 지도의 라벨을 표시합니다. | |
포인트 매개변수 | ||
map_marker_type |
map_plot_mode 이 points , lines 또는 areas 로 설정된 요소의 경우 지도에 표시되는 점의 유형을 지정합니다. |
|
map_marker_icon_name |
map_marker_type 이 icon 또는 circle_and_icon 로 설정된 요소의 모든 지도 마커에 표시할 아이콘의 유형을 지정합니다. |
|
map_marker_radius_mode |
map_marker_type 이 circle 또는 circle_and_icon 로 설정된 요소의 경우 원의 크기 조절 방식을 설정합니다. |
|
map_marker_radius_fixed |
map_marker_type 이 circle 또는 circle_and_icon 로 설정되고 map_marker_radius_mode 가 fixed 로 설정된 요소의 모든 지도 마커에 적용할 고정 반경을 설정합니다. |
|
map_marker_radius_min |
map_marker_radius_mode 이 proportional_value 로 설정된 요소의 원의 최소 반경을 설정합니다. |
|
map_marker_radius_max |
map_marker_radius_mode 이 proportional_value 로 설정된 요소의 원의 최대 반경을 설정합니다. |
|
map_marker_proportional_scale_type |
원 크기가 map_marker_type 을 circle 또는 circle_and_icon 로, map_marker_radius_mode 이 proportional_value 으로 설정된 요소의 선형 배율 또는 로그 배율을 지정합니다. |
|
map_marker_units |
map_marker_type 이 circle 또는 circle_and_icon 로 설정된 요소의 경우 원의 반지름에 사용되는 단위를 meters 또는 pixels 로 설정합니다. |
|
map_marker_color_mode |
기본 마커의 값을 기반으로 지도 마커의 색상을 고정할지 또는 마커에 동적으로 색상을 할당할지를 지정합니다. | |
map_marker_color |
map_marker_color_mode 이 fixed 로 설정된 요소의 모든 지도 마커에 적용할 단일 색상을 지정합니다. |
|
값 매개변수 | ||
map_value_colors |
지도 상의 색상을 지정하거나 측정값에 따라 색상을 코딩하는 경우 사용할 색상 범위를 정의합니다. | |
quantize_map_value_colors |
색상 스케일을 부드러운 그라데이션에서 설정한 특정 색상으로만 변경 | |
reverse_map_value_colors |
차트에서 높은 값과 낮은 값을 나타내는 색상을 전환하여 색상 그라디언트를 바꿉니다. | |
map_value_scale_clamp_min |
색상 범위의 최솟값을 설정합니다. | |
map_value_scale_clamp_max |
색상 범위의 최댓값을 설정합니다. |
기본 매개변수
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행으로 설정되거나 기본으로 설정된 다른 요소의 2배로 설정됩니다.
- 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
쿼리 매개변수의 값을 지정해야 합니다.
type: looker_map
의 LookML 대시보드 요소에는 적어도 하나의 지리적 필드를 dimensions
또는 fields
매개변수의 값으로 지정해야 합니다. 지리적 필드는 다음 중 하나일 수 있습니다.
- 위도 및 경도 데이터를 기반으로 하는 측정기준으로, LookML에서
type: location
의 측정기준으로 정의됩니다. - 지도 레이어가 할당된 측정기준. LookML 개발자는 내장 지도 레이어 또는 맞춤 지도 레이어를
map_layer_name
매개변수를 사용하여 측정에 추가할 수 있습니다. - 우편번호 측정기준입니다. 우편번호 지역은 2010년 우편번호 표적 지역 (ZCTA)을 기준으로 합니다. 우편번호를 시각화하는 경우 우편번호와 지도 시각화에 사용되는 ZCTA 간에 일대일 대응이 이루어지지 않을 수 있으므로 지도에서 모든 지점이 시각화되는 것은 아닙니다.
아래에 설명된 다른 쿼리 매개변수를 사용하여 데이터가 대시보드 요소에 표시되는 방식을 제어할 수도 있습니다. Looker UI를 사용하여 대화형 지도 차트를 작성하기 위한 요구사항에 대한 자세한 내용은 지도 차트 옵션 문서 페이지의 대화형 지도 차트 만들기 섹션을 참고하세요.
model
model
매개변수는 요소 쿼리에 사용할 모델을 정의합니다. 지정하지 않으면 대시보드가 있는 모델로 기본 설정됩니다.
- name: orders_by_date
model: ecommerce
model
매개변수는 LookML 상수를 허용합니다. 프로젝트의 매니페스트 파일에 상수를 정의한 다음 "@{constant_name}"
구문을 사용하여 상수를 model
값으로 설정할 수 있습니다. 상수를 사용하면 모델의 이름을 한곳에 정의할 수 있습니다. 이는 여러 대시보드 요소에서 사용되는 모델의 이름을 업데이트하는 경우에 특히 유용합니다.
자세한 내용과 LookML 대시보드에서 상수를 사용하는 예는 constant
매개변수 문서 페이지를 참고하세요.
explore
이 섹션에서는 대시보드 요소의 일부인
explore
매개변수를 설명합니다.
explore
는explore
매개변수 문서 페이지에 설명된 대로 모델의 일부로 사용할 수도 있습니다.
explore
은 대시보드 매개변수 문서 페이지에 설명된 대시보드 필터의 일부로 사용할 수도 있습니다.
explore
매개변수는 요소 쿼리에 사용할 탐색을 정의합니다.
- name: orders_by_date
explore: order
explore
매개변수는 LookML 상수를 허용합니다. 프로젝트의 매니페스트 파일에 상수를 정의한 다음 "@{constant_name}"
구문을 사용하여 상수를 explore
값으로 설정할 수 있습니다. 상수를 사용하면 탐색 이름을 한 곳에서 정의할 수 있습니다. 이는 여러 대시보드 요소에서 사용되는 탐색의 이름을 업데이트하는 경우에 특히 유용합니다.
자세한 내용과 LookML 대시보드에서 상수를 사용하는 예는 constant
매개변수 문서 페이지를 참고하세요.
fields
fields
매개변수는 요소 쿼리에 사용할 필드를 정의합니다. view_name.dimension_name
구문을 사용하여 필드를 지정하세요.
## single field example
- name: orders_by_date
fields: order.order_date
## multiple fields example
- name: orders_by_date
fields: [order.order_date, order.order_count]
fields
매개변수를 사용하면 dimensions
및 measures
매개변수를 사용할 필요가 없습니다.
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
column_limit
column_limit
매개변수는 요소 쿼리에 사용해야 하는 열 한도를 정의합니다. 이 한도는 피봇이 적용된 후에 열 수에 적용됩니다.
- name: orders_by_date
column_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
대시보드에는 사용자가 대시보드 요소 뒤의 데이터를 변경할 수 있는 필터가 있습니다. 이는 대시보드용 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
예를 들어 사용자가 UI의 필터 입력란에 날짜를 입력해야 하는 날짜라는 필터를 만들 수 있습니다. 그런 다음 사용자가 입력하는 값을 다음과 같이 orders_by_date
요소에 적용할 수 있습니다.
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
이 개념은 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
플롯 매개변수
이 섹션에 설명된 매개변수는 지도 차트에 대한 시각화 편집기의 플롯 섹션에 있는 옵션에 해당합니다.
type: looker_map
요소에 사용할 수 있는 매개변수는 쿼리에 type: location
측정기준이 포함되었는지 또는 지도 레이어가 연결되어 있는지에 따라 다릅니다.
map_plot_mode
map_plot_mode
매개변수는 type: location
차원을 기반으로 하는 type: looker_map
요소에 데이터가 표시되는 방식을 정의합니다. 이 매개변수는 연결된 지도 레이어를 사용한 측정기준 또는 우편번호 측정기준에 사용할 수 없습니다. map_plot_mode
매개변수는 다음 값을 허용합니다.
points
map_plot_mode
를 points
로 설정하면 기본 데이터 테이블의 각 행이 지도에 개별 지점으로 표시됩니다.
지도 상의 자체 위치와 동일한 색상의 장소에 type: location
측정기준을 적용합니다. 쿼리에 측정값을 추가하면 map_marker_radius_mode
및 map_marker_color_mode
매개변수를 사용하여 점을 색상 또는 크기로 조정할 수 있습니다.
automagic_heatmap
map_plot_mode
를 automagic_heatmap
로 설정하면 기본 쿼리의 데이터가 히트맵 그리드로 표시됩니다. 이 방식은 표시된 지도를 동일한 정사각형으로 나눈 다음 각 정사각형에 적합한 데이터 값을 계산하는 방식으로 이루어집니다. 정사각형은 선택한 측정값에 따라 색상이 지정됩니다. 이 지도를 확대하거나 축소하면 확대/축소 수준에 적합한 세분성으로 Looker가 그리드를 재계산합니다.
쿼리에 type: location
의 측정기준과 이 플롯 유형의 측정값이 모두 올바르게 포함되어야 합니다.
lines
map_plot_mode
를 lines
로 설정하면 쿼리에서 두 가지 측정기준인 type: location
를 가져와 시각화에서 서로 연결합니다. 쿼리에 측정치를 추가하면 선에 색상 스케일을 추가할 수 있습니다.
areas
map_plot_mode
을(를) areas
(으)로 설정하면 한 가지 측정기준인 type: location
을 사용하여 정렬한 모든 점이 연결됩니다. 이는 지도 요소에서 지역의 경계를 형성합니다. 쿼리에 측정치를 추가하면 영역의 경계를 구성하는 개별 위치 지점의 크기와 색상 형식을 지정할 수 있습니다.
heatmap_gridlines
히트맵 요소의 경우 heatmap_gridlines
을 true
로 설정하면 히트맵에 사용되는 각 격자선 주위에 테두리가 추가됩니다. 이 매개변수는 map_plot_mode
이 automagic_heatmap
로 설정된 type: location
의 측정기준을 표시하거나 우편번호 레이어 또는 측정기준을 연결된 지도 레이어가 표시되는 경우에 사용할 수 있습니다.
heatmap_gridlines: true | false
heatmap_gridlines_empty
히트맵 요소에 heatmap_gridlines
가 true
로 설정된 경우 heatmap_gridlines_empty
를 true
로 설정하면 연결된 데이터가 없는 지도 지역의 윤곽선이 표시됩니다.
heatmap_gridlines_empty: true | false
heatmap_opacity
히트맵 요소의 경우 heatmap_opacity
를 사용하여 히트맵에 사용되는 색상의 불투명도를 지정할 수 있습니다. 0과 1 사이의 숫자를 heatmap_opacity
값으로 지정합니다. 여기서 0
은 색상이 없음을 의미하고 1
은 완전 불투명을 의미합니다.
heatmap_opacity: 0.5
지도 매개변수
이 섹션에 설명된 대부분의 매개변수는 열 차트의 시각화 편집기 지도 섹션에 있는 옵션에 해당합니다.
map_tile_provider
모든 지도에서 사용할 수 있는 map_tile_provider
매개변수를 사용하면 백그라운드 지도 유형을 변경하고 도시 및 거리와 같은 지도 라벨을 표시할지 지정할 수 있습니다.
light
: 데이터를 강조표시하는 동안 지리적 컨텍스트를 제공하도록 설계된 밝은 색의 은은한 지도light_no_labels
:light
와 동일하지만 지도에서 도시 이름과 같은 라벨이 생략됩니다.dark
: 데이터를 강조표시하는 동시에 지리적 컨텍스트를 제공하도록 설계된 은은한 색이 있는 지도입니다.dark_no_labels
:dark
와 동일하지만 지도에서 도시 이름과 같은 라벨이 생략됩니다.satellite_streets
: 글로벌 위성 및 항공 이미지를 표시하는 지도satellite
:satellite_streets
와 동일하지만 지도에서 도시 이름과 같은 라벨이 생략됩니다.streets
: 읽을 수 있는 도로 및 대중교통 네트워크의 스타일을 강조하는 범용 지도outdoors
: 하이킹, 자전거, 기타 실외 용도로 사용할 수 있는 범용 지도traffic_day
: 현재 교통 정보를 비롯하여 대중교통 네트워크 및 도로를 강조하는 밝은 색상의 지도traffic_night
: 현재 교통 정보를 포함한 대중교통 네트워크 및 도로를 강조하는 어두운 색상의 지도
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
satellite | streets | outdoors | traffic_day | traffic_night
map_position
map_position
매개변수를 사용하여 표시되는 지도의 중심점과 확대/축소 수준을 설정할 수 있습니다. 이 위치 지정에는 두 가지 옵션이 있습니다.
fit_data
: 쿼리의 모든 데이터 포인트가 표시되도록 지도의 중심을 자동으로 지도의 중앙에 맞춥니다.custom
:map_latitude
,map_longitude
및map_zoom
매개변수를 사용하여 위도, 경도, 확대/축소 수준을 수동으로 지정할 수 있습니다.
map_position: fit_data | custom
map_latitude
map_latitude
매개변수는 map_position
가 custom
로 설정된 지도 요소의 위도를 지정합니다.
map_latitude: -5.804047131379801
map_longitude
map_longitude
매개변수는 map_position
가 custom
로 설정된 지도 요소의 경도를 지정합니다.
map_longitude: 113.34732055664064
map_zoom
map_zoom
매개변수를 사용하면 map_position
를 custom
로 설정하여 지도 요소의 확대/축소 수준을 지정할 수 있습니다. 숫자가 높을수록 확대/축소 수준이 낮아집니다.
map_zoom: 10
map_scale_indicator
기본적으로 'off'
로 설정되는 map_scale_indicator
매개변수를 사용하면 지도 축척을 표시할지 여부를 표시하고 표시되는 단위 유형을 설정할 수 있습니다.
map_scale_indicator: 'off' | metric | imperial | metric_imperial
map_pannable
map_pannable
매개변수는 사용자가 지도를 드래그하여 위치를 변경할 수 있는지를 지정합니다. 이 옵션은 기본적으로 사용 설정됩니다.
map_pannable: true | false
map_zoomable
map_zoomable
매개변수는 사용자가 지도 요소를 확대 및 축소할 수 있는지 여부를 지정합니다. 이 옵션은 기본적으로 사용 설정됩니다.
map_zoomable: true | false
show_view_names
show_view_names
매개변수는 사용자가 지도 데이터 포인트를 클릭할 때 표시되는 지도 도움말에 뷰 이름과 필드 이름을 표시할지 여부를 지정합니다.
show_view_names: true | false
show_legend
시각화의 오른쪽 하단에 지도 범례를 표시할지 여부를 지정합니다. 시각화에 측정값을 추가한 경우 범례에는 사용 중인 색상 스케일이 표시됩니다.
show_legend
매개변수는 다음 플롯 옵션이 지정되면 사용할 수 있습니다.
map_plot_mode
을automagic_heatmap
로 설정한 경우map_plot_mode
를points
로 설정하고map_marker_color_mode
을value
로 설정한 경우
show_legend: true | false
show_region_field
지도 레이어 또는 우편번호를 기반으로 하는 지도의 경우 show_region_field
매개변수가 지도의 도움말에 정보를 표시합니다. 사용자는 지도에서 한 지점을 클릭하여 지역 이름을 볼 수 있습니다.
show_region_field: true | false
draw_map_labels_above_data
지도 레이어 지도 또는 우편번호 측정기준을 기반으로 하는 지도의 경우 draw_map_labels_above_data
매개변수를 사용하여 지도의 라벨을 히트맵 위 또는 아래에 표시할 수 있습니다. 이는 히트맵 불투명 값이 높은 경우에 특히 중요합니다. 히트맵이 불투명한 경우 데이터 위에 표시되지 않는 한 라벨이 표시되지 않습니다.
draw_map_labels_above_data: true | false
포인트 매개변수
map_plot_mode
이 automagic_heatmap
로 설정된 지도에서는 지점 옵션을 사용할 수 없습니다.
map_marker_type
위치 측정기준을 기반으로 하고 map_plot_mode
를 points
, lines
, areas
로 설정한 지도의 경우 map_marker_type
매개변수는 지도 요소에 표시되는 지점의 유형을 정의합니다. map_marker_type
매개변수는 다음 값을 허용합니다.
circle
icon
circle_and_icon
none
map_marker_type
에 지정한 값은 지도에 표시된 지점의 형식을 지정하는 데 사용할 수 있는 매개변수에 영향을 줍니다.
map_marker_icon_name
map_marker_type
를 icon
또는 circle_and_icon
로 설정한 경우 map_marker_icon_name
매개변수를 사용하여 모든 지도 마커에 표시할 아이콘 유형을 설정할 수 있습니다.
map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
building | camera | car | checkmark | coffee | comment | envelope | file |
gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
microphone | music | person | phone | restaurant | school | shopping_cart |
star | suitcase | taxi | tree | trophy | truck | university | wrench
map_marker_radius_mode
map_marker_type
가 circle
또는 circle_and_icon
로 설정된 지도의 경우 map_marker_radius_mode
매개변수를 사용하여 원의 크기를 다음 옵션에 따라 설정할 수 있습니다.
proportional_value
: 이 옵션은 쿼리에 추가한 측정값에 따라 원의 상대적 크기를 조정합니다. 이 옵션과 함께map_marker_radius_min
및map_marker_radius_max
매개변수를 사용하여 원의 최소 반경과 최대 반경을 설정할 수 있습니다.map_marker_proportional_scale_type
매개변수를 사용하여 선형 크기를 조정하는 데 사용할지 로그의 크기를 사용할지 여부를 설정할 수도 있습니다.equal_to_value
: 이 설정은 원의 반지름을 기본 쿼리의 실제 측정 값에 맞게 조정합니다.fixed
: 이 옵션을 사용하면map_marker_radius_fixed
매개변수를 사용하여 모든 지도 마커에 적용할 고정 반경을 설정할 수 있습니다. 기본값은500
입니다.
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed
map_marker_radius_mode
를 fixed
로, map_marker_type
를 circle
또는 circle_and_icon
로 설정한 경우 map_marker_radius_fixed
매개변수를 사용하여 모든 지도 마커에 적용되는 고정 반경을 설정할 수 있습니다.
map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60
map_marker_radius_min
map_marker_type
을 circle
또는 circle_and_icon
로 설정하고 map_marker_radius_mode
를 proportional_value
로 설정한 지도의 경우 map_marker_radius_min
매개변수를 사용하여 원의 최소 반경을 정의할 수 있습니다.
map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5
map_marker_radius_max
map_marker_type
을 circle
또는 circle_and_icon
로 설정하고 map_marker_radius_mode
를 proportional_value
로 설정한 지도의 경우 map_marker_radius_max
매개변수를 사용하여 원의 최대 반경을 정의할 수 있습니다.
map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50
map_marker_proportional_scale_type
map_marker_type
를 circle
또는 circle_and_icon
로 설정하고 map_marker_radius_mode
를 proportional_value
로 설정한 지도의 경우 map_marker_proportional_scale_type
매개변수를 사용하여 원 크기를 선형 배율 또는 로그 배율을 기준으로 설정할 수 있습니다. 이 매개변수의 값은 linear
또는 log
입니다.
map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log
map_marker_units
map_marker_type
이 circle
또는 circle_and_icon
로 설정된 지도의 경우 map_marker_units
매개변수를 사용하여 원의 반지름에 사용되는 단위를 meters
또는 pixels
로 설정할 수 있습니다.
map_marker_units: meters | pixels
map_marker_color_mode
map_marker_color_mode
를 사용하여 지도 마커의 색상을 설정할 수 있습니다.
map_marker_color_mode
를value
로 설정하면 색상이 기본 쿼리의 값에 따라 마커에 동적으로 할당됩니다. 값 매개변수를 사용하여 이 옵션의 범례에 사용할 색상을 구성할 수 있습니다.map_marker_color_mode
를fixed
로 설정하면map_marker_color
매개변수를 사용하여 모든 지도 마커에 사용할 단일 색상을 설정할 수 있습니다. 색상 값은 RGB 16진수 문자열(예:2ca6cd
) 또는 CSS 색상 이름(예:mediumblue
)으로 형식을 지정할 수 있습니다.
map_marker_color
map_marker_color_mode
를 fixed
로 설정하면 모든 지도 마커에 사용할 단일 색상을 설정합니다.
map_marker_color: [mediumblue]
값 매개변수
이러한 매개변수를 사용하여 map_marker_color_mode
가 value
로 설정된 경우 기본 쿼리 값을 기반으로 마커에 동적으로 할당되는 색상을 구성하거나 map_plot_mode
가 automagic_heatmap
, lines
또는 areas
로 설정된 지도 요소의 경우 이러한 색상을 구성할 수 있습니다.
map_value_colors
map_value_colors
매개변수를 사용하여 지도 지점의 색상을 설정하거나 측정값에 따라 색상을 코딩하는 경우 사용할 색상 범위를 정의할 수 있습니다. 16진수 문자열(예: #2ca6cd
) 또는 CSS 색상 이름(예: mediumblue
)을 입력할 수 있습니다. 먼저 나열한 색상은 가장 낮은 값과 연결됩니다.
map_value_colors: [green, mediumblue]
quantize_map_value_colors
true
로 설정하면 quantize_map_value_colors
이 색상 스케일을 부드러운 그라데이션에서 설정한 특정 색상으로만 변경합니다. 이 매개변수는 기본적으로 false
로 설정됩니다.
quantize_map_value_colors: true | false
reverse_map_value_colors
true
로 설정하면 reverse_map_value_colors
매개변수가 차트의 높은 값과 낮은 값을 나타내는 색상을 전환하여 색상 그라디언트를 바꿉니다.
reverse_map_value_colors: true | false
map_value_scale_clamp_min
map_value_scale_clamp_min
매개변수를 사용하여 색상 범위의 최솟값을 설정할 수 있습니다. 이를 통해 map_value_colors
매개변수로 지정된 가장 낮은 색상으로 특정 기준점 (지정된 숫자) 아래에 있는 모든 점에 색상을 지정할 수 있습니다. 기본적으로 범례에 적용되는 최솟값은 쿼리의 최솟값입니다.
map_value_scale_clamp_min: 1000
map_value_scale_clamp_max
map_value_scale_clamp_max
매개변수를 사용하여 색상 범위의 최댓값을 설정할 수 있습니다. 이렇게 하면 map_value_colors
매개변수로 지정된 가장 높은 색상으로 지정된 숫자 위의 모든 점에 색상 코드를 지정할 수 있습니다. 기본적으로 범례에 적용되는 최댓값은 쿼리의 최댓값입니다.
map_value_scale_clamp_max: 50000