LookML 대시보드는 LookML 개발자가 만들고 버전 제어 파일로 저장됩니다. 기본적으로 Looker 인스턴스의 LookML 대시보드 폴더에 표시됩니다.
LookML 대시보드와 사용자 정의 대시보드를 비교 및 대조하려면 사용자 정의 대시보드와 LookML 대시보드 비교 문서 페이지를 참조하세요.
LookML 대시보드를 만들려면 다음 Looker 권한이 있어야 합니다.
또한 대시보드에서 사용하려는 모든 데이터에 대한 LookML 모델에 액세스할 수 있어야 합니다.
LookML 대시보드 파일 만들기
LookML 대시보드를 빌드하려면 먼저 확장 프로그램 .dashboard.lookml이 포함된 대시보드 파일을 만듭니다. 단, 확장 프로그램의 .lookml 부분은 IDE 내에 표시되지 않습니다. 이를 수행하는 단계는 아래에 나와 있습니다.
- 개발 모드를 사용 설정합니다.
- 개발 메뉴에서 프로젝트로 이동합니다.
- Looker IDE의 파일 브라우저 패널 상단에 있는 파일 또는 폴더 추가 더하기 아이콘을 선택하여 기존 프로젝트 폴더 외부에 LookML 대시보드 파일을 만듭니다. 또는 폴더의 점 3개로 된 폴더 옵션 메뉴를 클릭하여 폴더 안에 파일을 만듭니다. 대시보드 만들기를 클릭하여 대시보드 파일을 만듭니다.
- 파일 만들기 창이 나타납니다. 창 내에서 쓰기 필드에 대시보드 파일의 이름을 지정하고 만들기 버튼을 선택합니다.
LookML 대시보드 파일 수정
LookML 대시보드 파일을 만들면 전체 대시보드에 대한 설정을 구현하는 몇 가지 기본 대시보드 매개변수가 Looker에 자동 입력됩니다. 또한 elements 대시보드 매개변수 아래에 그룹화되고 대시보드 타일, 텍스트, 버튼의 기능과 모양을 정의하는 여러 샘플 대시보드 요소 매개변수로 파일을 미리 채웁니다. 새로 만든 .dashboard.lookml 파일에는 다음과 비슷한 대시보드 LookML이 포함됩니다.
- dashboard: order_analysis
title: Order Analysis
layout: newspaper
preferred_viewer: dashboards-next
tile_size: 100
filters:
elements:
- name: hello_world
type: looker_column
개발 모드에 있다면 IDE 내에서 대시보드 파일을 수정할 수 있습니다.
대시보드를 만드는 방법에는 여러 가지가 있습니다.
- 수동 생성: 대시보드 매개변수와 대시보드 요소 매개변수를 사용하여 수동으로 대시보드를 빌드할 수 있습니다.
- 사용자 정의 대시보드 복사: 파일에서 자동 입력된 대시보드 LookML을 삭제하고 사용자 정의 대시보드에서 대시보드 LookML을 복사한 다음 대시보드 파일에 붙여넣어 사용자 정의 대시보드의 사본을 만들 수 있습니다.
- 요소의 대시보드 LookML 복사: Explore 또는 Look에서 대시보드 LookML을 복사하여 대시보드 파일에 붙여넣을 수 있습니다.
대시보드를 만들 때는 대시보드 생성 시 권장사항에 유의하세요. 고성능 Looker 대시보드를 빌드할 때 고려할 사항 권장사항 페이지에서 고성능 대시보드 빌드에 관한 정보 및 권장사항을 찾아보세요.
기존 LookML 대시보드에 시각화 추가
기존 LookML 대시보드에 시각화를 추가하는 가장 쉬운 방법은 Explore 페이지를 사용하여 대시보드 요소로 변환하려는 쿼리를 작성하는 것입니다.
- 대시보드에 추가할 쿼리와 시각화를 만들었으면 Explore의 Explore 작업 톱니바퀴 메뉴를 클릭합니다.
LookML 가져오기를 선택하여 LookML을 노출합니다.
LookML 가져오기 창이 나타납니다. 창에서 대시보드를 선택한 상태에서 모든 LookML을 선택하고 복사합니다.
여기에서 대시보드 LookML 파일에 LookML을 붙여넣습니다. 대시보드 LookML 파일을 수정할 때는 다음 사항을 확인하세요.
- 대시보드 파일을 수정할 수 있도록 개발 모드에 있는지 확인합니다.
- LookML을 대시보드의
elements매개변수 아래에 붙여넣습니다. - LookML을 대시보드 파일에 붙여넣을 때 올바른 들여쓰기를 사용합니다. 가능한 경우 들여쓰기를 대시보드 파일에 이미 있는 기존 요소와 일치시킵니다.
원하는 경우 개별 요소 유형의 문서 페이지에 설명된 매개변수를 사용하여 LookML 매개변수를 조정할 수 있습니다.
필터 추가
대시보드 파일에 대시보드 요소를 저장한 후 대시보드 뷰어가 대시보드의 일부 또는 모든 요소를 필터링할 수 있도록 하는 필터를 추가할 수 있습니다. 필터는 다음과 같은 여러 이유로 유용할 수 있습니다.
- 표시되는 기간 조정
- 표시되는 특정 제품 카테고리, 고객 유형 등의 조정
- 클라이언트 또는 고객에게 '조회' 유형 기능 제공
원하는 필터 유형을 만들어야 합니다. 두 가지 유형은 다음과 같습니다.
- 대시보드 뷰어가 변경할 수 없는 대시보드 요소에 하드 코딩하는 필터
- 대시보드 뷰어가 변경 할 수 있는 대시보드 필터
대시보드 요소에 하드 코딩된 필터
사용자가 변경할 수 없는 대시보드 요소에 하드 코딩하는 필터는 일반적으로 시각화 또는 대시보드의 LookML 복사 단계에서 자동으로 생성됩니다. LookML 대시보드에서 이러한 필터는 filters 대시보드 요소 매개변수를 사용하며 다음과 같습니다.
- name: element_name
# lots of other element parameters here
filters:
dimension_or_measure_name: 'looker filter expression'
대시보드 필터
대시보드 필터를 사용하면 뷰어가 대시보드 요소에 표시되는 데이터를 대화식으로 미세 조정할 수 있습니다. 대시보드를 만들려면 다음 단계를 따르세요.
대시보드 필터 만들기
filters 매개변수를 사용하면 대시보드에 다양한 유형의 대화형 필터를 만들 수 있습니다.
사용자가 상호작용할 수 있는 대시보드 필터를 만들려면 대시보드 파일에 filters 파라미터를 추가합니다. 예를 들어 다음 샘플 코드는 date 및 category_name 필터가 있는 LookML 대시보드를 만듭니다.
- dashboard: dashboard_name
title: Dashboard Title
layout: newspaper
filters:
- name: date
title: 'Date Range'
type: date_filter
default_value: 30 days
- name: category_name
type: field_filter
model: ecommerce
explore: product
field: category.name
위 예시의 코드는 다음 필터를 만듭니다.
date: 사용자가 기간을 선택할 수 있는 날짜 필터입니다. 기본값은 최근 30일로 설정됩니다.category_name: 사용자가 제품 카테고리별로 필터링할 수 있는 필드 필터입니다. 이 필터는 지정된 LookML 모델(ecommerce) 및 Explore(product) 내의category.name필드를 기반으로 하는 옵션을 동적으로 생성합니다.
대시보드 요소에 대시보드 필터 적용
대시보드 필터를 만든 후에는 listen 파라미터를 사용하여 개별 대시보드 요소에 필터를 적용할 수 있습니다. 이러한 방식으로 listen 파라미터를 사용하면 필터에서 사용자가 선택한 항목에 따라 연결된 요소를 동적으로 업데이트할 수 있습니다.
예를 들어 영역 차트 요소에 다음과 같은 샘플 LookML 코드 사용을 고려해 보세요.
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
쿼리가 orders_created_date 측정기준과 orders.count 측정을 기준으로 하고 orders.status: 'approved' 필터가 적용되어 있으므로 approved_orders_by_day 차트에는 승인된 주문 수가 일별로 표시됩니다. 이 필터는 요소 내에 고정되어 있으며 대시보드 뷰어에서 수정할 수 없습니다.
사용자가 이전 예시의 date 필터 및 category_name 필터를 사용하여 approved_orders_by_day 차트를 필터링할 수 있도록 하려면 대시보드 요소에 listen 파라미터를 추가합니다.
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
listen:
category_name: category.name
date: orders.created_date
대시보드 뷰어가 category_name 필터 또는 date 필터와 상호작용하면 필터링된 결과를 반영하도록 approved_orders_by_day 차트가 자동으로 업데이트됩니다.
listen 파라미터는 filter_name: field_name 구문을 사용합니다. 앞의 예시에서 category_name 및 date는 필터 이름이고 category.name 및 orders.created_date는 대시보드 뷰어가 필터에 입력을 제공할 때 사용되는 필드입니다.
대시보드 필터는 특정 요소의 모든 필드(동일한 데이터 유형)에 적용할 수 있습니다. 예를 들어 한 요소는 주문 생성 날짜(date: orders.created_date)에 사용자의 입력을 적용하고 다른 요소는 이를 주문 배송 날짜(date: orders.ship_date)에 적용할 수 있습니다.
- name: element_one
# lots of other element parameters here
listen:
date: orders.created_date
- name: element_two
# lots of other element parameters here
listen:
date: orders.ship_date
모델에 대시보드 파일 포함
대시보드를 개발 모드에서 미리 보거나 프로덕션에 표시하려면 include 문을 사용하여 대시보드를 기반으로 하는 모델 파일에 대시보드를 포함해야 합니다.
일반적인 방법은 와일드 카드를 사용하여 모델에 모든 LookML 대시보드를 포함하는 것입니다.
include: "*.dashboard.lookml"
또는 LookML 대시보드가 IDE의 폴더 안에 표시되는 경우 위치 경로를 사용합니다.
include: "/path/*.dashboard.lookml"
파일 이름을 지정하여 특정 대시보드를 포함할 수도 있습니다.
include: "my_dashboard.dashboard.lookml"
LookML 대시보드 저장, 미리보기, 게시
대시보드를 미리 보려면 다음 안내를 따르세요.
- 파일 오른쪽 상단에 있는 변경사항 저장 버튼을 클릭하여
.dashboard.lookml파일을 저장합니다. - 관련 모델 파일에 대시보드를 포함하고 해당 파일의 변경사항을 저장합니다.
- 미리 보려는
.dashboard.lookml파일에서 아래쪽 화살표 파일 작업 보기 아이콘을 클릭하고 대시보드 보기를 선택합니다.
.dashboard.lookml 파일을 추가로 변경하고, 저장하고, 대시보드를 다시 미리 볼 수 있습니다.
대시보드가 마음에 들면 프로덕션에 게시하여 올바른 권한이 있는 다른 사용자가 볼 수 있도록 합니다. 대시보드를 게시하는 방법은 인스턴스의 LookML에 다른 변경사항을 게시하는 것과 동일하며 Looker 인스턴스의 버전 제어 설정에 따라 달라집니다.
LookML 대시보드 폴더
게시된 LookML 대시보드는 기본적으로 LookML 대시보드 폴더에 저장됩니다. LookML 대시보드 폴더는 왼쪽 탐색 메뉴의 폴더 폴더에 있습니다. LookML 대시보드 폴더는 다음과 같은 점에서 다른 폴더와 다릅니다.
- LookML 대시보드를 하나 이상의 모델 파일에 포함해야 LookML 대시보드 폴더에 표시됩니다.
- LookML 대시보드 폴더를 보려면 사용자에게
see_lookml_dashboards권한이 있어야 합니다. - LookML 대시보드 폴더 내의 대시보드를 보려면 사용자는 대시보드가 포함된 LookML 모델에 액세스할 수 있어야 합니다.
- LookML 대시보드에서 타일을 보려면 대시보드 뷰어가 타일의 기반이 되는 LookML 모델에 액세스할 수 있어야 합니다.
- LookML 대시보드 폴더에서 대시보드를 수정하려면 LookML 대시보드가 포함된 모델에 대한
develop권한이 있어야 합니다. - 대시보드 내 특정 타일에서 여기에서 탐색을 수행하려면 대시보드 뷰어가 이 타일의 기반이 되는 모델에 대한
explore권한이 있어야 합니다. - LookML 대시보드 폴더 안에 폴더를 만들 수 없습니다.
LookML 대시보드를 LookML 대시보드 폴더 외부로 이동
see_lookml_dashboards 및 develop Looker 권한과 LookML 대시보드가 포함된 LookML 모델에 대한 액세스 권한이 있으면 액세스 관리, 수정 폴더 액세스 수준이 있는 폴더로 LookML 대시보드를 이동할 수 있습니다.
대시보드를 이동하는 방법에는 두 가지가 있습니다.
- LookML 대시보드 폴더에서 이동할 대시보드를 선택하고, 대시보드 섹션 상단에 있는 이동 버튼을 클릭한 후, 대시보드를 이동하려는 폴더를 선택합니다. 자세한 내용은 콘텐츠 구성 및 관리 문서 페이지를 참조하세요.
- LookML 대시보드 폴더에서 대시보드의 점 3개로 된 메뉴를 클릭하고, 메뉴에서 이동을 선택한 후, 대시보드를 이동할 폴더를 선택합니다.
개발 모드에서는 LookML 대시보드를 LookML 대시보드 폴더 밖으로 이동할 수 없습니다. 대신 가져오기 옵션을 사용하여 LookML 대시보드를 사용자 정의 대시보드로 다른 폴더에 복사할 수 있습니다.
사용자 정의 대시보드와 LookML 대시보드를 모두 포함하는 폴더는 LookML 대시보드 섹션에 LookML 대시보드를 표시합니다. LookML 대시보드 섹션에서 LookML 대시보드를 다른 폴더로 이동하거나 LookML 대시보드를 보드에 고정할 수 있습니다. 하지만 사용자 정의 대시보드와 달리 LookML 대시보드는 이름을 변경하거나 폴더에서 휴지통으로 이동할 수 없습니다.
LookML 대시보드의 dashboard 매개변수 값이 변경되면 LookML 대시보드는 자동으로 LookML 대시보드 폴더로 다시 이동합니다.
기존 LookML 대시보드의 LookML 보기
see_lookml 권한이 있으면 대시보드의 점 3개로 된 대시보드 작업 메뉴에서 LookML로 이동을 선택하여 기존 LookML 대시보드의 대시보드 LookML로 이동할 수 있습니다.
LookML로 이동을 선택하면 Looker가 LookML 대시보드가 정의된 대시보드 파일로 이동합니다.
LookML 대시보드 확장
LookML 대시보드를 만든 후에는 대시보드를 확장할 수 있습니다. 이렇게 하면 원래 설정을 기반으로 두 번째 대시보드를 만들고 일부 설정을 추가 또는 재정의할 수 있습니다. 그런 다음 첫 번째 대시보드를 변경하면 두 번째 대시보드에 이러한 변경사항이 자동으로 상속됩니다(두 번째 대시보드에서 재정의하지 않은 경우). 자세한 내용은 확장을 통해 코드 재사용 문서 페이지를 참조하세요.
집계 인식을 사용하여 대시보드 성능 향상
LookML 개발자는 집계 인식을 사용하여 LookML 대시보드 성능을 개선할 수 있습니다. 집계 인식을 사용하여 개발자가 LookML explore 매개변수 아래에 집계 테이블을 만들 수 있습니다. 이 매개변수를 통해 대시보드에서 하나 이상의 타일에 대한 쿼리를 최적화할 수 있습니다.
LookML 대시보드를 만들어 보고 나면 see_lookml 권한이 있는 경우 표시되는 점 3개로 된 대시보드 작업 메뉴에서 집계 테이블 LookML 가져오기 옵션을 사용할 수 있습니다.
자세한 내용은 aggregate_table 파라미터 문서 페이지를 참조하세요.