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

이 페이지에서는 dashboard.lkml 파일에서 LookML 대시보드 매개변수를 사용하여 type: looker_grid의 LookML 대시보드 요소를 추가하고 맞춤설정하는 방법을 보여줍니다.

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

사용 예시


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

## 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, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: true | false
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
truncate_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

매개변수 정의

파라미터 이름 설명
기본 매개변수
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_state 요소의 너비 내에서 한 행에 맞지 않을 정도로 메모리가 큰 경우 메모리를 접을지 펼칠지 정의합니다.
note_display 요소에 메모가 표시되는 위치를 정의합니다.
note_text 메모에 표시되는 텍스트를 지정합니다.
쿼리 매개변수
model 요소의 쿼리에 사용할 모델을 정의합니다.
explore (요소용) 요소의 쿼리에 사용할 Explore를 정의합니다.
fields 요소의 쿼리에 사용할 필드를 정의합니다. dimensions 및 measures 대신 사용할 수 있습니다.
dimensions 요소의 쿼리에 사용할 측정기준을 정의합니다.
measures 요소의 쿼리에 사용할 측정항목을 정의합니다.
sorts 요소의 쿼리에 사용할 정렬을 정의합니다.
pivots 요소의 쿼리에 사용하기 위해 피벗해야 하는 측정기준을 정의합니다.
fill_fields 측정기준 채우기 옵션을 사용하는 측정기준을 정의합니다.
subtotals 소계가 계산되는 필드를 정의합니다.
total 표 시각화에 열 합계가 표시되는지 여부를 지정합니다.
row_total 표 시각화에 행 합계를 표시할지 여부를 지정합니다.
limit 요소의 쿼리에 사용할 행 제한을 정의합니다.
column_limit 요소의 쿼리에 사용할 열 제한을 정의합니다.
filters (요소용) 요소의 쿼리에 대해 변경할 수 없는 필터를 정의합니다.
filter_expression 요소의 쿼리에 대해 변경할 수 없는 맞춤 필터를 정의합니다.
listen filters (대시보드용)이 생성된 경우 요소의 쿼리에 대해 변경할 수 있는 필터를 정의합니다.
query_timezone 쿼리가 실행될 때 사용해야 하는 시간대를 정의합니다.
analysis_config 추가됨 21.14 쿼리가 실행될 때 실행해야 하는 예측 분석을 정의합니다. 예측 실험실 기능을 사용 설정해야 합니다.
merged_queries 병합된 결과 쿼리를 정의합니다.
열 매개변수
auto_size_all_columns 각 표 열의 크기를 열 제목 또는 가장 긴 데이터 값 중 더 긴 쪽에 맞게 자동 조정합니다.
column_order 표 차트의 열을 정렬합니다.
pinned_columns 표 차트의 왼쪽에 고정할 열을 정의합니다.
플롯 매개변수
table_theme 표 시각화에 5가지 표 색상 옵션 중 하나를 적용합니다.
show_row_numbers 각 테이블 행의 시작 부분에 행 번호를 표시할지 여부를 설정합니다.
hide_totals 표 시각화에 열 합계를 표시할지 여부를 설정합니다.
hide_row_totals 표 시각화에 행 합계를 표시할지 여부를 설정합니다.
transpose 표 행을 열로 바꿀지 설정합니다.
hidden_fields 쿼리에 사용되지만 차트에서 숨겨지는 필드를 지정합니다.
limit_displayed_rows 결과 내 위치에 따라 시각화에서 행을 표시하거나 숨깁니다.
시리즈 매개변수
truncate_text 줄임표 (…)를 사용하여 열 헤더와 데이터 셀 내부의 텍스트를 줄입니다.
show_view_names 각 열 헤더의 필드 이름과 함께 뷰 이름을 표시합니다.
size_to_fit 표가 표시되는 요소의 너비에 딱 맞게 모든 열의 너비를 자동으로 조정합니다.
dynamic_fields 표 차트에 테이블 계산 또는 맞춤 필드가 포함되어 있음
series_labels 시각화의 각 열에 대한 맞춤 라벨을 지정합니다.
series_column_widths 시각화의 열에 특정 너비를 지정합니다.
series_cell_visualizations 열에서 셀 시각화 시각화 옵션을 사용하는지 지정합니다. 이 매개변수에는 is_active, palette, value_display 하위 매개변수가 있습니다.
series_text_format 각 열의 셀 텍스트 레이아웃을 지정합니다. 이 파라미터에는 하위 파라미터 fg_color, bg_color, bold, italic, align이 있습니다.
series_collapsed 소계가 있는 열이 접힌 상태로 표시되는지 여부를 지정합니다.
series_value_format 맞춤 형식 지정을 사용하여 열의 값 형식을 정의합니다.
매개변수 형식 지정
color_application 셀 시각화 및 조건부 서식에 색상을 적용합니다.
header_font_color 열 헤더에 글꼴 색상을 적용합니다.
header_background_color 열 헤더의 배경에 색상을 적용합니다.
header_text_alignment 열 헤더에 왼쪽, 오른쪽 또는 가운데 정렬을 적용합니다.
header_font_size 열 헤더에 글꼴 크기를 적용합니다.
rows_font_size 데이터 셀 내 텍스트에 글꼴 크기를 적용합니다.
enable_conditional_formatting 표 시각화의 색상 코딩 규칙을 정의하기 위해 true로 설정합니다.
conditional_formatting_include_totals 색상 코딩 스킴에 합계를 포함할지 여부를 지정합니다.
conditional_formatting_include_nulls null 값을 0으로 표현할지 여부를 지정합니다.
conditional_formatting conditional_formatting 및 하위 매개변수를 사용하여 표 시각화를 색상 코딩하는 규칙을 정의합니다.

