다른 프로젝트 파일 이해하기

Looker 프로젝트는 하나 이상의 모델 파일, 하나 이상의 뷰 파일 및 다음 유형의 파일로 구성됩니다.

모델 및 뷰 파일에 대한 자세한 설명은 모델 및 뷰 파일 이해 문서 페이지를 참조하세요. 나머지 파일 형식은 아래 섹션에 설명되어 있습니다.

프로젝트 파일에 액세스하는 방법에 대한 자세한 내용은 프로젝트 정보 액세스 및 수정 문서 페이지를 참조하세요.

프로젝트 파일은 Looker 개발자가 IDE의 폴더를 사용하여 정리합니다.

대시보드 파일

Looker는 두 가지 유형의 대시보드를 지원합니다.

  • 사용자 정의 대시보드: 개발자가 아닌 사용자가 LookML을 사용하지 않고 만들 수 있습니다. 자세한 내용은 사용자 정의 대시보드 만들기 문서 페이지를 참조하세요.
  • LookML 대시보드: 프로젝트와 관련된 버전 제어 파일로 저장됩니다.

프로젝트에 LookML 대시보드가 있으면 IDE의 전용 대시보드 파일에 정의됩니다.

LookML 대시보드에 대한 자세한 내용은 LookML 대시보드 만들기 문서 페이지를 참조하세요.

문서 파일

Looker 문서 파일에서는 GitHub 버전 마크다운을 사용하여 Looker 데이터 모델에 관한 문서나 기타 메모를 작성할 수 있습니다. 이 기능은 사용자가 조직에서 Looker를 사용하는 방법을 익히는 데 도움이 됩니다.

문서 파일 만들기

프로젝트에 문서 파일을 추가하려면 다음 안내를 따르세요.

파일을 만든 후 오른쪽 상단의 수정을 클릭하여 수정할 수 있습니다. 그런 다음 미리보기를 클릭하여 변경사항을 미리 보거나 저장을 클릭하여 변경사항을 저장할 수 있습니다.

IDE 외부에서 문서 보기

IDE 외부에서 문서를 보려면 아래에 설명된 탐색 기능을 활용해야 합니다. IDE의 왼쪽 상단에 있는 드롭다운 메뉴에서 문서 보기 옵션을 선택하세요.

결과 페이지의 URL을 다른 사용자에게 배포할 수 있으므로 다른 사용자가 Looker의 개발자 섹션을 통해 이동하지 않고도 도달할 수 있습니다.

문서에 탐색 구조 추가하기

사용자가 손쉽게 파일 구조를 확인하고 문서 간에 이동할 수 있도록 사이드바를 문서 파일에 추가할 수 있습니다.

문서의 사이드바 탐색을 추가하려면 문서의 첫 번째 줄부터 탐색 섹션을 만듭니다. 탐색 섹션의 시작과 끝을 대시 3개 (---)로 표시합니다.

탐색 섹션에서 다음 매개변수를 사용할 수 있습니다.

문서에 navigation: true를 사용하여 해당 문서에 탐색 사이드바를 추가할 수 있습니다. 마크다운 파일에서는 다음과 같이 표시됩니다.

이렇게 하면 모든 프로젝트의 문서 페이지 링크가 포함된 탐색 사이드바가 문서에 추가됩니다. 문서에 navigation: true만 포함하면 문서의 사이드바에 모든 파일 문서가 알파벳순으로 표시됩니다.

알파벳순으로 파일을 구성하는 것이 바람직하지 않거나 페이지 탐색에 표시하고 싶지 않은 문서가 있을 수도 있습니다.

문서의 탐색 사이드바에 있는 파일의 순서를 변경하거나 사이드바에 문서의 하위 집합만 표시하려면 다음 형식을 사용합니다.

---
navigation:
  - document_one
  - document_two
  - document_three
  - document_four
---

이제 페이지에 필요한 파일만 적절한 순서로 표시됩니다.

title

기본적으로 사이드바는 문서의 제목 (문서가 제목으로 시작하는 경우) 또는 문서의 파일 이름이 파일에 없는 경우 표시됩니다. 문서 상단에 title 매개변수를 추가하여 탐색 사이드바에 문서가 표시되는 방식을 변경할 수 있습니다.

---
title: New Title for Users
---

문서의 탐색 섹션에서 다른 label를 지정하지 않는 한 이 제목은 모든 문서의 탐색 사이드바에 링크 텍스트로 사용됩니다.

