LookML 대시보드 매개변수

대시보드는 다음 두 가지 방법 중 하나로 만들 수 있습니다. 사용자 정의 대시보드는 Looker UI를 사용하여 생성되며 사용자 정의 대시보드 만들기 문서 페이지에 설명되어 있습니다. 대시보드는 LookML을 사용하여 생성할 수도 있으며 이 페이지에서 설명한 대로 전체 설정을 수정할 수 있습니다.

이 페이지에서는 전체 대시보드에 영향을 미치는 LookML 대시보드 매개변수를 설명합니다.

LookML 대시보드에는 대시보드의 데이터 시각화, 텍스트 타일, 버튼인 요소도 포함됩니다. 각 개별 요소 유형의 참조 페이지로 연결되는 링크는 대시보드 요소 파라미터 페이지를 참고하세요.

사용 예시

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  rows:
    - elements: [element_name, element_name, ...]
      height: N
  tile_size: N
  width: N
  refresh: N (seconds | minutes | hours | days)
  auto_run: true | false

  # DASHBOARD FILTER PARAMETERS
  crossfilter_enabled: true | false
  filters_bar_collapsed: true | false
  filters_location_top: true | false
  filters:
  - name: filter_name
    title: "chosen filter title"
    type: field_filter | number_filter | date_filter | string_filter
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    ui_config:
      type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
            button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
            relative_timeframes | advanced
      display: inline | popover | overflow
      options:
        min: N
        max: N
      - value options
    listens_to_filters:
    - filter_name
      field: view_name.field_name

  # EMBEDDED DASHBOARD PARAMETERS
  embed_style:
    background_color: "css_color"
    show_title: true | false
    title_color: "css_color"
    show_filters_bar: true | false
    tile_background_color: "css_color"
    tile_text_color: "css_color"

  # ELEMENTS PARAMETERS
  elements:
  # One or more element declarations

매개변수 정의

파라미터 이름 설명
dashboard 대시보드를 만듭니다.
preferred_viewer 이 파라미터는 무시됩니다.
title (대시보드용) 대시보드 이름이 사용자에게 표시되는 방식을 변경합니다.
description (대시보드용) 대시보드 세부정보 패널 또는 목록 보기로 설정된 폴더에서 볼 수 있는 설명을 추가합니다.
enable_viz_full_screen 대시보드 뷰어가 전체 화면 및 확장된 뷰로 대시보드 타일을 볼 수 있는지 정의합니다.
extends LookML 대시보드를 다른 LookML 대시보드를 기반으로 합니다.
extension 다른 대시보드로 대시보드를 확장해야 합니다.
layout 대시보드에서 요소를 배치하는 방식을 정의합니다.
rows layout: grid 대시보드의 각 행에 들어갈 요소를 정의하기 위해 LookML 섹션을 시작합니다.
elements (행용) layout: grid 대시보드의 행에 들어갈 요소를 정의합니다.
height (행용) layout: grid 대시보드의 행 높이를 정의합니다.
tile_size layout: tile 대시보드의 타일 크기를 정의합니다.
width (대시보드용) layout: static 대시보드의 대시보드 너비를 정의합니다.
refresh (대시보드용) 대시보드 요소가 자동으로 새로고침되는 간격을 설정합니다.
auto_run 대시보드를 처음 열거나 새로고침할 때 자동으로 실행할지 여부를 결정합니다.
필터 매개변수
crossfilter_enabled 대시보드에 대해 교차 필터링을 사용 설정 또는 사용 중지합니다.
filters_bar_collapsed 21.16 추가됨 대시보드의 대시보드 필터 표시줄을 기본적으로 접거나 펼치도록 설정합니다.
filters_location_top 22.8 추가됨 대시보드의 대시보드 필터 표시줄 위치를 상단 또는 오른쪽으로 설정합니다.
filters (대시보드용) 대시보드 필터를 정의하기 위해 LookML 섹션을 시작합니다.
name (필터용) 필터 만들기를 클릭합니다.
title (필터용) 필터 이름이 사용자에게 표시되는 방식을 변경합니다.
type (필터용) 사용할 필터 유형을 결정합니다.
default_value 필터의 기본값을 설정합니다.
allow_multiple_values 사용자를 단일 필터 값으로 제한합니다.
required 사용자가 대시보드를 실행하려면 필터 값을 입력해야 합니다.
ui_config 사용자가 LookML 대시보드를 볼 때 사용할 수 있는 필터 컨트롤을 구성합니다. type, display, options 하위 매개변수가 있습니다.
model (필터용) type: field_filter 필터의 기본 필드가 포함된 모델을 지정합니다.
explore (필터용) type: field_filter 필터의 기본 필드가 포함된 Explore를 지정합니다.
field type: field_filter 필터의 기본 필드를 지정합니다.
listens_to_filters 사용자가 type: field_filter의 다른 대시보드 필터에 입력한 내용을 기반으로 field_filter의 대시보드 필터에 대한 추천을 좁힙니다.
삽입된 대시보드 매개변수
embed_style 삽입된 대시보드 맞춤설정을 정의하기 위해 LookML 섹션을 시작합니다.
background_color 삽입된 대시보드의 배경 색상을 설정합니다.
show_title 삽입된 대시보드에 대시보드 제목을 표시할지 여부를 지정합니다.
title_color 삽입된 대시보드의 제목 색상을 설정합니다.
show_filters_bar 삽입된 대시보드에 필터 표시줄을 표시할지 여부를 지정합니다.
tile_background_color 삽입된 대시보드의 타일 배경 색상을 설정합니다.
tile_text_color 삽입된 대시보드의 타일 텍스트 색상을 설정합니다.
요소 매개변수
elements (대시보드용) 대시보드 요소를 정의하기 위해 LookML 섹션을 시작합니다.

