LookML 다이어그램 사용

LookML 다이어그램은 Looker 확장 프로그램 프레임워크를 사용하여 개발되고 Looker Marketplace를 통해 배포되는 확장 프로그램(Looker 구성 요소를 사용하여 빌드된 웹 애플리케이션)입니다.

LookML 다이어그램은 LookML 객체 간의 관계를 시각적으로 묘사하는 LookML 모델의 항목 관계 다이어그램입니다. 이 확장 프로그램으로 다음을 수행할 수 있습니다.

  • LookML 모델의 구조를 평가하여 LookML을 통합할 수 있는 영역을 파악하고 모델에 추가할 가장 최적의 방법을 결정합니다.
  • 잘못된 로직을 식별하여 잘못된 계산 및 쿼리 성능 저하 가능성을 줄입니다.
  • 코드 기반(LookML) 데이터 모델링 방법을 알아보세요.

이 문서 페이지에서는 LookML 다이어그램 버전 2.0.0 이상을 사용하는 방법을 설명합니다. Looker 관리자는 LookML 다이어그램 확장 프로그램 구성 문서 페이지를 참조하여 Looker 사용자를 위해 이 확장 프로그램을 사용 설정하는 방법에 대한 지침을 확인해야 합니다.

이 페이지에서는 다음 방법을 설명합니다.

LookML 다이어그램이 설치되면 왼쪽 탐색 패널에서 블록을 클릭한 다음 LookML 다이어그램 타일을 선택하여 LookML 다이어그램으로 이동할 수 있습니다.

LookML 다이어그램을 사용한 LookML 객체 관계 관찰

Looker 관리자는 lookml_diagram 모델뿐아니라 확장 프로그램에서 보려는 모든 모델에 대한 권한을 부여해야 합니다.

LookML 다이어그램 확장 프로그램을 구성하는 요소는 다음과 같습니다.

  1. 모델, Git 브랜치, Explore를 선택하는 다이어그램 설정 패널
  2. 보려는 필드를 세분화하는 뷰 옵션 패널
  3. 다이어그램 요소에 대한 추가 설명을 제공하는 다이어그램 도움말 섹션
  4. 선택한 Explore의 LookML 객체와 상호작용할 수 있는 다이어그램 캔버스
  5. 선택한 Explore의 필드 목록(별로 그룹화됨)
  6. 확대/축소 및 위치 옵션과 캔버스 미니 지도를 표시하거나 숨길 수 있는 아이콘이 있는 툴바(더 큰 다이어그램 내에서 방향을 설정할 수 있도록 지원)
  7. LookML 객체에 대한 정보를 보고 관련 LookML 또는 Explore로 이동하는(해당 하는 경우) 객체 프로파일러

다이어그램 설정 아이콘 또는 뷰 옵션 아이콘을 더블클릭하여 왼쪽 패널을 접습니다.

다이어그램 설정 구성

다이어그램 탐색 메뉴에서 다이어그램 아이콘을 클릭하면 다이어그램 설정이 표시됩니다.

모델 선택 드롭다운에는 보기 권한이 있는 모든 모델이 나열됩니다. 모델을 선택하면 다음 두 가지 옵션이 추가로 표시됩니다.

  • 현재 브랜치 드롭다운은 해당 모델의 Git 브랜치 목록으로 채워집니다. 모델에 브랜치가 하나만 있는 경우(일반적으로 프로덕션 브랜치) 이 브랜치가 표시됩니다. 프로덕션 모드이거나 Git 브랜치를 변경할 수 있는 권한이 없으면 현재 브랜치 드롭다운 메뉴가 사용 중지됩니다.

    관리자가 LookML 다이어그램에서 Git 브랜치를 변경할 수 있는 권한을 부여한 경우, 개발 모드를 사용 설정하고 모델과 Explore가 둘 다 선택되었는지 확인한 다음 브랜치를 선택하여 해당 브랜치에서 모델이 설정된 방법에 따라 다이어그램을 확인하세요.

  • Explore 선택 목록이 해당 모델의 Explore 목록으로 채워집니다. Explore 이름을 클릭하면 페이지 캔버스에 뷰를 기준으로 그룹화된 필드가 표시됩니다.

Explore 뷰 옵션

Explore을 선택한 상태에서 뷰 옵션 패널을 사용하여 캔버스에 표시되는 필드와 뷰를 제한할 수 있습니다.

표시되는 필드 제한

표시할 필드에서 모든 필드를 선택하여 Explore의 각각의 뷰에서 모든 필드를 표시하도록 선택할 수 있습니다. 또는 다른 필드에 조인된 필드가 있는 뷰만 표시하려면 조인이 있는 필드를 선택합니다.