label

문서의 탐색 사이드바에 페이지가 표시되는 방식을 변경하려면 다음과 같이 document 및 label 매개변수를 사용하면 됩니다.

---
navigation:
  - document_one
  - document: document_two
    label: Customized Label for Document Two
  - document_three
  - document_four
---

label 매개변수를 사용하려면 앞의 예와 같이 문서 파일 이름 앞에 document:를 추가해야 합니다. 문서에 label를 사용하지 않는 경우 파일 이름 앞에 document:를 포함하지 마세요.

label 값은 참조하는 문서에 자체 title 매개변수가 있더라도 문서의 사이드바 탐색에 문서가 표시되는 방식을 정의합니다.

앞의 예는 문서 사이드바에서 다음과 같습니다.

section

탐색 사이드바를 섹션으로 나누려면 다음과 같이 section 매개변수를 사용하면 됩니다.

---
navigation:
  - document_one
  - document_two
  - section: My Section Name
  - document_three
  - document_four
---

section 매개변수는 사이드바에 섹션 나누기와 텍스트 제목을 추가합니다.

텍스트 제목은 링크 자체가 아니며 문서 파일을 참조하지 않습니다.

데이터 파일

데이터 파일은 파일 확장자가 .json, .topojson 또는 .geojson인 JSON 파일입니다.

map_layer 매개변수를 사용하면 JSON 파일을 맞춤 맵으로 사용하여 Looker에서 데이터를 표시할 수 있습니다.

그런 다음 데이터 맵 (예: '파리')을 맞춤 지도의 지역과 연결할 수 있도록 측정기준과 함께 map_layer_name 매개변수를 사용합니다.

LookML IDE에서 JSON 파일을 수정한 후 저장을 클릭합니다. 디버깅의 경우 View Raw를 선택하여 원시 형식으로 파일을 볼 수 있습니다. 브라우저에서 JSON을 볼 수 있는 적절한 확장 프로그램이 있다면 파일을 파싱 형식으로 볼 수도 있습니다.

데이터 파일 추가

프로젝트에 JSON 파일을 추가하려면 드래그 앤 드롭 기능을 사용하여 컴퓨터에서 파일을 업로드하세요. 이 절차는 IDE에서 폴더 사용하기 문서 페이지의 파일 업로드 섹션을 참조하세요.

프로젝트 매니페스트 파일

프로젝트에는 다음 작업에 사용되는 프로젝트 매니페스트 파일이 포함될 수 있습니다.

모델 현지화는 현재 프로젝트 가져오기와 호환되지 않습니다.

각 프로젝트에는 매니페스트 파일이 하나만 있을 수 있으며, manifest.lkml라는 이름을 지정해야 하며 프로젝트의 디렉터리 구조와 루트 저장소의 루트 수준에 있어야 합니다.

매니페스트 파일 만들기

프로젝트에 프로젝트 매니페스트 파일을 추가하려면 Looker IDE 파일 브라우저 상단의 + 메뉴에서 Create Project Manifest 옵션을 사용합니다 (IDE에서 폴더 사용하기 문서 페이지에 있는 파일 만들기 섹션 참고). 그러면 프로젝트 디렉터리 구조의 루트 수준에 manifest.lkml 파일이 생성됩니다. 매니페스트 파일은 이동하지 말고 디렉터리 구조의 루트 수준에 저장해야 합니다.

프로젝트 매니페스트 만들기 옵션은 Looker IDE의 파일 브라우저 상단에 있는 + 아이콘에서만 사용할 수 있습니다. 매니페스트 파일은 프로젝트 디렉터리 구조의 루트 수준에 있어야 하므로 폴더 메뉴에서 선택할 수 없습니다.

또한 프로젝트에 매니페스트 파일이 없는 경우에만 프로젝트 매니페스트 만들기 옵션을 사용할 수 있습니다. 프로젝트에는 매니페스트 파일이 하나만 있을 수 있기 때문입니다.

매니페스트 잠금 파일

매니페스트 잠금 파일은 프로젝트 매니페스트 파일에 원격 종속 항목이 추가되면 자동으로 생성됩니다. Looker는 매니페스트 잠금 파일을 사용하여 매니페스트 파일에 지정된 원격 프로젝트의 버전을 추적합니다.

잠금 파일은 Looker에서 자동으로 관리되므로 Looker 개발자는 매니페스트 잠금 파일을 만들거나 수정할 필요가 없습니다.