dashboard

dashboard 매개변수는 새 대시보드를 선언하고 대시보드의 이름을 지정합니다. 최대 문자 수는 255자(영문 기준)이며 허용되는 문자는 영문자(A~Z), 숫자(0~9), 대시(-), 밑줄(_)입니다. 일반적으로 각 LookML 대시보드를 자체 LookML 파일에 배치하는 것이 좋지만 단일 파일에 여러 대시보드를 선언할 수도 있습니다.

- dashboard: sales_overview

대시보드에 항목을 표시하려면 elements 매개변수를 사용하여 하나 이상의 요소를 추가해야 합니다.

preferred_viewer

Looker 23.6에서 기존 대시보드가 지원 중단되기 전에는 preferred_viewer 매개변수를 사용하여 대시보드를 Looker의 기본 대시보드 환경 또는 기존 대시보드로 보고 다운로드할 형식을 선택할 수 있었습니다.

title (대시보드용)

이 섹션에서는 대시보드에 포함된 title 매개변수를 참조합니다.

title는 이 페이지의 title (필터용) 섹션에 설명된 대로 대시보드 필터의 일부로도 사용할 수 있습니다.

title는 대시보드 요소의 일부로도 사용할 수 있습니다. 사용의 대표적인 예는 열 차트 요소 문서 페이지에 나와 있습니다.

title 매개변수를 사용하면 폴더 및 대시보드 상단에서 사용자에게 대시보드 이름이 표시되는 방식을 변경할 수 있습니다. 지정하지 않으면 제목은 기본적으로 대시보드 이름으로 지정됩니다. 제목 텍스트는 현지화할 수 있습니다.

다음 예를 참조하세요.

- dashboard: sales_overview
  title: "1) Sales Overview"

이렇게 하면 대시보드가 판매 개요 대신 1) 판매 개요로 표시됩니다.

description (대시보드용)

이 섹션에서는 대시보드에 포함된 description 매개변수를 참조합니다.

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

description은 description (필드의 경우) 매개변수 문서 페이지에 설명된 대로 필드의 일부로 사용할 수도 있습니다.

description 매개변수를 사용하면 LookML 대시보드에 설명을 추가할 수 있습니다.

description 매개변수의 콘텐츠는 LookML 대시보드의 대시보드 세부정보 패널의 설명 필드에 표시됩니다.

목록 보기로 설정된 폴더에서 볼 때 설명은 대시보드 목록의 대시보드 제목 아래에 표시됩니다. 설명을 지정하지 않으면 목록에 대시보드 제목만 표시됩니다.

설명 텍스트는 현지화할 수 있습니다.

enable_viz_full_screen

이 매개변수는 Looker 관리자가 전체 화면 시각화 설정을 사용 설정한 경우에만 적용됩니다. 전체 화면 시각화 설정은 기본적으로 사용 설정되어 있습니다.

