모델 생성

이 페이지에서는 새 프로젝트를 만들고 데이터베이스에서 기본 모델을 자동으로 생성하는 단계를 제공합니다.

프로젝트 파일을 만드는 다른 옵션이 있습니다. 빈 프로젝트를 만들고 모델을 수동으로 만들거나 기존 공개 Git 저장소를 클론할 수 있습니다. 새 LookML 프로젝트 만들기 문서 페이지를 참고하십시오.

데이터베이스에서 모델 자동 생성

Looker의 개발 섹션 내에서 또는 왼쪽 탐색 패널의 만들기 버튼을 사용하여 데이터베이스에서 모델을 자동으로 생성할 수 있습니다.

개발 섹션에서 모델 생성

  1. 왼쪽 탐색 패널에서 개발을 클릭하고 개발 모드에 있는지 확인합니다.

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

  3. LookML 프로젝트 페이지에서 새 LookML 프로젝트를 선택합니다.

    • LookML 프로젝트 페이지에서는 모든 프로젝트와 해당 모델을 볼 수 있습니다. 이 페이지를 사용하여 프로젝트를 만들고 보고 구성합니다.

  4. 새 프로젝트 대화상자에서 프로젝트 옵션을 지정합니다.

    • 프로젝트 이름: 프로젝트 이름을 지정합니다. Looker는 다음과 같은 방법으로 프로젝트 이름을 사용하므로 프로젝트 이름을 신중하게 선택하고 프로젝트의 영구 ID로 간주합니다.

      • project_id 매개변수가 있는 API 호출의 프로젝트를 식별합니다.
      • Looker 인스턴스의 내부 데이터베이스에서 프로젝트를 식별합니다.
      • 로컬 프로젝트 가져오기를 위한 프로젝트를 식별합니다.
      • LookML 프로젝트 페이지에서 프로젝트를 표시합니다.
      • Looker 탐색 패널의 개발 섹션에 프로젝트를 표시합니다.
      • 프로젝트 파일 URL의 일부로 사용됩니다. 예를 들어 URL이 example.looker.com인 Looker 인스턴스에서 ecommerce라는 프로젝트의 프로젝트 매니페스트 파일은 https://example.looker.com/projects/ecommerce/files/manifest.lkml URL에서 찾을 수 있습니다.

    • 시작 지점: 데이터베이스 스키마에서 모델 생성을 선택합니다.

    • 연결: 드롭다운 메뉴에서 데이터베이스 연결 이름을 선택합니다.

    • 빌드 보기 선택: 다음 옵션 중 하나를 선택합니다.

      • 모든 테이블: LookML 생성기가 데이터베이스의 각 테이블에 대한 뷰 파일을 만듭니다.
      • 단일 테이블: LookML 생성기가 데이터베이스의 한 테이블에 대한 뷰를 만듭니다. 이 옵션을 선택하는 경우 데이터베이스 테이블의 이름을 입력합니다.

    • 스키마: 데이터베이스에 하나의 스키마에 대해서만 파일을 생성하려면 스키마 텍스트 필드에 스키마 이름을 입력합니다. 여러 스키마를 쉼표로 구분하여 나열할 수 있습니다.

    • 프리픽스 무시: 뷰 파일 이름에서 테이블 프리픽스를 그대로 두려면 프리픽스 무시 필드에 데이터베이스의 프리픽스를 입력합니다. 이 필드는 대소문자를 구분합니다. 여러 프리픽스를 쉼표로 구분하여 나열할 수 있습니다. 예를 들어 테이블 제목이 dwh_orders 및 DBS_users입니다. 프리픽스 무시 텍스트 필드에 dwh, DBS를 입력하면 Looker가 orders 및 users라는 뷰 파일을 만듭니다.

  5. 프로젝트 만들기를 클릭합니다.

    • LookML 생성기는 프로젝트에 대해 하나의 모델 파일을 만들고, 달리 지정되지 않는 한 데이터베이스의 각 테이블에 대해 뷰 파일을 만듭니다. 그런 후 Looker IDE에서 새 프로젝트가 열립니다.
    • LookML 생성기는 뷰 및 모델 파일의 IDE 폴더를 만듭니다. 데이터베이스에 스키마가 2개 이상 있으면 LookML 생성기가 스키마용 폴더를 만듭니다.

BigQuery 연결의 경우 데이터베이스에서 LookML 프로젝트를 생성하면 Looker는 BigQuery 열 메타데이터의 설명(있는 경우)으로 필드 설명을 자동으로 채웁니다.

생성기는 각 데이터베이스 테이블의 Explore도 만듭니다. 데이터 쿼리를 시작하려면 Explore 패널을 사용하여 탐색의 이름을 선택합니다.

프로젝트를 만든 후 이름을 바꾸려면 프로젝트 정보 액세스 및 수정 문서 페이지의 프로젝트 이름 변경 섹션을 참조합니다.

모델 및 뷰 파일 이해 문서 페이지에 설명된 대로 프로젝트의 추가 새 모델을 수동으로 만들고 이 페이지의 모델을 구성해야 하는 경우 섹션에 설명된 대로 프로덕션에 사용하도록 구성할 수 있습니다. 자세한 내용은 새 LookML 프로젝트 만들기 문서 페이지에서 확인할 수 있습니다.

