LookML 모델 생성

이 문서 페이지에서는 모델 만들기 페이지를 사용하여 데이터베이스 연결에서 기본 LookML 모델을 자동으로 생성하는 단계를 설명합니다. 모델 만들기 페이지를 사용하여 모델을 보관할 프로젝트를 만들 수도 있습니다.

모델 파일을 만드는 다른 옵션도 있습니다.

• IDE에서 모델 파일과 기타 프로젝트 파일을 수동으로 만들 수 있습니다.

• 다음 중 하나를 클릭하여 기존 새 프로젝트 페이지로 이동하면 기존 방법을 사용하여 프로젝트를 만들고 모델을 생성할 수 있습니다.

  • 모델 만들기 페이지 상단의 배너에 있는 링크
  • 프로젝트 페이지의 대기 중인 프로젝트 섹션에 있는 LookML 추가 버튼

  새 프로젝트 페이지로 이동한 후 새 LookML 프로젝트 만들기 문서의 단계를 따르세요.

모델 만들기 페이지 액세스

다음 방법으로 모델 만들기 페이지에 액세스합니다.

• 개발 섹션에서
• 만들기 버튼

모델 만들기 페이지에 액세스하려면 개발 모드에 있어야 합니다.

모델 만들기 페이지에 액세스하려면 Looker 관리자이거나 develop 권한이 있어야 합니다.

개발 섹션에서

Develop 섹션에서 Create a Model 페이지에 액세스하려면 다음 단계를 완료하세요.

1. 왼쪽 탐색 패널에서 개발을 클릭합니다.

2. 탐색 패널의 개발 섹션에서 프로젝트를 선택합니다.

   

3. 이 옵션을 선택하면 LookML 프로젝트 페이지가 열립니다. LookML 프로젝트 페이지에서는 액세스 권한이 있는 모든 프로젝트와 해당 모델을 볼 수 있습니다. LookML 프로젝트 페이지에서 새 모델 버튼을 선택하여 모델 만들기 페이지를 엽니다.

만들기 버튼에서

만들기 버튼에서 모델 만들기 페이지에 액세스하려면 다음 단계를 완료하세요.

1. 기본 탐색 메뉴에서 만들기 버튼을 클릭합니다.
2. 드롭다운 메뉴에서 LookML 모델을 선택합니다. 그러면 모델 만들기 페이지가 열립니다.

모델 생성

모델 만들기 페이지는 섹션으로 나뉩니다. 모델을 생성하려면 다음 섹션의 단계를 완료합니다. 각 섹션을 완료할 때마다 다음을 클릭하여 입력한 내용을 저장하고 다음 섹션으로 이동합니다.

1. 데이터베이스 연결 선택:

   • 데이터베이스 연결 선택: 드롭다운 메뉴에서 데이터베이스 연결을 선택합니다. 드롭다운 메뉴에서 새 연결 만들기 옵션을 선택할 수도 있습니다. 그러면 새 연결을 만들 수 있는 데이터베이스를 Looker에 연결 페이지로 이동합니다.

   • 이미 연결을 사용하는 프로젝트에 대한 액세스 권한이 있는 경우 연결이 선택되면 해당 프로젝트가 표시됩니다. 사용 가능한 기존 프로젝트에 새 모델을 추가하거나 모델에 새 LookML 프로젝트를 만들 수 있습니다.

   • LookML 프로젝트 이름: 모델에 새 LookML 프로젝트를 만들려면 이 입력란에 프로젝트 이름을 입력합니다. 프로젝트 이름은 대소문자를 구분하며 영숫자 문자, _, ., -만 허용됩니다. 프로젝트 이름을 신중하게 선택하고 프로젝트의 영구 ID로 간주합니다. 새 프로젝트는 베어메탈 Git 저장소를 사용하여 구성됩니다.

   • Looker에서 새 프로젝트에 README 파일을 추가하도록 하려면 LookML 사용에 대한 자세한 정보를 제공하는 리드미 파일 생성 체크박스를 선택합니다. README 파일에는 LookML 소개 및 새 LookML 개발자를 지원하는 링크와 리소스가 포함되어 있습니다.

   • 다음 버튼을 클릭하여 항목을 저장하고 다음 섹션으로 이동합니다.