enable_viz_full_screen 매개변수를 사용하면 대시보드 뷰어가 전체 화면 및 확장된 뷰로 대시보드 타일을 볼 수 있는지 여부를 설정할 수 있습니다. 시각화에 전체 화면 모드 허용 대시보드 설정과 동일합니다.

이 매개변수는 true (전체 화면 및 확장된 뷰 사용 가능) 및 false (전체 화면 및 확장된 뷰 사용 불가) 값을 허용합니다. 기본값은 true입니다.

extends

확장을 통해 코드 재사용 문서 페이지에 설명된 대로 extends 매개변수를 사용하면 한 LookML 대시보드를 다른 LookML 대시보드를 기반으로 하여 일부 설정을 추가하거나 재정의할 수 있습니다. extends 매개변수는 다른 LookML 대시보드의 이름을 허용합니다.

객체를 확장하는 경우 현지화 규칙이 확장에도 적용됩니다. 객체를 확장한 다음 새 라벨 또는 설명을 정의하는 경우 프로젝트의 언어 문자열 파일에 현지화 정의를 제공해야 합니다. 자세한 내용은 LookML 모델 현지화 문서 페이지를 참조하세요.

extension

확장을 통해 코드 재사용 문서 페이지에 설명된 대로 extension 매개변수는 대시보드를 다른 대시보드로 확장해야 함을 나타냅니다. 이 대시보드는 다른 사용자에게 표시되지 않지만 다른 사용자에게 표시되는 다른 대시보드를 만드는 템플릿으로 사용할 수 있습니다. extension 매개변수는 required 값만 허용합니다. extension 파라미터가 포함되지 않은 경우 대시보드에 확장 프로그램이 필요하지 않습니다.

layout

layout 매개변수는 Looker가 대시보드 요소를 배치할 때 사용할 레이아웃 방법을 설정합니다. 다음 값을 허용합니다.

rows

layout: grid 대시보드의 경우 rows 매개변수는 LookML 섹션을 시작합니다. 이 섹션에서는 어떤 요소를 어떤 행에 배치할지, 각 행의 높이를 정의합니다. 각 행 내에서 각 요소의 너비는 동일합니다. 이 섹션에 요소를 나열하지 않으면 대시보드에 표시되지 않습니다.

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

elements 매개변수는 쉼표로 구분된 대시보드 요소 이름 목록을 사용합니다. 각 elements 선언은 대시보드에 새 행을 만듭니다. 행에 배치된 요소는 모두 너비가 동일합니다. 따라서 한 행에 요소를 2개 배치하면 각 요소가 사용 가능한 공간의 50% 를 차지합니다. 한 행에 4개의 요소를 배치하면 각 요소가 사용 가능한 공간의 25% 를 차지합니다.

height

height 매개변수는 행의 높이를 픽셀 단위로 정의합니다. 기본값은 300입니다.

tile_size

layout: tile 및 layout: static 대시보드의 경우 요소의 크기를 조정하고 위치를 지정하는 데 사용되는 단위는 타일 크기입니다. tile_size은 픽셀로 정의되며 기본값은 160입니다. 예를 들면 다음과 같습니다.

- dashboard: sales_overview
  layout: tile
  tile_size: 100

이 경우 height: 5 및 width: 3이 있는 대시보드 요소는 높이가 500픽셀이고 너비가 300픽셀입니다. height 및 width 매개변수는 모든 요소 유형에 적용되며, 사용 세부정보는 개별 시각화 유형의 문서 페이지에 표시됩니다. height 및 width 작동 방식에 관한 대표적인 예시는 LookML 대시보드의 열 차트 매개변수 문서 페이지를 참고하세요.

width

이 섹션에서는 대시보드에 포함된 width 매개변수를 참조합니다.

width는 대시보드 요소의 일부로도 사용할 수 있습니다. 열 차트 요소 문서 페이지에 사용 사례의 대표적인 예가 나와 있습니다.

layout: static 대시보드의 경우 width 매개변수는 사용할 계획인 총 대시보드 너비를 픽셀 단위로 정의합니다. width 매개변수는 너무 큰 요소나 너무 많은 요소를 한 행에 정의하는 경우 대시보드를 특정 크기로 제한하지 않습니다. width 설정은 대시보드를 화면 중앙에 유지하는 데 도움이 됩니다. 너비를 설정하지 않으면 기본값은 1200입니다.

- dashboard: sales_overview
  layout: static
  width: 800

refresh

이 섹션에서는 대시보드에 포함된 refresh 매개변수를 참조합니다.

