이 페이지에서는 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 (요소용) |
요소의 쿼리에 사용할 탐색을 정의합니다. | |
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 |
ADDED 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행으로 설정되거나 기본으로 설정된 다른 요소의 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_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
매개변수는 요소 쿼리에 사용할 탐색을 정의합니다.
- 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]
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
대시보드에는 사용자가 대시보드 요소 뒤의 데이터를 변경할 수 있는 필터가 있습니다. 이는 대시보드용 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
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
는 예측에 시각화를 적용하는 분석 유형입니다. 예측 기능을 사용하면 분석가가 신규 또는 기존 탐색 쿼리에 데이터 프로젝션을 신속하게 추가하여 사용자가 특정 데이터 포인트를 예측하고 모니터링할 수 있도록 지원합니다.
자세한 내용은 시각화 예측 문서 페이지를 참조하세요.
시각화에 예측을 추가하려면 예측 실험실 기능을 사용 설정해야 합니다.
confidence_interval
confidence_interval
는 백분율의 십진수 표현식으로 입력되는 예측 데이터 값의 경계를 설정합니다. 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
는 탐색 쿼리의 기간 측정기준을 기반으로 자동 입력됩니다.
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
하위 매개변수를 사용하여 병합 규칙을 정의합니다.
merged_queries
구문은 다음과 같습니다.
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: 'field from the source query using the view_name.field_name syntax'
source_field_name: 'joined field from the primary query using the
view_name.field_name syntax'
# more join_fields definitions as needed
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
# more join_fields definitions as needed
# additional source queries and join_fields definitions as needed
merged_results
에 정의된 첫 번째 쿼리가 기본 쿼리이고 다른 쿼리는 이 쿼리와 병합됩니다.
예를 들어 종목 코드, 회사 이름, 트위터 사용자 이름을 결합하면 두 쿼리를 병합하여 회사 이름, 회사 트위터 사용자 이름, IPO 연도, 주식 종목 코드, 직원 수, 채용 정보 결과를 반환할 수 있습니다.
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
filters:
company.twitter_username: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: crunchbase
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.twitter_username: "-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: company.name
- field_name: companies.twitter_username
source_field_name: company.twitter_username
데이터 결과의 형식은 다음과 같습니다.
그런 다음 요소 매개변수를 적용하여 원하는 대로 시각화의 스타일을 지정할 수 있습니다.
열 매개변수
다음 매개변수는 표 차트에서 열을 이동 및 고정하는 기능에 해당합니다.
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
탐색에 열 총계가 포함된 경우 hide_totals
에서 시각화에 합계를 표시할지 여부를 설정합니다.
hide_totals: true | false
hide_row_totals
탐색에 행 총계가 포함된 경우 hide_row_totals
는 행 총계를 시각화에 표시할지 여부를 설정합니다.
hide_row_totals: true | false
transpose
transpose
매개변수를 사용하면 테이블 행을 열로 조절할 수 있습니다. true
또는 false
가 허용됩니다.
- name: orders_by_date
transpose: true
hidden_fields
hidden_fields
매개변수는 쿼리에 사용되지만 차트에는 표시되지 않는 필드를 나타냅니다(있는 경우). 숨겨진 필드는 모두 탐색의 데이터 표 섹션에 표시됩니다.
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_values
매개변수와 하위 매개변수 show_hide
, first_last
, num_rows
를 limit_displayed_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
를 바로가기 계산에 사용하려면 테이블 계산을 만들 권한이 있어야 합니다.
다음 하위 매개변수를 사용하여 동적 필드를 정의할 수 있습니다.
table_calculation
measure
dimension
label
based_on
type
expression
filter_expression
value_format
value_format_name
calculation_type
args
_kind_hint
_type_hint
is_disabled
description
다음과 같은 구문을 사용하여 표 계산을 만들 수 있습니다.
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자(영문 기준)의 설명을 추가할 수 있습니다. 사용자가 필드 선택 도구의 필드 이름 오른쪽에 있는 정보 아이콘을 클릭하고, 탐색, 대시보드 또는 보기의 표 또는 표 차트 시각화에서 열 이름 위로 마우스를 가져가면 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
또는 LookMLcase
필드 매개변수와 유사합니다.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
하위 매개변수는 표 계산이 시각화 및 기본 탐색에 표시되는지 여부를 지정합니다. 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
하위 매개변수는 셀 텍스트의 글꼴 색상을 나타냅니다. 색상 값은 16진수 문자열(예: #2ca6cd
) 또는 CSS라는 색상 문자열(예: mediumblue
)을 사용할 수 있습니다.
bg_color
bg_color
하위 매개변수는 셀 배경색을 나타냅니다. 색상 값은 16진수 문자열(예: #2ca6cd
) 또는 CSS라는 색상 문자열(예: mediumblue
)을 사용할 수 있습니다.
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를 사용합니다. 색상 ID는 인스턴스 간에 이동할 수 있으며 다음과 같이 표시됩니다.
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
또한 UI를 사용하여 원하는 색상, 컬렉션, 팔레트를 찾고 LookML을 생성하여 대시보드에 추가할 수 있습니다. 사용자 정의 콘텐츠 (예: 디자인, 대시보드 또는 탐색)로 이동한 후 UI를 사용해 해당 콘텐츠의 시각화에 적용할 색상, 컬렉션 또는 팔레트를 적용합니다. 그런 다음 대시보드 LookML을 가져오는 단계를 따라 생성된 LookML을 복사한 후 color_application
섹션에 붙여넣습니다.
header_font_color
header_font_color
매개변수는 열 헤더에 글꼴 색상을 적용합니다.
색상 값은 16진수 문자열(예: #2ca6cd
) 또는 CSS라는 색상 문자열(예: mediumblue
)을 사용할 수 있습니다.
header_font_color: purple
기본 색상은 table_theme
매개변수를 사용하여 정의된 표 테마에 따라 다릅니다.
header_background_color
header_background_color
매개변수는 배경 열 헤더에 색상을 적용합니다.
색상 값은 16진수 문자열(예: #2ca6cd
) 또는 CSS라는 색상 문자열(예: mediumblue
)을 사용할 수 있습니다.
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...
로 설정할 수 있습니다.
논리 상태에 따라 값을 색상으로 코딩하는 경우 type
에 value
값과 함께 다음 값 중 하나를 지정할 수 있습니다.
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을 생성하여 대시보드에 추가할 수 있습니다. 사용자 정의 콘텐츠 (예: 디자인, 대시보드 또는 탐색)로 이동하고 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 ]