기본 매개변수

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_state

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

note_display

note_display 매개변수는 요소에 메모가 표시되는 위치를 정의합니다. above는 요소 상단에 메모를 배치하고, below는 요소 하단에 메모를 배치하며, hover는 사용자가 ? 아이콘 위로 마우스를 가져가야 메모가 표시됩니다.

note_text

note_text 매개변수는 요소 메모에 표시되는 텍스트를 지정합니다.

쿼리 파라미터

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

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]

fill_fields

fill_fields 매개변수는 측정기준 채우기 옵션을 사용하는 측정기준을 정의합니다. view_name.dimension_name 구문을 사용하여 측정기준을 지정합니다.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

subtotals

subtotals 매개변수는 소계 옵션을 사용하는 측정기준을 정의합니다. view_name.dimension_name 구문을 사용하여 측정기준을 지정합니다.

subtotals: [products.department, distribution_centers.name]

total

total 매개변수는 테이블 하단에 합계 행을 표시할지 여부를 설정합니다. 자세한 내용은 합계 표시를 참고하세요.

total: true | false

## default value: false

row_total

row_total 매개변수는 합계 열이 테이블의 오른쪽 또는 왼쪽에 표시되는지 여부를 설정합니다. 피벗이 있는 경우에만 작동합니다. 자세한 내용은 합계 표시를 참고하세요.

row_total: right | left | false

## default value: false

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 변수를 사용하여 유연한 필터 값을 사용할 수도 있습니다.

filter_expression

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

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

Looker 필터 표현식 문서 페이지에는 Looker 필터 표현식이 나열되어 있습니다.

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

analysis_config

analysis_config 매개변수와 하위 매개변수는 Looker 21.14부터 시각화에 사용할 쿼리 분석을 설명합니다. 시각화에 대한 분석을 실행하려면 예측 실험실 기능을 사용 설정해야 합니다.

다음 하위 매개변수를 사용하여 분석을 정의할 수 있습니다.

다음과 같은 구문을 사용하여 예측을 만들 수 있습니다.


  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

forecasting

forecasting는 시각화에 예측을 적용하는 분석 유형입니다. 예측을 사용하면 분석가가 새로운 Explore 쿼리나 기존 Explore 쿼리에 데이터 예측을 추가하여 특정 데이터 포인트를 예측하고 모니터링할 수 있습니다.

자세한 내용은 시각화의 예측 문서 페이지를 참고하세요.

시각화에 예측을 추가하려면 예측 실험실 기능을 사용 설정해야 합니다.

confidence_interval

confidence_interval는 백분율의 10진수 표현식으로 입력되는 예측 데이터 값의 범위를 설정합니다. confidence_interval는 선택사항이며 기본적으로 비어 있습니다.


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

시각화의 예측 문서 페이지의 예측 구간 섹션을 참고하세요.

시각화에 예측을 추가하려면 예측 실험실 기능을 사용 설정해야 합니다.

field_name

field_name는 예측에 포함할 측정항목의 이름을 지정합니다(최대 5개).