refresh는 대시보드 요소의 일부로도 사용할 수 있습니다. 열 차트 요소 문서 페이지에 사용 사례의 대표적인 예가 나와 있습니다.

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

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

- dashboard: sales_overview
  refresh: 2 hours

짧은 새로고침 간격을 설정할 때는 주의하세요. 대시보드에는 리소스 집약적인 쿼리가 많이 포함될 수 있으므로 특정 대시보드가 데이터베이스에 부담을 줄 수 있습니다.

auto_run

auto_run 매개변수는 대시보드를 처음 열거나 새로고침할 때 대시보드가 실행되는지 여부를 결정합니다. 기본값은 true입니다. 이 매개변수가 false로 설정되면 사용자가 실행 버튼을 눌러 대시보드를 로드해야 합니다. 예를 들어 다음과 같은 대시보드는 열면 자동으로 실행됩니다.

- dashboard: sales_overview
  auto_run: true

auto_run 설정과 관계없이 사용자는 필터 값을 변경한 후 항상 실행 버튼을 클릭해야 합니다. 이렇게 하면 사용자가 필터 변경 중에 일시중지하거나 여러 필터를 동시에 변경하려고 할 때 원치 않는 새로고침을 방지할 수 있습니다.

crossfilter_enabled

crossfilter_enabled 매개변수를 사용하면 대시보드에 대해 교차 필터를 사용 설정하거나 사용 중지할 수 있습니다. 이 매개변수가 true로 설정되면 대시보드 보기 권한 사용자가 특정 데이터 포인트를 클릭하여 대시보드에서 교차 필터를 만들 수 있습니다.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

filters_bar_collapsed 매개변수를 사용하면 대시보드의 대시보드 필터 표시줄을 기본적으로 접거나 펼치도록 설정할 수 있습니다. 이 매개변수가 true로 설정되면 필터 바가 기본적으로 접힙니다. 대시보드 뷰어는 필터 아이콘을 클릭하여 필터 표시줄을 펼칠 수 있습니다. 이 설정의 기본값은 false입니다.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

filters_location_top 매개변수를 사용하면 대시보드의 상단 또는 오른쪽에 대시보드 필터 표시줄을 배치할 수 있습니다. 이 매개변수가 true로 설정되면 필터 표시줄이 대시보드 상단에 표시되고, false로 설정되면 필터 표시줄이 대시보드 오른쪽에 표시됩니다. 이 설정의 기본값은 true입니다.

- dashboard: sales_data
  filters_location_top: false

filters

이 섹션에서는 대시보드에 포함된 filters 매개변수를 참조합니다.

filters는 대시보드 요소의 일부로도 사용할 수 있습니다. 열 차트 요소 문서 페이지에 사용 사례의 대표적인 예가 나와 있습니다.

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

filters 매개변수는 대시보드 필터를 정의하는 LookML 섹션을 시작합니다. 필터는 대시보드 상단에 표시되며 사용자가 대시보드 요소의 데이터를 변경할 수 있습니다.

필터가 요소에 영향을 미치려면 listen 매개변수를 사용하여 해당 필터를 '수신'하도록 요소를 설정해야 합니다. 이 매개변수는 type: text 및 type: button를 제외한 모든 요소 유형에 적용됩니다. listen 작동 방식에 관한 대표적인 예시는 LookML 대시보드의 열 차트 매개변수 문서 페이지를 참고하세요.

이러한 방식으로 요소에 필터를 적용할 때는 필터 유형이 필터를 수신하는 측정기준 또는 측정 유형과 일치해야 합니다 (자세한 내용은 LookML 대시보드 빌드 참고). 필터의 형식은 다음과 같습니다.

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter | string_filter
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

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

name는 대시보드 요소의 일부로도 사용할 수 있습니다. 열 차트 요소 문서 페이지에 사용 사례의 대표적인 예가 나와 있습니다.

각 name 선언은 새 대시보드 필터를 만들고 이름을 할당합니다. 이름은 필터의 영향을 받는 요소의 listen 매개변수에서 참조됩니다. listen 매개변수는 type: text를 제외한 모든 요소 유형에 적용되며, 사용 세부정보는 개별 시각화 유형의 문서 페이지에 표시됩니다. listen 작동 방식에 관한 대표적인 예시는 LookML 대시보드의 열 차트 매개변수 문서 페이지를 참고하세요.

