You are viewing documentation for Looker 25.20. Click this link to see the most recent documentation.

LookML 대시보드의 지도 매개변수

이 페이지에서는 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` (요소용)	요소의 쿼리에 사용할 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개 행 높이로 설정합니다. 이는 기본값으로 설정된 다른 요소의 두 배 높이입니다.

- 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 매개변수는 요소 쿼리에 사용할 Explore를 정의합니다.

- name: orders_by_date
  explore: order

explore 매개변수는 LookML 상수를 허용합니다. 프로젝트의 매니페스트 파일에서 상수를 정의한 다음 "@{constant_name}" 구문을 사용하여 상수를 explore의 값으로 설정할 수 있습니다. 상수를 사용하면 한 곳에서 Explore 이름을 정의할 수 있으며, 이는 여러 대시보드 요소에서 사용되는 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`

대시보드 필터를 사용하면 뷰어가 대시보드 요소에 표시되는 데이터를 대화식으로 미세 조정할 수 있습니다. 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

플롯 매개변수

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

type: looker_map 요소와 함께 사용할 수 있는 매개변수는 쿼리에 type: location 측정기준이 포함되어 있는지 또는 지도 레이어가 연결되어 있는지에 따라 다릅니다.

`map_plot_mode`

map_plot_mode 매개변수는 type: location 측정기준을 기반으로 하는 type: looker_map 요소에 데이터를 표시하는 방식을 정의합니다. 이 매개변수는 연결된 지도 레이어가 있는 측정기준을 기반으로 하는 지도 또는 우편번호 측정기준에는 사용할 수 없습니다. map_plot_mode 매개변수는 다음 값을 허용합니다.

points
automagic_heatmap
lines
areas

`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 매개변수를 사용하여 모든 지도 마커에 사용할 단일 색상을 설정할 수 있습니다. 색상 값은 2ca6cd와 같은 RGB 16진수 문자열 또는 mediumblue와 같은 CSS 색상 이름으로 형식을 지정할 수 있습니다.

`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 매개변수를 사용하여 지점의 색상을 설정하거나, 측정값에 따라 색상 코딩을 사용하는 경우 사용할 색상 범위를 정의할 수 있습니다. #2ca6cd와 같은 16진수 문자열 목록 또는 mediumblue와 같은 CSS 색상 이름을 입력할 수 있습니다. 처음 나열하는 색상은 최저 값과 연결됩니다.


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

LookML 대시보드의 지도 매개변수 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

사용 예시

매개변수 정의

기본 매개변수

name

title

type

height

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

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

width

top

left

row

col

refresh

note

text

state

display

쿼리 파라미터

model

explore

fields

dimensions

measures

sorts

pivots

limit

column_limit

filters

listen

query_timezone

플롯 매개변수

map_plot_mode

points

automagic_heatmap

lines

areas

heatmap_gridlines

heatmap_gridlines_empty

heatmap_opacity