field_name: view_name.field_name

forecast_n

forecast_n는 예측의 길이를 지정합니다.


forecast_n: N # An integer that represents the length of the forecast

시각화의 예측 문서 페이지의 길이 섹션을 참고하세요.

시각화에 예측을 추가하려면 예측 실험실 기능을 사용 설정해야 합니다.

forecast_interval

forecast_interval는 데이터 값을 예측할 기간 간격을 설정합니다. forecast_interval는 Explore 쿼리의 기간 측정기준에 따라 자동으로 채워집니다.


forecast_interval: day | month # a timeframe with dimension fill

길이 문서 페이지를 참고하세요.

시각화에 예측을 추가하려면 예측 실험실 기능을 사용 설정해야 합니다.

seasonality

seasonality를 사용하면 분석가가 예측에서 알려진 주기 또는 반복 데이터 추세를 설명할 수 있습니다. seasonality는 선택사항이며 기본적으로 비어 있습니다.


seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

자동 시즌성 설정은 빈 seasonality 값으로 표시됩니다.

시각화의 예측 문서 페이지의 계절성 섹션을 참고하세요.

시각화에 예측을 추가하려면 예측 실험실 기능을 사용 설정해야 합니다.

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 대시보드 필터와 상호작용하면 병합된 쿼리 요소의 해당 소스 쿼리가 그에 따라 필터링됩니다.

열 매개변수

다음 매개변수는 표 차트에서 열을 이동하고 고정하는 기능에 해당합니다.

auto_size_all_columns

auto_size_all_columns 매개변수는 각 표 열을 열 제목 또는 가장 긴 데이터 값 중 더 긴 쪽에 맞게 자동으로 조정합니다. 이 매개변수는 series_column_widths 및 size_to_fit 매개변수가 정의된 경우 이를 재정의합니다.

- name: orders_by_date
  auto_size_all_columns: true

column_order

column_order 매개변수는 표 차트의 열 순서를 정의합니다.

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

pinned_columns

pinned_columns 매개변수는 표 차트의 왼쪽에 고정된 열을 정의합니다.

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

플롯 매개변수

다음 매개변수는 표 차트의 시각화 편집기 플롯 메뉴의 옵션에 해당합니다.

table_theme

table_theme 매개변수를 사용하여 다음 표 색상 지정 옵션 중 하나를 표 요소에 적용합니다.

  • editable: 테이블에 파란색 측정기준, 주황색 측정값, 녹색 테이블 계산이 있습니다.
  • white: 테이블 헤더가 흰색으로 표시되고, 데이터 행은 흰색과 회색으로 교차해서 표시되고, 텍스트는 검정색입니다.
  • gray: 테이블 헤더가 회색으로 표시되고, 데이터 행은 흰색과 밝은 회색으로 교차해서 표시되고, 텍스트는 짙은 회색입니다.
  • transparent: 테이블 헤더가 완전 투명으로 표시되고, 데이터 행은 완전 투명과 반투명한 회색으로 교차해서 표시되고, 텍스트 색상은 배경 색상에 따라 필요에 따라 검은색에서 흰색으로 자체적으로 조정됩니다. 시각화를 통해 타일 배경 색상이 표시되도록 맞춤설정된 임베딩된 대시보드를 사용할 때 table_theme을 transparent로 설정하면 유용할 수 있습니다.
  • unstyled: 테이블 헤더와 데이터 행이 흰색으로 표시되고, 텍스트는 검은색입니다.

table_theme: editable | white | gray | transparent | unstyled

show_row_numbers

show_row_numbers 매개변수는 각 테이블 행의 시작 부분에 행 번호를 표시할지 여부를 설정합니다.


show_row_numbers: true | false

hide_totals

Explore에 열 합계가 포함된 경우 hide_totals는 시각화에 합계를 표시할지 여부를 설정합니다.


hide_totals: true | false

hide_row_totals

Explore에 행 합계가 포함된 경우 hide_row_totals는 시각화에 행 합계를 표시할지 여부를 설정합니다.


hide_row_totals: true | false

transpose

transpose 매개변수를 사용하면 테이블 행을 열로 전치할 수 있습니다. true 또는 false을 허용합니다.

- name: orders_by_date
  transpose: true

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개 행을 표시하거나 숨깁니다.

시리즈 매개변수

다음 매개변수는 표 차트의 시각화 편집기 시리즈 메뉴의 옵션에 해당합니다.