자세한 내용은 다른 프로젝트에서 파일 가져오기 문서 페이지를 참고하세요.

언어 문자열 파일

데이터 모델을 현지화하는 경우 기본 언어 (예: 미국에서는 영어)를 비롯하여 현지화할 언어별로 언어 문자열 파일을 만들어야 합니다.

언어 문자열 파일에는 모델에서 현지화하는 각 라벨 및 설명의 키-값 쌍이 나열됩니다. 각 언어의 문자열 파일은 각 라벨 또는 설명에 언어의 번역을 제공해야 합니다. 언어 문자열 파일 생성에 관한 자세한 내용은 LookML 모델 현지화 문서 페이지를 참고하세요.

언어 문자열 파일 만들기

모델을 현지화하기 위해 언어 문자열 파일을 만들고 Looker의 기본 UI 현지화를 활용하려면 사용자 문서 페이지의 언어 섹션에서 확인할 수 있는 구체적인 언어 코드를 사용하여 문자열 파일의 이름을 지정해야 합니다.

프로젝트에 언어 문자열 파일을 만드는 방법은 다음과 같습니다.

파일 살펴보기

탐색은 일반적으로 모델 파일 내에서 정의됩니다. 그러나 파생된 테이블을 위해 또는 모델 간에 탐색을 확장하거나 조정하려면 별도의 탐색 파일이 필요합니다.

탐색 파일의 파일 확장자는 .explore.lkml입니다.

탐색 파일 만들기

프로젝트에서 탐색 파일을 만들려면 다음 안내를 따르세요.

탐색 파일을 만드는 경우:

  • 파일 확장자 .explore.lkml을(를) 사용해야 합니다.
  • 프로젝트에서 파일을 만든 후에는 include 매개변수를 사용하여 새 파일을 프로젝트의 다른 파일에서 참조할 수 있도록 해야 합니다. 탐색 파일은 보기, 모델, 다른 탐색 파일에 포함될 수 있습니다.
  • 탐색 파일을 만든 후에는 Looker IDE에서 객체 브라우저를 사용하여 객체를 확인하고 탐색 파일로 이동할 수 있습니다.

데이터 테스트 파일

LookML 모델의 로직을 확인하는 데 사용되는 데이터 테스트 파일이 프로젝트에 있을 수 있습니다. 데이터 테스트는 모델 파일 또는 뷰 파일에 포함될 수 있지만, 개발자가 여러 다양한 모델에서 동일한 데이터 테스트를 사용하려는 경우 데이터 테스트를 별도의 전용 파일에 유지하는 것이 도움이 될 수 있습니다.

데이터 테스트 파일 만들기

프로젝트에서 데이터 테스트 파일을 만드는 방법은 다음과 같습니다.

데이터 테스트 파일을 만드는 경우:

  • 데이터 테스트 파일의 파일 확장자는 .lkml입니다.
  • 프로젝트에서 파일을 만든 후에는 include 매개변수를 사용하여 새 파일을 프로젝트의 다른 파일에서 참조할 수 있도록 해야 합니다. 탐색 파일은 보기, 모델, 다른 탐색 파일에 포함될 수 있습니다.

상세검색 파일

프로젝트에 LookML 상세검색에 사용되는 파일이 있을 수 있습니다. LookML 상세검색은 모델, 보기, 탐색 파일 또는 자체 전용 파일에 포함될 수 있습니다.

상세검색 파일 만들기

프로젝트에서 상세검색 파일을 만들려면 다음 안내를 따르세요.

상세검색 파일을 만드는 경우:

  • 상세검색 파일에는 파일 확장자가 .lkml입니다.
  • 프로젝트에서 상세검색을 생성한 후 include 매개변수를 사용하여 새 파일을 프로젝트의 다른 파일에서 참조할 수 있도록 합니다.

기타 파일

많은 LookML 요소가 프로젝트의 다양한 파일 또는 자체 전용 파일에 보관될 수 있습니다. 예를 들어 데이터 테스트는 모델 파일, 뷰 파일 또는 자체 전용 .lkml 파일에 포함될 수 있습니다.

일반 LookML 파일 만들기

프로젝트에 일반 LookML 파일을 만들려면 다음 안내를 따르세요.

파일을 만든 후에는 include 매개변수를 사용하여 새 파일을 프로젝트의 다른 파일에서 참조할 수 있도록 해야 합니다.