filters:
- name: order_date

title (필터용)

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

title는 이 페이지의 title (대시보드용) 섹션에 설명된 대로 대시보드의 일부로 사용할 수도 있습니다.

title는 대시보드 요소의 일부로도 사용할 수 있습니다. 사용 사례의 대표적인 예시는 LookML 대시보드의 열 차트 매개변수 문서 페이지를 참고하세요.

title 매개변수를 사용하면 대시보드 상단에 필터 이름이 사용자에게 표시되는 방식을 변경할 수 있습니다. 지정하지 않으면 제목은 기본적으로 필터 이름으로 지정됩니다.

다음 예를 참조하세요.

filters:
- name: order_date
  title: "Order Date(s)"

이렇게 하면 필터가 주문일이 아닌 주문일로 표시됩니다.

type

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

type은 대시보드 요소의 일부로도 사용할 수 있으며, 이에 대한 설명은 type (LookML 대시보드용) 매개변수 문서 페이지를 참고하세요.

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

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

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

type 매개변수는 필터에 배치될 입력의 유형을 지정합니다. 날짜와 같은 모든 유형의 입력을 type: string_filter 필터에 작성할 수 있지만, 더 구체적으로 작성하면 사용자에게 더 맞춤화된 필터 위젯이 제공됩니다. 필터에는 다음 4가지 유형이 있습니다.

  • field_filter: 기본 측정기준 또는 측정값을 지정할 수 있는 경우 일반적으로 기본 선택사항입니다. type: field_filter를 사용하고 필터를 type:string 필드와 연결하면 필터에서 가능한 필터 값을 추천합니다.
  • number_filter: 사용자가 숫자/정수 값 또는 표현식을 입력할 수 있습니다.
  • date_filter: 사용자가 날짜 값 또는 표현식을 입력할 수 있습니다.
  • string_filter: 사용자가 자유 형식 텍스트를 입력할 수 있습니다.

field_filter

선택할 수 있는 옵션을 제안하고, 지정한 기본 필드에 따라 사용자에게 표시되는 방식을 변경합니다.

이 필터 유형은 사용자가 필터와 상호작용할 때 사용자에게 추천을 제공하려는 상황에서 기본 필터 유형으로 사용해야 합니다. 추천이 가져올 측정기준은 explore 및 field 매개변수를 사용하여 정의되며, 필터 추천을 생성하려면 type: string의 필드여야 합니다.

필드가 파생 테이블에서 가져온 경우, Explore에서 sql_always_where가 사용된 경우 또는 필드가 측정값인 경우 추천이 작동하지 않을 수 있습니다.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date  # must be of the form view_name.dimension_name

number_filter

제안을 하지 않으며 사용자가 정수/숫자 값 또는 표현식을 입력할 수 있습니다.

filters:
- name: order_value
  type: number_filter

date_filter

추천을 제공하지 않으며 사용자가 날짜 값 또는 표현식을 입력할 수 있습니다.

filters:
- name: order_date
  type: date_filter

string_filter

추천을 제공하지 않고 사용자가 자유 형식 텍스트를 입력할 수 있습니다.

filters:
- name: customer_name
  type: string_filter

default_value

default_value 매개변수를 사용하면 필터에 사용할 기본값을 지정할 수 있습니다. 이 값은 적절한 시작점을 제안하여 사용자에게 도움이 될 수 있습니다.

사용 중인 필터 유형과 기본값을 일치시켜야 합니다. 예를 들면 다음과 같습니다.

filters:
- name: order_value
  type: number_filter
  default_value: "50 to 100"

- name: order_date
  type: date_filter
  default_value: "last 30 days"

- name: customer_name
  type: string_filter
  default_value: "John Doe"

필터 표현식을 사용하여 기본값을 만들 수 있습니다. 자세한 내용은 Looker 필터 표현식 문서 페이지를 참고하세요.

default_value 및 ui_config 매개변수를 모두 사용하는 경우 필터 표현식은 ui_config의 type 하위 매개변수에 지정된 값과 type 값을 지원하는 데이터 유형과 호환되어야 합니다.

_localization 및 _user_attributes Liquid 변수를 사용하여 유연한 기본 필터 값을 설정할 수도 있습니다.

allow_multiple_values