truncate_text

truncate_text 매개변수는 열 헤더와 데이터 셀 내부의 텍스트를 줄임표 (…)로 줄여서 표시할지 여부를 설정합니다.


truncate_text: true | false

show_view_names

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

show_view_names: true | false

## default value: true

size_to_fit

size_to_fit 매개변수는 표가 표시되는 요소의 너비에 딱 맞게 모든 열의 너비를 조정할지 여부를 설정합니다. auto_size_all_columns 매개변수가 true로 설정되면 size_to_fit가 재정의됩니다.


size_to_fit: true | false

dynamic_fields

dynamic_fields 매개변수와 하위 매개변수는 시각화에 사용할 표 계산 또는 맞춤 필드를 설명합니다. 최대 255자의 description를 추가하거나 맞춤 그룹 또는 맞춤 구간에 calculation_type를 사용하려면 맞춤 필드를 만들 수 있는 권한이 있어야 합니다. 테이블 계산에 최대 255자(영문 기준)의 description를 추가하거나 단축키 계산에 calculation_type를 사용하려면 테이블 계산을 만들 수 있는 권한이 있어야 합니다.

다음 하위 매개변수를 사용하여 동적 필드를 정의할 수 있습니다.

다음과 같은 구문을 사용하여 표 계산을 만들 수 있습니다.

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

다음과 같은 구문을 사용하여 여러 계산 유형에 대한 바로가기 계산을 만들 수 있습니다.

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

다음과 같은 구문을 사용하여 시각화에 사용할 맞춤 측정값을 만들 수 있습니다.

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

다음과 같은 구문을 사용하여 시각화에 사용할 필터링된 맞춤 측정값을 만들 수 있습니다.

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

다음과 같은 구문을 사용하여 시각화에 사용할 맞춤 측정기준을 만들 수 있습니다.

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

다음과 같은 구문을 사용하여 시각화에 사용할 측정기준의 맞춤 그룹을 만들 수 있습니다.

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

다음과 같은 구문을 사용하여 시각화에 사용할 측정기준의 맞춤 구간을 만들 수 있습니다.

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

요소에 동적 필드를 여러 개 추가할 수 있습니다. 시각화에 표시되도록 표 계산을 fields 매개변수에 추가할 필요는 없지만, 다른 유형의 동적 필드를 표시하려면 fields에 추가해야 합니다.

table_calculation

테이블 계산을 정의하는 경우 table_calculation 하위 매개변수는 테이블 계산의 이름을 지정합니다. LookML에서 표 계산을 참조할 때 사용할 이름입니다.

measure

measure 하위 매개변수는 맞춤 측정값 또는 필터링된 맞춤 측정값의 이름을 정의합니다. LookML에서 측정값을 참조하는 데 사용하는 이름입니다.

dimension

dimension 하위 매개변수는 맞춤 측정기준의 이름을 정의합니다. LookML에서 측정기준을 참조하는 데 사용할 이름입니다.

label

label 하위 매개변수는 시각화에 표시할 동적 필드의 제목을 정의합니다. table_calculation, measure 또는 dimension 하위 매개변수에 지정된 이름과 같거나 다를 수 있습니다.

based_on

커스텀 측정값 또는 필터링된 커스텀 측정값을 사용하는 경우 based_on 하위 파라미터는 view_name.field_name 구문을 사용하여 기반이 되는 측정값을 식별합니다.

type

맞춤 측정항목을 사용하는 경우 type 하위 매개변수는 집계 유형을 식별합니다. count_distinct, sum, average, min, max, median를 허용합니다.

description

description 하위 매개변수를 사용하여 맞춤 필드 또는 테이블 계산에 최대 255자(영문 기준)의 설명을 추가할 수 있습니다. 사용자가 필드 선택 도구에서 필드 이름 오른쪽에 있는 정보 아이콘을 클릭하거나 Explore, 대시보드 또는 Look의 테이블이나 테이블 차트 시각화에서 열 이름 위로 마우스를 가져가면 Looker에 설명이 표시됩니다.

expression

테이블 계산을 사용하는 경우 expression 하위 매개변수는 테이블 계산을 만드는 데 사용되는 Looker 표현식을 정의합니다.

filter_expression

맞춤 필터링된 측정값을 사용하는 경우 filter_expression 하위 매개변수는 측정값을 필터링하는 데 사용되는 Looker 표현식을 정의합니다.