2. Tables를 선택합니다.

   • BigQuery 연결을 사용하는 경우 GCP 프로젝트 선택 드롭다운 메뉴에서 데이터 세트가 있는 Google Cloud 프로젝트를 선택하거나 프로젝트 이름 검색 필드에서 프로젝트를 검색합니다. 기본적으로 Google Cloud 저장소 프로젝트가 있는 경우 드롭다운 메뉴에 표시되고, 없는 경우 Google Cloud 결제 프로젝트가 표시됩니다.
   • 표에서 모델에 사용할 데이터 세트 (BigQuery) 또는 스키마 (기타 방언)를 선택합니다.
   • 데이터 세트 또는 스키마를 선택한 후 각 데이터 세트 또는 스키마 이름 오른쪽에 있는 화살표를 사용하여 테이블 탭을 열고 포함할 각 테이블을 선택합니다. 뷰가 테이블에서 생성됩니다.
   • 테이블을 선택한 후 각 테이블 이름 오른쪽에 있는 화살표를 사용하여 필드 탭을 열고 포함할 각 필드를 선택합니다.
   • 프리픽스 무시: 생성된 뷰 파일 이름의 테이블 프리픽스를 무시하려면 이 필드에 쉼표로 구분된 목록으로 데이터베이스의 프리픽스를 입력합니다. 이 필드는 대소문자를 구분합니다. 여러 프리픽스를 쉼표로 구분하여 나열할 수 있습니다. 예를 들어 테이블 제목이 dwh_orders 및 DBS_users입니다. 프리픽스 무시 필드에 dwh, DBS를 입력하면 Looker가 orders 및 users라는 뷰 파일을 만듭니다.
   • 필드 설명 가져오기: 데이터베이스에서 사용 가능한 필드 설명을 생성된 측정기준에 대한 LookML 설명으로 사용하려면 이 체크박스를 선택합니다.
   • 다음 버튼을 클릭하여 항목을 저장하고 다음 섹션으로 이동합니다.

3. 기본 키 선택:

   • 선택한 각 테이블의 기본 키를 선택합니다. 이렇게 하면 Looker에서 테이블을 더 효율적으로 조인할 수 있습니다.
   • 이 단계는 선택사항입니다. 건너뛰려면 기본 키를 선택하지 마세요.
   • 다음 버튼을 클릭하여 항목을 저장하고 다음 섹션으로 이동합니다.

4. 만들 Explore 선택:

   • Explore의 기본 뷰로 사용할 각 뷰를 선택합니다. 선택한 각 뷰마다 시스템이 다른 뷰와 최대한 많이 자동으로 조인합니다. 이전 단계에서 식별된 기본 키가 있는 뷰만 조인에 사용할 수 있습니다.
   • 이 단계는 선택사항입니다. 건너뛰려면 보기를 선택하지 마세요.
   • 다음 버튼을 클릭하여 항목을 저장하고 다음 섹션으로 이동합니다.

5. 모델 이름 입력:

   • 모델 이름 필드에 파일에 사용할 이름을 입력합니다. 중복된 모델 이름은 사용할 수 없습니다. 모델 이름은 대소문자를 구분하며 공백이나 특정 특수문자를 사용할 수 없습니다.

6. 다음 버튼 중 하나를 클릭하여 모델 파일과 선택한 경우 새 프로젝트를 생성합니다.

   • 모델 완료 및 보기: Looker에서 Looker IDE의 파일로 이동합니다.
   • 데이터 완성 및 탐색: Looker에서 만들려는 Explore 선택 섹션에서 첫 번째로 선택한 뷰 파일에 해당하는 Explore로 이동합니다.

7. 새 프로젝트를 만들었으며 Looker에서 프로젝트 생성에 사용한 기본 Git 저장소가 아닌 다른 저장소에 연결하려면 프로젝트의 프로젝트 설정 페이지에 있는 구성 탭의 Git 연결 재설정 버튼을 클릭하여 프로세스를 완료합니다.

모델을 구성해야 하는 경우

모델 구성의 유용성은 다음과 같습니다.

• 모델 이름이 특정 프로젝트의 특정 모델을 참조하도록 지정합니다.
• 모델에서 사용할 수 있는 연결을 설정합니다.

관리자(또는 manage_models 또는 manage_project_models 권한이 있는 개발자)는 개발 모드일 때는 모델 구성이 필요하지 않습니다. 이를 통해 LookML 개발자가 개발 모드에서 작업할 수 있습니다. 하지만 모델 구성이 있으면 쿼리가 개발 모드에서도 해당 구성에 의해 제한됩니다.