allow_multiple_values 매개변수를 사용하면 사용자가 단일 필터 값을 선택할 수 있는지 또는 여러 필터 값을 선택할 수 있는지 제어할 수 있습니다. 이 매개변수가 true (기본값)로 설정되면 사용자가 필터 값을 여러 개 선택할 수 있습니다. 이 매개변수가 false로 설정되면 사용자가 필터 값을 하나만 선택할 수 있습니다.

예를 들면 다음과 같습니다.

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

required 매개변수를 사용하면 사용자가 대시보드를 실행하기 위해 필터 값을 제공하도록 요구할 수 있습니다. 기본적으로 필터에는 값이 필요하지 않습니다. 값이 필요 없는 필터를 공백으로 두면 필터 필드에 의해 데이터가 제한되지 않습니다. 값이 필요하고 비워진 필터가 있으면 대시보드가 실행되지 않습니다.

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

filters의 ui_config 하위 매개변수를 사용하면 LookML 대시보드의 필터 설정을 구성할 수 있습니다. 이러한 설정에는 사용된 필터 컨트롤의 유형, 필터 컨트롤의 배치, 가능한 필터 값이 포함됩니다.

예를 들면 다음과 같습니다.


  filters:
  - name: City
    title: City
    type: field_filter
    default_value: San Francisco
    allow_multiple_values: true
    required: false
    ui_config:
      type: button_group
      display: inline
      options:
      - San Francisco
      - New York
      - Tokyo
    model: thelook
    explore: order_items
    field: users.city

UI로 필터를 구성하는 방법에 대한 자세한 내용은 사용자 정의 대시보드 필터 추가 및 수정 문서 페이지를 참고하세요.

type

ui_config의 type 하위 매개변수를 사용하면 표시되는 필터 컨트롤 유형을 지정할 수 있습니다.

type에 입력하는 값에 따라 필터 컨트롤이 단일 선택 또는 다중 선택이 될 수 있습니다.

type에서 지원하는 값은 필터링하려는 필드에 할당된 LookML 데이터 type에 따라 달라집니다.

STR = string 데이터 유형과 호환됨 DIST = distance 데이터 유형과 호환됨
NUM = number 데이터 유형 및 숫자 측정값과 호환됨 DUR = duration 데이터 유형과 호환됨
TIER = tier 데이터 유형과 호환됨 D&T = 대부분의 날짜 및 시간 데이터 유형과 호환됨
ZIP = zipcode 데이터 유형과 호환됨 LOC = location 데이터 유형과 호환됨
Y/N = yesno 데이터 유형과 호환됨 PAR = parameter 매개변수와 호환됨
값설명지원되는 데이터 유형
다중 선택
button_group 필터에는 options 매개변수로 지정된 각 값에 대한 버튼이 포함된 버튼 그룹이 표시됩니다. STR NUM TIER ZIP Y/N DIST DUR
checkboxes 필터에는 options 매개변수로 지정된 각 값에 대해 하나의 체크박스가 표시됩니다. STR NUM TIER ZIP Y/N DIST DUR
tag_list 필터에는 options 매개변수를 사용하여 지정된 각 가능한 값이 나열된 드롭다운이 표시됩니다. STR NUM TIER ZIP DIST DUR
range_slider 숫자 필드의 경우 필터에 슬라이더가 표시되어 사용자가 숫자 범위를 필터 값으로 설정할 수 있습니다. options의 min 및 max 하위 매개변수는 필터의 최소 및 최대 가능 값을 지정하는 데 사용되며 기본 범위는 default_value 매개변수를 사용하여 지정할 수 있습니다. NUM DIST DUR
단일 선택
button_toggles 필터에는 options 매개변수로 지정된 각 값에 대한 버튼이 포함된 버튼 그룹이 표시됩니다. STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons 필터에는 모든 값 버튼과 options 매개변수로 지정된 각 값의 버튼이 있는 라디오 버튼이 표시됩니다. STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu 필터에는 options 매개변수를 사용하여 지정된 각 가능한 값이 나열된 드롭다운 메뉴가 표시됩니다. 드롭다운에는 사용자가 모든 값을 선택할 수 있는 옵션도 제공됩니다. STR NUM TIER ZIP Y/N DIST DUR PAR
slider 숫자 필드의 경우 필터에 슬라이더가 표시되어 사용자가 options 매개변수를 사용하여 지정된 가능한 최솟값과 최댓값 사이를 슬라이드하여 필터를 선택할 수 있습니다. NUM DIST DUR
날짜 및 시간
day_picker 필터를 사용하면 사용자가 필터링할 특정 날짜를 선택할 수 있습니다. D&T 하루 컨트롤은 대부분의 타임프레임 및 시간 기반 유형과 함께 사용할 수 있으나, 뷰어는 이 컨트롤 유형으로만 하루를 선택할 수 있습니다.
day_range_picker 필터를 사용하면 사용자가 시작일과 종료일을 선택하여 날짜 범위를 기준으로 필터링할 수 있습니다. D&T 기간 컨트롤은 대부분의 타임프레임 및 시간 기반 유형과 함께 사용할 수 있으나, 뷰어는 이 컨트롤 유형으로만 기간을 선택할 수 있습니다.
date_time_range_input 이 필터를 사용하면 사용자가 날짜 및 시간 범위를 기준으로 필터링할 수 있습니다. D&T 날짜 및 시간 범위 컨트롤은 대부분의 시간 기반 유형과 함께 사용할 수 있으며, 뷰어는 이 컨트롤 유형으로 날짜와 시간 옵션을 모두 선택해야 합니다.
relative_timeframes 이 필터를 사용하면 사용자가 맞춤 기간을 기준으로 필터링하거나 오늘, 지난 7일, 지난 90일과 같은 기간 사전 설정 중에서 선택할 수 있습니다. D&T 타임프레임 컨트롤을 대부분의 타임프레임 및 시간 기반 유형에서 사용할 수 있지만 뷰어는 이 컨트롤 유형에서 시간 옵션을 선택할 수 없습니다.
기타
advanced필터에는 하나 이상의 필터 또는 고급 일치 필터를 적용하는 옵션이 표시됩니다.