value_format

선택사항인 value_format 하위 매개변수는 맞춤 형식을 사용할 때 동적 필드의 값 형식을 정의합니다. 기본 Looker 형식을 사용하려면 대신 value_format_name를 사용하세요.

value_format_name

선택사항인 value_format_name 하위 매개변수는 동적 필드에 기본 형식을 적용합니다. 맞춤 형식을 사용하려면 value_format를 대신 사용하세요.

calculation_type

calculation_type 하위 매개변수는 테이블 계산을 만들거나 측정기준의 맞춤 그룹을 만드는 데 사용할 바로가기 계산 또는 그룹 함수의 유형을 정의합니다.

맞춤 입력란 calculation_type 옵션:

  • group_by - 지정된 맞춤 조건을 기반으로 맞춤 고정 라벨 아래에 측정기준 값을 그룹화합니다. SQL의 CASE WHEN 또는 LookML case 필드 매개변수와 유사합니다.
  • bin - 숫자 유형 측정기준 및 맞춤 측정기준의 값을 맞춤 구간 또는 계층으로 그룹화합니다. LookML tier 측정기준 유형과 유사합니다.

표 계산 calculation_type 옵션:

  • percent_of_column_sum - 행 값을 열에 있는 값의 합계로 나눈 값입니다. 이 계산에는 쿼리 행 한도에 도달한 경우 데이터 테이블에 있는 값만 포함됩니다.
  • percent_of_previous: 현재 행의 값을 다음 행의 값으로 나눈 값입니다.
  • percent_difference_from_previous — 현재 행의 값과 다음 행의 값 간의 차이를 다음 행의 값으로 나눈 값입니다.
  • rank_of_column - 열의 모든 값 중 행 값의 순위입니다. 이 계산에는 쿼리 행 한도에 도달한 경우 데이터 테이블에 있는 값만 포함됩니다.
  • running_total - 현재 행 값과 열에 있는 모든 이전 행 값의 누적 합계입니다.
  • percent_of_previous_column: 피벗된 필드의 경우 현재 열의 값을 왼쪽 열의 값으로 나눈 값입니다.
  • percent_change_from_previous_column — 피벗된 필드의 경우 현재 열 값과 왼쪽 열 값의 차이를 왼쪽 열 값으로 나눈 값입니다.
  • percent_of_row: 피벗된 필드의 경우 현재 열 값의 비율을 해당 필드의 행 합계로 나눈 값입니다.
  • running_row_total - 피벗된 필드의 경우 현재 열과 이 행에 있는 모든 이전 열의 누적 합계입니다.

맞춤 그룹의 args

측정기준에 맞춤 그룹을 사용하는 경우 args는 측정기준 값에 고정 라벨을 적용하기 위한 인수를 지정합니다. args의 형식은 다음과 같습니다.

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

원하는 그룹 수에 따라 필요한 만큼 label 및 filter 조건을 추가할 수 있습니다.

이전 예를 참고하세요.

맞춤 구간의 경우 args

숫자 측정기준에 맞춤 구간을 사용하는 경우 args은 측정기준 값에 고정 등급을 적용하기 위한 인수를 지정합니다. args의 형식은 다음과 같습니다.

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

이전 예를 참고하세요.

단축키 계산을 위한 args

args 하위 매개변수는 바로가기 계산에 사용하는 숫자 필드의 이름을 지정하는 곳입니다. 인수는 다음 형식을 취합니다.

- args:
  - view_name.field_name   ## the field on which the calculation is based

이전 예를 참고하세요.

_kind_hint

선택사항인 _kind_hint 하위 매개변수는 동적 필드가 측정기준을 반환하는지 또는 측정항목을 반환하는지 여부를 식별합니다. dimension 및 measure 값을 사용합니다.

_type_hint

선택사항인 _type_hint 하위 매개변수는 동적 필드의 표현식이 생성해야 하는 데이터 유형을 식별합니다.

is_disabled

선택사항인 is_disabled 하위 매개변수는 테이블 계산이 시각화 및 기본 Explore에 표시되는지 여부를 지정합니다. true 및 false 값을 사용합니다.

series_labels

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

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

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

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

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

series_column_widths

계열 이름을 기반으로 하나 이상의 열 너비를 설정합니다. auto_size_all_columns 매개변수가 true로 설정되면 series_column_widths가 재정의됩니다.

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