사용 설정하면 숨겨진 필드 숨기기 전환 버튼이 기본 LookML에 hidden: yes가 포함된 모든 필드를 숨깁니다. 숨겨진 필드 숨기기 전환 버튼은 기본적으로 사용 설정되어 있습니다.

표시되는 뷰 제한

뷰 옵션 패널의 섹션은 선택한 Explore에 표시되는 뷰 목록을 보여줍니다. 기본적으로 모든 뷰가 다이어그램 캔버스에 표시됩니다. 뷰를 숨기면 뷰 객체 및 해당 뷰 객체를 Explore의 다른 객체에 연결하는 모든 조인이 다이어그램 캔버스에서 숨겨집니다.

다이어그램 캔버스에서 Explore에 있는 모든 뷰를 숨기려면 모두 숨기기를 클릭합니다. 모두 표시를 클릭하면 해당 Explore에서 모든 뷰 숨기기가 해제됩니다.

보기 이름 오른쪽에 있는 눈 아이콘을 선택 해제하여 캔버스에서 개별 보기를 선택적으로 숨길 수도 있습니다. 뷰가 숨겨진 경우 뷰 이름이 비활성화되고 눈 모양 아이콘에 슬래시가 생깁니다. 개별 숨겨진 뷰를 숨김 취소하려면 슬래시가 있는 눈 아이콘을 클릭합니다.

다이어그램 캔버스 해석하기

LookML 다이어그램 캔버스는 지정된 Explore의 모든 항목 및 관계를 보여줍니다. Looker 용어로 표현하자면, LookML 다이어그램은 LookML 객체가 주어진 모델에 대한 Explore에서 어떻게 조인되어 있는지를 묘사하는 것으로 생각할 수 있습니다.

캔버스 상단에 있는 객체 제목 표시줄에는 캔버스에 뷰가 표시되는 Explore의 이름이 표시됩니다. 객체 제목 표시줄에서 Explore 정보 아이콘(원형 "i")을 클릭하면 객체 프로파일러를 열고 선택한 Explore에 대해 자세히 알아볼 수 있습니다. 확장 프로그램을 새로고침하려면 시계 방향 화살표를 클릭합니다.

항목

Explore의 각 뷰는 고유한 항목 집합으로 표시되며, 뷰 이름은 집합의 맨 위에 나타납니다.

  1. Explore의 기본 뷰는 진한 파란색 배경으로 표시됩니다.
  2. Explore에서 조인된 뷰는 밝은 파란색 배경입니다.
  3. 조인, 뷰 또는 필드가 선택되면 밝은 파란색으로 강조표시됩니다.

    각 뷰 아래에는 해당 뷰에 속한 필드 목록이 있습니다.

  4. 측정기준은 상단에 표시됩니다.

  5. 측정항목은 하단에 나열되며 연한 주황색으로 강조 표시됩니다.

  6. 필드가 기본 키인 경우 필드 이름 오른쪽에 키 아이콘이 표시됩니다.

각 필드 왼쪽에는 유형을 나타내는 아이콘이 있습니다.

  • A: type: string의 측정기준
  • #: type: number의 측정기준 또는 측정값
  • 계층식 막대: type: tier의 측정기준
  • 체크표시: type: yesno의 측정기준
  • Calendar: type: date, type: date_time, type: time 크기
  • 지도 지점: type: location, type: distance, type: zipcode의 크기

필드 이름을 클릭하면 객체 프로파일러가 열리고 선택한 필드에 대해 자세히 알아볼 수 있습니다.

관계

다이어그램은 선택한 모델의 다른 객체와 각 객체가 어떻게 관련되어 있는지를 선을 사용하여 보여줍니다. 뷰나 필드에 연결되는 선의 모양은 두 객체 간의 관계 카디널리티를 전달합니다. 포크된 선은 '다수' 카디널리티를 나타내고, 하나의 선은 "단일" 카디널리티를 나타냅니다. 관례를 읽을 때는 기본 뷰에서 조인된 뷰 읽습니다. 예를 들면 다음과 같습니다.

  1. order_items에서 inventory_items으로의 일대일 조인, id 필드에 조인
  2. order_items에서 repeat_purchase_facts로의 다대일 조인

선 위로 마우스를 가져가면 두 객체를 연결하는 조인 유형 관계를 확인할 수도 있습니다.

선을 클릭하면 객체 프로파일러를 열어 조인에 대한 상세 내용을 볼 수 있습니다.

캔버스 뷰 옵션

캔버스의 오른쪽 상단에 있는 미니 지도는 더 큰 다이어그램 내에서 위치를 지정하는 데 도움이 되며, 이때 지도의 다이어그램에서 비활성화된 부분은 현재 캔버스에 표시된 부분을 나타냅니다. 캔버스의 빈 공간을 클릭하고 드래그하여 다이어그램의 다른 부분으로 이동하세요.