고급 컨트롤에 대한 자세한 내용은 이 페이지의 고급 컨트롤 사용 섹션을 참조하세요. 		STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

display

ui_config의 display 하위 매개변수를 사용하여 대시보드 필터의 위치를 설정할 수 있습니다. display에 다음 값 중 하나를 할당하여 필터를 배치할 수 있습니다.

  • inline: 필터가 대시보드의 상단 막대에 직접 표시됩니다.
  • popover: 대시보드의 상단 막대에 요약 값이 표시됩니다. 전체 필터를 확인하려면 값을 클릭합니다.
  • overflow: 대시보드의 상단 막대에 오버플로 필터의 수를 나타내는 숫자 표시기와 함께 더보기 버튼이 표시됩니다. 사용자는 버튼을 클릭하여 오버플로 필터와 값을 확인할 수 있습니다.

일부 필터 유형은 특정 방식으로만 표시할 수 있습니다. 예를 들어 type: day_picker 필터는 inline 또는 overflow로만 표시할 수 있습니다. 필터에 해당 type에 유효하지 않은 display 값을 지정하면 유효한 값인 inline 또는 popover 중 하나로 필터가 표시됩니다. 자세한 내용은 사용자 정의 대시보드 필터 추가 및 수정 문서 페이지를 참고하세요.

UI를 사용하여 대시보드 필터를 배치하는 방법에 대한 자세한 내용은 사용자 정의 필터 추가 및 수정 문서 페이지를 참고하세요.

options

ui_config의 선택적 options 하위 매개변수를 사용하면 사용자가 LookML 대시보드를 볼 때 대시보드 필터 값을 일시적으로 업데이트하기 위해 선택할 수 있는 값을 지정할 수 있습니다. options 값을 지정하지 않으면 Looker가 데이터베이스에서 첫 번째 값을 가져옵니다.

예를 들어 users.city 필드의 필터에 가능한 값으로 San Francisco, New York, Tokyo를 다음과 같이 설정할 수 있습니다.


ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

ui_config의 type 하위 매개변수가 range_slider 또는 slider로 설정된 경우 options의 min 및 max 하위 매개변수를 사용할 수 있습니다.

  • min: 필터의 최소 가능 값을 설정합니다.
  • max: 필터의 최대 가능 값을 설정합니다.

예를 들면 다음과 같습니다.


ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

type: field_filter의 대시보드 필터의 경우 필터가 추천을 가져올 모델을 정의해야 합니다. model 매개변수는 사용할 필드가 포함된 모델을 지정합니다.

filters:
- name: State
  title: State
  type: field_filter
  default_value: California
  model: thelookstore
  explore: users
  field: users.state

explore

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

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