series_cell_visualizations

view_name.field_name 형식을 사용하여 계열 이름을 표시하여 하나 이상의 열이 셀 시각화 옵션을 사용하는지 지정합니다. series_cell_visualizations에는 하위 매개변수 is_active, palette, value_display이 있습니다.

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

is_active

선택적 is_active 하위 매개변수는 true 또는 false를 허용하여 해당 계열에 막대 시각화가 사용 설정되어 있는지 여부를 나타냅니다. is_active이 정의되지 않은 경우 기본값은 true입니다.

palette

palette 하위 매개변수는 선택사항입니다. 사용하지 않으면 팔레트가 인스턴스의 기본 색상 컬렉션에 있는 발산형 팔레트로 기본 설정됩니다.

palette를 사용하는 경우 하위 매개변수 palette_id 및 collection_id는 특정 팔레트의 색상을 막대 시각화에 적용합니다. palette_id의 경우 연속 또는 발산 팔레트의 ID를 사용해야 합니다. 팔레트 ID 및 색상 컬렉션 ID에 관한 자세한 내용은 color_application 섹션을 참고하세요.

palette에는 막대에 사용할 맞춤 색상을 2~5개 설정하는 대체 하위 매개변수 custom_colors이 있습니다.

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

value_display

선택사항인 value_display 하위 매개변수는 각 데이터 셀의 값이 셀 시각화와 함께 표시되는지 여부를 나타내기 위해 true 또는 false를 허용합니다. value_display이 정의되지 않은 경우 기본값은 true입니다.

series_text_format

series_text_format 매개변수와 하위 매개변수는 각 열의 셀 텍스트 레이아웃을 지정합니다. 형식을 지정할 계열은 view_name.field_name 구문을 사용하여 표시되고 하위 매개변수는 형식을 설명합니다.

모든 하위 매개변수는 선택사항입니다. 필요한 매개변수만 사용하세요.

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

fg_color

fg_color 하위 매개변수는 셀 텍스트의 글꼴 색상을 나타냅니다. 색상 값은 #2ca6cd와 같은 16진수 문자열 또는 mediumblue와 같은 색상이 지정된 CSS 문자열을 사용할 수 있습니다.

bg_color

bg_color 하위 매개변수는 셀 배경색을 나타냅니다. 색상 값은 #2ca6cd와 같은 16진수 문자열 또는 mediumblue와 같은 색상이 지정된 CSS 문자열을 사용할 수 있습니다.

bold

bold 하위 매개변수는 셀 텍스트가 굵은지 여부를 나타내며 true 또는 false를 허용합니다.

italic

italic 하위 매개변수는 셀 텍스트가 기울임체인지 여부를 나타내며 true 또는 false를 허용합니다.

align

align 하위 매개변수는 셀 텍스트의 정렬을 나타내며 left, center 또는 right를 허용합니다.

series_collapsed

series_collapsed 매개변수는 특정 계열의 소계를 접을지 아니면 펼칠지를 정의합니다. view_name.field_name 구문과 true 또는 false를 사용하여 계열을 식별합니다.

series_collapsed:
  users.city: false
  users.state: true

열이 접혀 있으면 데이터 셀의 왼쪽에 있는 화살표를 클릭하여 소계를 구성하는 개별 요소를 표시할 수 있습니다.

series_value_format

series_value_format 매개변수는 기본 측정기준 또는 측정값에 적용된 형식과 관계없이 계열에 적용할 형식을 지정합니다. series_value_format를 지정하지 않으면 값이 기본 측정기준 또는 측정값 형식으로 표시됩니다.

view_name.field_name 구문을 사용하여 서식을 지정할 계열을 식별합니다.

format_string 하위 매개변수를 사용하면 Excel 스타일 형식을 사용하여 계열의 형식을 정의할 수 있습니다.

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

다음과 같이 서식을 정의할 수도 있습니다.


series_value_format:
  order_items.count: "00#"

format_string 하위 매개변수에 사용된 형식은 value_format LookML 매개변수에 사용된 형식과 동일합니다. 숫자 필드에 커스텀 형식 추가 문서 페이지에서 이러한 형식을 지정하는 방법을 자세히 알아보세요.

서식 지정 매개변수

다음 매개변수는 표 차트의 시각화 편집기 서식 메뉴의 옵션에 해당합니다.

color_application