캔버스 왼쪽 하단에 있는 세로 툴바에는 다이어그램 표시를 제어하는 아이콘이 있습니다.

  • (+) 아이콘을 클릭하여 다이어그램을 확대하고 (-) 아이콘을 클릭하여 축소합니다.
  • 정사각형 아이콘을 클릭하면 다이어그램이 기본 시작 위치로 돌아갑니다.
  • 미니 지도를 사용 설정하거나 중지하려면 지도 아이콘을 클릭하세요.

객체 프로파일러로 객체 정보 보기

객체 프로파일러에는 선택한 객체에 대한 정보가 표시됩니다. 다이어그램 캔버스에서 Explore, 뷰, 필드, 조인을 클릭하여 캔버스 오른쪽에서 객체 프로파일러를 여세요. 캔버스를 클릭하면 객체 프로파일러가 접힙니다.

Explore

객체 제목 표시줄 오른쪽에 있는 Explore 정보 아이콘(원형 "i"')을 클릭합니다.

다이어그램 설정 패널에서 선택한 Explore의 경우 객체 프로파일러에 다음이 표시됩니다.

  • 라벨: label Explore의 값
  • 그룹 라벨: Looker의 Explore 메뉴에서 커스텀 그룹을 Explore에 결합하는 group_label 매개변수의 값. Explore에 그룹 라벨이 정의되지 않은 경우 기본값은 모델 이름입니다.
  • 프로젝트 이름: 프로젝트 설정에 정의된 LookML 프로젝트의 이름
  • 연결 이름: 모델이 데이터를 가져올 데이터베이스 연결을 지정하는 connection 매개변수의 값

LookML을 볼 수 있는 권한이 있으면 객체 프로파일러의 왼쪽 하단에서 LookML로 이동을 클릭하여 Explore가 정의된 파일을 열 수 있습니다. explore의 줄이 강조표시된 새 브라우저 탭에서 파일이 열립니다.

다이어그램 캔버스에서 뷰를 클릭합니다.

뷰의 LookML에 정의된 경우 객체 프로파일러에 SQL 테이블 이름이 표시됩니다. 뷰에 sql_table_name이 정의되어 있지 않으면 SQL 테이블 이름unknown으로 표시됩니다.

LookML을 볼 수 있는 권한이 있다면 객체 프로파일러 왼쪽 하단의 LookML로 이동을 클릭하여 뷰가 조인된 Explore가 정의된 파일을 열 수 있습니다. explore의 줄이 강조표시된 새 브라우저 탭에서 파일이 열립니다.

필드

다이어그램 캔버스에서 필드를 클릭합니다.

객체 프로파일러는 필드 이름, 유형, 유형 값, 필드가 기본 키인지 여부를 패널 상단에 표시합니다. 프로파일러의 두 탭인 세부정보코드 탭에는 필드 관련 추가 정보가 표시됩니다.

세부정보 탭에서 다음을 확인할 수 있습니다.

  • 뷰 이름: 필드가 속한 뷰의 이름
  • 라벨: Explore의 데이터 섹션에서 필드가 표시되는 방식, 즉, 뷰의 이름 또는 라벨 다음에 필드의 이름 또는 레벨이 지정됩니다.
  • 분포: type: count의 측정값이 있는 뷰의 숫자 측정기준의 경우 계산을 클릭하여 개수 값의 분포를 보여주는 열 차트의 미리보기 표시. 분포 섹션에는 숫자 측정기준 계열의 최솟값, 최댓값, 평균 값도 표시됩니다.
  • : 측정값이 type: count인 뷰의 숫자 측정기준의 경우 계산을 클릭하면 개수 값 미리보기가 표시됩니다. 이 필드가 속한 Explore를 열려면 더보기를 클릭하세요.

코드 탭에서 필드 매개변수 및 하위 매개변수를 볼 수 있습니다.

LookML을 볼 수 있는 권한이 있으면 객체 프로파일러의 왼쪽 하단에서 LookML로 이동을 클릭하여 조인이 정의된 파일을 열 수 있습니다. 새 브라우저 탭에서 조인의 Explore 줄에 대한 파일이 열립니다.

데이터 탐색 권한이 있는 경우 객체 프로파일러의 오른쪽 하단에 있는 필드로 탐색을 클릭하여 Explore 필드 선택 도구에서 미리 선택된 필드로 Explore를 엽니다.

조인

다이어그램 캔버스에서 조인을 클릭합니다.

객체 프로파일러에는 조인 관계와 조인의 유형카디널리티를 설명하는 조인 문이 표시됩니다.

LookML을 볼 수 있는 권한이 있으면 객체 프로파일러의 왼쪽 하단에서 LookML로 이동을 클릭하여 조인이 정의된 파일을 열 수 있습니다. 새 브라우저 탭에서 조인의 Explore 줄에 대한 파일이 열립니다.