explore는 대시보드 요소의 일부로도 사용할 수 있습니다. 열 차트 요소 문서 페이지에 사용 사례의 대표적인 예가 나와 있습니다.

type: field_filter의 대시보드 필터의 경우 필터가 추천을 가져올 필드를 정의해야 합니다. explore 파라미터는 사용할 필드가 포함된 Explore를 지정합니다.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

type: field_filter의 대시보드 필터의 경우 필터가 추천을 가져올 필드를 정의해야 합니다. field 매개변수는 사용할 필드를 지정합니다. 범위가 지정된 전체 필드 이름을 사용하는 것이 중요합니다. 즉, field_name뿐만 아니라 view_name.field_name도 사용합니다.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

type: field_filter의 대시보드 필터의 경우 사용자가 type: field_filter의 다른 필터에 입력한 내용을 기반으로 필터에 대한 추천을 좁힐 수 있습니다.

다음 예시에서 State 필터에 제공되는 추천은 Order ID 필터의 값을 기반으로 합니다. Order ID 필터에 선택된 값에는 연결된 users.state 값이 있으며, 이러한 값은 State 필터의 추천 값이 됩니다. 자세한 내용은 사용자 정의 대시보드 필터 추가 및 수정 문서 페이지를 참고하세요.

filters:
- name: State
  title: State
  type: field_filter
  model: thelookstore
  explore: users
  listens_to_filters:
  - Order ID
  field: users.state

embed_style

embed_style 매개변수는 삽입된 대시보드의 모양을 맞춤설정하는 LookML 섹션을 시작합니다. embed_style 및 관련 매개변수는 삽입된 대시보드에서만 지원되며 대시보드가 삽입되지 않은 경우 무시됩니다.

embed_style를 변경한 후 삽입된 LookML 대시보드에 embed_style 설정이 반영되도록 하려면 LookML을 프로덕션에 배포해야 합니다.

색상을 지정하는 다음 삽입된 대시보드 속성의 경우 색상 값은 #2ca6cd와 같은 16진수 문자열 또는 mediumblue와 같은 색상이 지정된 CSS 문자열일 수 있습니다.

삽입된 대시보드 맞춤설정의 형식은 다음과 같습니다.

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

삽입된 대시보드의 배경 색상을 설정합니다.

embed_style:
  background_color: "#ffffff"

show_title

삽입된 대시보드 제목이 사용자에게 표시되는지 여부를 지정합니다.

embed_style:
  show_title: false

title_color

삽입된 대시보드의 제목 색상을 설정합니다.

embed_style:
  title_color: "#008000"

show_filters_bar

삽입된 대시보드 필터가 사용자에게 표시되는지 여부를 지정합니다.

이 매개변수는 대시보드의 외관에만 영향을 미치며 사용자의 데이터 액세스 기능에는 영향을 미치지 않습니다. 필터 표시줄을 숨겨도 사용자가 다른 방법으로 필터를 변경하는 것을 막을 수는 없습니다. 보안 데이터 액세스 제어 정책을 설정하는 방법은 액세스 제어 및 권한 관리 문서 페이지를 참고하세요.

embed_style:
  show_filters_bar: true

tile_background_color

삽입된 대시보드의 모든 타일의 배경 색상을 설정합니다.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

삽입된 대시보드의 모든 타일에 있는 텍스트의 색상을 설정합니다.

embed_style:
  tile_text_color: "crimson"

elements

이 섹션에서는 dashboard의 일부인 elements 매개변수를 참조합니다.

elements는 이 페이지의 행의 elements 섹션에 설명된 대로 대시보드 행의 일부로 사용할 수도 있습니다.

elements 매개변수는 대시보드를 구성하는 요소를 정의하는 LookML 섹션을 시작합니다. 대시보드 요소의 모양을 정의할 수 있는 매개변수는 다양합니다. 자세한 내용은 대시보드 요소 매개변수 페이지를 참고하세요.

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

LookML 대시보드에 추가하는 요소의 수와 복잡성을 생각해 보세요. 더 많은 요소는 더 많은 브라우저 리소스가 필요하므로 대시보드 렌더링 시간이 길어집니다. 마찬가지로 많은 양의 데이터를 렌더링하는 요소는 대시보드 성능에 영향을 미칠 수 있습니다. 렌더링에 문제가 발생하면 대시보드 요소 쿼리의 복잡성을 줄이거나 요소 수가 적은 여러 대시보드를 만드는 것이 좋습니다.