color_application 매개변수와 하위 매개변수 collection_id 및 palette_id를 사용하여 특정 색상 컬렉션과 팔레트를 대시보드 요소에 적용할 수 있습니다. Looker의 기본 색상 컬렉션 개요는 색상 컬렉션 문서 페이지를 참고하세요.

사용할 팔레트의 컬렉션 ID와 팔레트 ID가 있는 경우 해당 ID를 collection_id 및 palette_id 하위 매개변수에 입력하면 됩니다. 컬렉션 ID 또는 팔레트 ID는 영숫자 코드이거나 색상 컬렉션의 이름을 기반으로 할 수 있습니다. 영숫자 코드는 Looker의 기본 컬렉션에 사용됩니다. 인스턴스별이며 다음과 같이 표시됩니다.


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

맞춤 색상 컬렉션은 색상 컬렉션의 이름을 기반으로 컬렉션 및 팔레트 ID를 사용하며, 이는 인스턴스 간에 이동 가능하고 다음과 같이 표시됩니다.


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

UI를 사용하여 원하는 색상, 컬렉션 또는 팔레트를 찾고 LookML을 생성하여 대시보드에 추가할 수도 있습니다. Look, 대시보드, Explore와 같은 사용자 정의 콘텐츠로 이동하고 UI를 사용하여 해당 콘텐츠의 시각화에 원하는 색상, 컬렉션 또는 팔레트를 적용합니다. 이 단계를 완료한 후 대시보드 LookML을 가져오는 단계를 따라 생성된 LookML을 복사하여 color_application 섹션에 붙여넣습니다.

header_font_color

header_font_color 매개변수는 열 헤더에 글꼴 색상을 적용합니다.

색상 값은 #2ca6cd와 같은 16진수 문자열 또는 mediumblue와 같은 색상이 지정된 CSS 문자열을 사용할 수 있습니다.


header_font_color: purple

기본 색상은 table_theme 매개변수를 사용하여 정의된 표 테마에 따라 달라집니다.

header_background_color

header_background_color 매개변수는 배경 열 헤더에 색상을 적용합니다.

색상 값은 #2ca6cd와 같은 16진수 문자열 또는 mediumblue와 같은 색상이 지정된 CSS 문자열을 사용할 수 있습니다.


header_background_color: #add8e6

기본 색상은 table_theme 매개변수를 사용하여 정의된 표 테마에 따라 달라집니다.

header_text_alignment

header_text_alignment 매개변수는 열 헤더에 left, right 또는 center 정렬을 적용합니다.


header_text_alignment: center

기본 정렬은 left입니다.

header_font_size

header_font_size 매개변수는 1~99의 글꼴 크기를 열 헤더에 적용합니다.


header_font_size: 16

헤더 및 행 글꼴의 기본 크기는 12입니다.

rows_font_size

rows_font_size 매개변수는 1~99의 글꼴 크기를 데이터 셀 내부의 텍스트에 적용하지만 열 헤더에는 적용하지 않습니다.


rows_font_size: 8

헤더 및 행 글꼴의 기본 크기는 12입니다.

enable_conditional_formatting

enable_conditional_formatting을 true로 설정하면 스케일로 또는 원하는 값을 지정하여 테이블 시각화에 색상을 지정하는 규칙을 정의할 수 있습니다.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

enable_conditional_formatting이 true로 설정된 경우 conditional_formatting_include_totals은 색상 코딩 스킴에 합계를 포함할지 여부를 지정합니다.


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

enable_conditional_formatting이 true로 설정된 경우 conditional_formatting_include_nulls는 null 값을 0으로 표시할지 여부를 지정합니다.


conditional_formatting_include_nulls: true | false

conditional_formatting

enable_conditional_formatting이 true로 설정된 경우 conditional_formatting 매개변수를 사용하여 테이블 시각화에 색상을 지정하는 규칙을 정의합니다. 각 조건부 서식 규칙에 대해 다음 매개변수를 사용하여 설정을 지정할 수 있습니다.

다음은 조건부 서식 규칙의 예입니다.


conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

type

type 매개변수는 배율에 따라 또는 논리적 조건에 따라 값을 색상 코딩할지 여부를 지정합니다.

배율에 따라 값을 색상 코딩하는 경우 type을 along a scale...으로 설정할 수 있습니다.