LookML 개발자는 모델 파일에서 의도한 연결을 지정하지만 관리자는 LookML 프로젝트 페이지에서 허용되는 연결을 제어합니다. 모델이 모델 구성에서 허용되지 않는 연결을 사용하여 지정하는 경우 해당 연결은 허용되지 않습니다.

다음과 같은 시나리오에서 모델에는 구성이 있어야 합니다.

• 모델을 처음으로 프로덕션에 푸시할 때. 모델이 구성되지 않은 경우 모델이 프로덕션 모드에 있으면 해당 모델에 대한 모든 쿼리가 실패합니다. 모델을 처음으로 개발 모드에서 프로덕션으로 푸시할 때 모델 이름이 Looker 인스턴스에서 고유한 경우 Looker가 모델을 자동으로 구성합니다. 그러나 다른 프로젝트에 동일한 이름으로 구성된 모델이 있는 경우 Looker가 모델을 자동으로 구성하지 않습니다.
• 개발 중. manage_models 권한(admin 역할에 포함) 또는 manage_project_models 권한이 부여되지 않은 개발자의 경우 개발자가 해당 모델에 쿼리를 실행하려면 먼저 모델을 구성해야 합니다. 모델이 존재하거나 프로젝트가 존재하기 전에 모델을 구성할 수 있습니다. 그러면 LookML 개발자가 모델을 만들 때 모델의 허용된 연결이 이미 구성되어 있으며, 개발자가 쿼리를 성공적으로 실행할 수 있습니다.

Looker를 사용하면 manage_models 또는 manage_project_models 권한을 가진 개발자가 개발 모드에서 구성되지 않은 모델로 쿼리를 실행할 수 있습니다. Looker가 프로젝트에서 해당 이름의 모델을 검색하여 이렇게 합니다. 이 이름으로 발견된 첫 번째 모델이 쿼리를 실행하는 데 사용됩니다.

계획된 모델 구성

Looker 관리자는 LookML 프로젝트 페이지 상단의 새 모델 구성 버튼을 사용하여 기존 모델 또는 아직 존재하지 않는 계획된 모델의 구성을 추가할 수 있습니다.

모델을 미리 구성하는 것은 개발자에게 manage_models 권한 또는 manage_project_models 권한이 부여되지 않은 경우에 유용합니다. 관리자가 개발자를 위해 모델을 구성하면 개발자는 모델 파일을 생성하거나 만들자마자 쿼리를 실행할 수 있습니다.

관리자는 모델에서 사용할 수 있는 데이터베이스 연결을 지정하거나 모델에서 현재 또는 향후 연결을 사용할 수 있도록 지정할 수도 있습니다. Looker 개발자는 LookML connection 파라미터를 사용하여 모델에서 사용해야 하는 연결을 모델 파일에 지정합니다. 개발자가 모델 구성에서 관리자가 허용하지 않은 연결을 지정하면 해당 모델의 쿼리가 실행되지 않습니다.

관리자가 새 모델을 미리 구성하고 해당 구성의 일부로 새 프로젝트를 만들면 해당 프로젝트가 프로젝트 페이지의 대기 중인 프로젝트 섹션에 표시됩니다.

빈 프로젝트 생성

빈 프로젝트를 만들면 LookML 파일을 처음부터 만들 때 유용합니다.

모델 만들기 페이지에서는 LookML 파일이 포함된 프로젝트를 생성합니다. 하지만 모델 만들기 페이지에서 다음 섹션만 작성하면 생성되는 LookML 파일을 최소화할 수 있습니다.

• 데이터베이스 연결 선택
• 테이블 선택
• 모델 이름 입력

나머지 섹션은 작성하지 않습니다.

Complete and View Model(완료 및 모델 보기) 버튼을 클릭하면 Looker IDE의 프로젝트로 이동합니다. IDE에서 원하지 않는 LookML 파일을 삭제하여 빈 프로젝트를 만들 수 있습니다.

다음 단계

모델 또는 프로젝트가 생성된 후 다음 작업을 수행할 수 있습니다.

• 프로젝트에 새 모델을 수동으로 추가로 만듭니다.
• Looker IDE를 사용하여 기존 LookML 파일 수정
• 프로젝트 이름 변경
• Looker 프로젝트를 Git에 연결