모델 파일을 생성하거나 수동으로 만든 후 Looker 프로젝트를 Git에 연결하는 방법에 대한 자세한 내용은 Git 연결 설정 및 테스트 문서 페이지를 참조합니다. LookML 파일의 변경사항을 기록하고 파일 버전을 관리할 수 있습니다.

만들기 버튼을 사용하여 모델 생성

만들기 버튼을 사용하여 프로젝트를 만들고 모델을 생성하려면 다음 단계를 따르세요.

  1. 왼쪽 탐색 패널에서 만들기 버튼을 클릭합니다.
  2. LookML 모델 메뉴 옵션을 선택합니다.
  3. 개발 모드에 있는지 확인합니다.
  4. 개발 모드에서는 프로젝트 만들기 페이지가 열립니다.
  5. Explore의 기본 뷰를 선택하거나 생성된 뷰 파일 이름의 테이블 프리픽스 무시, 데이터베이스에서 필드 설명 메타데이터 가져오기, 모델 파일 만들기 결정, 자동 생성된 리드미 파일 선택과 같은 다른 고급 옵션을 맞춤설정하려는 경우 고급 프로젝트 생성 옵션을 사용 설정합니다.
  6. 데이터베이스 연결 선택 드롭다운 메뉴에서 데이터베이스 연결을 선택합니다. 이미 연결을 사용하는 프로젝트에 대한 액세스 권한이 있는 경우 연결이 선택되면 해당 프로젝트가 표시됩니다. 사용 가능한 프로젝트를 사용하고 여기에 새 모델을 추가하거나 새 LookML 프로젝트를 만들 수 있습니다. 프로젝트에 모델을 추가하면 프로젝트 만들기 페이지의 첫 번째 단계로 모델 만들기 섹션이 표시되며, 여기서 모델 이름을 지정할 수 있습니다. 선택한 후 다음을 클릭합니다.
  7. 데이터 선택 섹션에서 모델에 사용할 스키마, 테이블, 필드를 선택합니다. 뷰가 테이블에서 생성됩니다. 선택한 후 다음을 클릭합니다.
  8. 각 테이블의 기본 키를 선택합니다. 이렇게 하면 Looker에서 테이블을 더 효율적으로 조인할 수 있습니다. 선택한 후 다음을 클릭합니다.
  9. 고급 프로젝트 생성 옵션을 사용 설정한 경우 Explore의 기본 뷰를 선택합니다. Explore의 기본 뷰로 사용할 각 뷰를 선택합니다. 선택한 각 뷰마다 시스템이 다른 뷰와 최대한 많이 자동으로 조인합니다. 이전 단계에서 식별된 기본 키가 있는 뷰만 조인에 사용할 수 있습니다. 선택한 후 다음을 클릭합니다.
  10. 고급 프로젝트 생성 옵션을 사용 설정한 경우 고급 옵션 섹션에서 다음과 같이 선택합니다.
    • 프리픽스 무시 - 생성된 뷰 파일 이름의 테이블 프리픽스를 무시하려면 이 필드에 쉼표로 구분된 목록으로 데이터베이스의 프리픽스를 입력합니다. 이 필드는 대소문자를 구분합니다. 여러 프리픽스를 쉼표로 구분하여 나열할 수 있습니다. 예를 들어 테이블 제목이 dwh_orders 및 DBS_users입니다. 프리픽스 무시 텍스트 필드에 dwh, DBS를 입력하면 Looker가 orders 및 users라는 뷰 파일을 만듭니다.
    • 필드 설명 - 데이터베이스에서 사용 가능한 필드 설명을 생성된 측정기준에 대한 LookML 설명으로 사용하려면 필드 설명 메타데이터 가져오기 체크박스를 선택합니다.
    • 모델 파일 처리 - 모델 파일을 만들지 여부를 선택합니다. 모델 파일을 만들기로 선택한 경우 모델 이름 필드에 파일에 사용할 이름을 입력합니다.
    • 시작 가이드 - 출력 사용 방법을 설명하는 리드미 파일 생성 체크박스를 선택하여 프로젝트 사용 방법을 설명하는 리드미 파일을 생성합니다.
  11. 모델 생성을 클릭하여 프로젝트 파일을 생성합니다. Looker IDE의 파일이 생성되면 Looker에서 파일로 이동합니다.

향상된 LookML 생성

Looker 관리자가 향상된 LookML 생성 실험실 기능을 사용 설정한 경우 데이터베이스에서 프로젝트를 생성할 때 Looker가 프로젝트에 추가 요소를 추가합니다.

  • Looker는 새 프로젝트에 README 파일을 추가합니다. README 파일에는 LookML 소개 및 새 LookML 개발자를 지원하는 링크와 리소스가 포함되어 있습니다.
  • Looker는 모델 파일과 각 뷰 파일에 여러 개의 인라인 주석 설명을 추가합니다.
  • type: number의 알파벳순 첫 번째 측정기준을 기반으로 합니다.

모델을 구성해야 하는 경우

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

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

관리자(또는 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가 프로젝트에서 해당 이름의 모델을 검색하여 이렇게 합니다. 이 이름으로 발견된 첫 번째 모델이 쿼리를 실행하는 데 사용됩니다.