논리 조건을 기반으로 값에 색상 코딩을 적용하는 경우 value 값과 함께 type에 다음 값 중 하나를 지정할 수 있습니다.

  • equal to: 규칙이 value에 지정된 숫자와 동일한 값에 적용됩니다.
  • not equal to: 규칙이 value에 지정된 숫자와 같지 않은 값에 적용됩니다.
  • greater than: 규칙이 value에 지정된 숫자보다 큰 값에 적용됩니다.
  • less than: 규칙이 value에 지정된 숫자보다 작은 값에 적용됩니다.
  • between: 이 규칙은 value에 지정된 두 숫자 사이의 값에 적용됩니다.
  • not between: 이 규칙은 value에 지정된 두 숫자 사이에 있지 않은 값에 적용됩니다.
  • 'null': 규칙이 null 값에만 적용됩니다.
  • not null: 규칙은 null이 아닌 값에만 적용됩니다.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

'null' 또는 not null 이외의 논리 조건을 기반으로 색상 코딩을 사용하는 경우 규칙이 적용되는 값을 지정합니다. value 매개변수는 단일 숫자를 사용하며, type이 between 또는 not between로 설정된 경우 두 숫자의 집합을 사용합니다.


value: N | [N, N]

background_color

색상 코딩이 논리 조건 (type이 along a scale... 이외의 값으로 설정됨)을 기반으로 하는 경우 background_color 매개변수를 사용하여 규칙이 적용되는 값의 배경색을 지정합니다.


background_color: "#49cec1"

font_color

논리 조건에 따라 색상 코딩을 사용하는 경우 (type이 along a scale... 이외의 값으로 설정된 경우) font_color 매개변수를 사용하여 규칙이 적용되는 값의 글꼴 색상을 지정합니다.


font_color: "#1f3e5a"

color_application

color_application 매개변수와 하위 매개변수 collection_id, palette_id, options를 사용하여 조건부 서식 규칙에 특정 색상 모음과 팔레트를 적용할 수 있습니다.

컬렉션 ID와 팔레트 ID가 있는 경우 이를 사용하여 LookML 대시보드에 색상을 추가할 수 있습니다. UI를 사용하여 원하는 색상을 찾고 LookML을 생성하여 대시보드에 추가할 수도 있습니다. Look, 대시보드, Explore와 같은 사용자 정의 콘텐츠로 이동하여 UI를 사용하여 해당 콘텐츠의 시각화에 원하는 색상을 적용합니다. 이 단계를 완료한 후 대시보드 LookML을 가져오는 단계를 따라 생성된 LookML을 복사하여 color_application 섹션에 붙여넣습니다. Looker의 사전 정의된 색상 컬렉션 개요는 색상 컬렉션 문서 페이지를 참고하세요.

type을 along a scale...로 설정한 경우 options 하위 매개변수를 사용할 수 있습니다. 다음과 같은 하위 매개변수가 있습니다.

  • steps: 이 매개변수는 사용되는 색상 수를 지정된 값으로 제한하고 데이터를 해당 수의 그룹으로 분리합니다. 이 매개변수를 사용하지 않으면 데이터가 전체 팔레트를 포함하는 그라데이션에 따라 색상이 지정됩니다. 2~100 값을 허용합니다.
  • mirror: true로 설정하면 이 파라미터는 정의된 중심점의 양쪽에서 동일한 값에 대해 색상 팔레트의 양쪽에 동일한 색상 이동을 적용합니다. true 또는 false을 허용합니다.
  • constraints: 이 매개변수는 조건부 서식이 적용되는 데이터 범위를 설정하고 팔레트 적용에 사용될 중심점을 설정합니다. 다음 구문을 허용합니다. constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • reverse: 이 매개변수는 색상 적용 중에 색상 팔레트를 반전할지 여부를 결정합니다. true 또는 false을 허용합니다.

bold

논리 조건에 따라 색상 코딩할 때 규칙이 적용되는 값을 굵게 표시할지 여부를 설정합니다.


bold: true | false

italic

논리 조건에 따라 색상 코딩할 때 규칙이 적용되는 값을 기울임체로 표시할지 여부를 설정합니다.


italic: true | false

strikethrough

논리 조건에 따라 색상 코딩할 때 규칙의 값에 취소선 서식을 적용할지 여부를 설정합니다.


strikethrough: true | false

fields

규칙을 적용할 필드를 지정합니다. 기본적으로 규칙은 모든 숫자 필드에 적용됩니다.


fields: [ view_name.field_name ]