LookML 라이브러리 사용
MDE용 LookML 라이브러리는 BigQuery의 MDE 데이터를 기반으로 자체 LookML 모델을 빌드하는 데 도움이 되는 추상 핵심 파일과 패키지 뷰, 탐색, 대시보드를 제공합니다.
시작하기 전에
이 가이드를 완료하려면 다음 기본 요건이 필요합니다.
- 설정 가이드에 설명된 대로 MDE 프로젝트 템플릿을 사용하여 새 Looker 프로젝트를 구성했습니다.
- 활성 MDE 배포가 있습니다.
- 선택사항. 기본 MDE 구성 패키지를 적용했습니다. MDE LookML 라이브러리를 사용하여 맞춤 뷰를 만들 수 있지만 기본 LookML 패키지를 사용하려면 기본 MDE 구성 패키지를 적용해야 합니다.
보관함 콘텐츠 탐색
프로젝트가 허용되면 Looker 개발 콘솔의 imported_projects/mde_lookml_lib 디렉터리에서 라이브러리의 콘텐츠를 탐색할 수 있습니다. 이 라이브러리는 다음 두 디렉터리에 콘텐츠를 제공합니다.
mde_abstract_coremde_packages
추상 핵심 디렉터리
mde_abstract_core 디렉터리는 Looker에서 MDE 메타데이터 버킷을 측정기준으로, MDE 레코드 테이블을 팩트 테이블로 모델링하는 데 사용할 수 있는 기본 뷰를 제공합니다.
기본 뷰를 사용하면 이러한 뷰에서 공유 필드를 정의하지 않아도 됩니다.
이 라이브러리는 측정기준을 빌드하기 위한 dim_base.view 뷰를 제공하며, 이 뷰는 imported_projects/mde_lookml_lib/mde_abstract_core/views/dimension/dim_base.view.lkml에서 확인할 수 있습니다.
다음 예에서는 기본 뷰를 확장하여 device라는 측정기준을 정의하는 방법을 보여줍니다.
include: "//mde_lookml_lib/mde_abstract_core/views/dimension/*.view"
view: dim_source {
derived_table: {
sql: SELECT * FROM `mde_dimension.metadata-store` where bucket_number = BUCKET_NUMBER ;;
}
view_label: "DIM - Device"
extends: [ dim_base ]
dimension: device_name {
type: string
sql: JSON_VALUE(${TABLE}.instance,"$.device_name") ;;
}
}
마찬가지로 이 라이브러리는 BigQuery의 레코드 테이블을 팩트 테이블로 모델링하기 위해 MDE 원형별 기본 뷰를 제공합니다. 기본 뷰는 imported_projects/mde_lookml_lib/mde_abstract_core/views/fact/에서 확인할 수 있습니다. 원형 기본 뷰를 확장하여 Looker에서 맞춤 사실 뷰를 정의할 수 있습니다. 다음 예에서는 sensor_readings라는 사실 뷰를 정의하는 방법을 보여줍니다.
include: "//mde_lookml_lib/mde_abstract_core/views/fact/fct_numeric_archetype.view"
view: fct_sensor_readings {
extends: [ fct_numeric_archetype ]
label: "FCT - Sensor Readings"
sql_table_name: `mde_data.sensor-readings` ;;
}
패키지
mde_packages 디렉터리에는 MDE용 사전 빌드된 LookML 패키지가 포함되어 있습니다. 이러한 패키지는 빠르게 시작할 수 있도록 사용 사례별 탐색, 뷰, 대시보드를 제공합니다.
기본 Looker 구성 패키지는 기본 MDE 구성 패키지와 함께 작동합니다. 자세한 내용은 기본 구성 패키지 가이드를 참고하세요. 기본 Looker 구성 패키지는 MDE 유형에 연결된 레코드 테이블당 팩트 테이블을 제공하며, MDE의 태그 및 소스 메타데이터 버킷에 각각 해당하는 태그 및 소스 측정기준도 제공합니다.
MDE 프로젝트 템플릿을 사용하여 새 MDE 프로젝트를 부트스트랩한 경우 제공된 Looker 모델은 기본 패키지에서 뷰와 탐색 분석을 자동으로 가져옵니다.
connection: "@{looker_connection}"
########## DEFAULT MDE EXPLORES ##########
include: "//mde_lookml_lib/mde_packages/default/explores/default.explore.lkml"
############ CUSTOM VIEWS ################
include: "/views/dimension/*.view"
include: "/views/fact/*.view"
프로젝트가 설정되면 Looker의 기본 탐색 분석을 사용하여 데이터를 분석할 수 있습니다.
라이브러리에 포함된 다른 구성 패키지를 사용할 수도 있습니다. 라이브러리에서 이러한 패키지를 사용하는 데 필요한 추가 안내 및 필수사항은 다음 섹션을 참고하세요.
라이브러리의 구성 패키지에서 제공하는 뷰 확장
extends 구문을 사용하여 라이브러리에 포함된 사실 및 측정기준 뷰를 확장할 수 있습니다. 예를 들어 프로젝트 모델 파일에서 다음 스크립트와 같이 deviceMetadata 객체에 추가 측정기준 필드를 정의하여 dim_tag를 확장할 수 있습니다.
view: +dim_tag {
dimension: device_type {
type: string
sql: JSON_VALUE(${TABLE}.instance,"$.deviceMetadata.deviceType") ;;
}
dimension: location {
type: string
sql: JSON_VALUE(${TABLE}.instance,"$.deviceMetadata.location") ;;
}
}
대시보드 액세스는 default 구성 패키지에 정의되어 있습니다.
MDE 프로젝트 템플릿에 정의된 LookML 모델은 MDE LookML 라이브러리의 기본 패키지에서 모든 대시보드를 가져옵니다. 이러한 대시보드에 액세스하려면 다음 링크를 여세요.
https://LOOK_HOST/dashboards/mde::DASHBOARD_ID
다음을 바꿉니다.
LOOK_HOST을 Looker 인스턴스의 호스트 이름으로 바꿉니다.DASHBOARD_ID: 열려는 대시보드의 IDimported_projects/mde_lookml_lib/mde_packages/default/dashboards/디렉터리에서 관련 .dashboard 파일을 열고dashboard속성 값을 복사하여 대시보드 ID를 조회할 수 있습니다.