새 LookML 프로젝트 만들기

프로젝트는 데이터베이스 테이블이 서로 연관된 방식 및 Looker가 해당 테이블을 해석하는 방법을 설명하는 LookML 파일 모음입니다. 프로젝트에 대한 자세한 내용은 LookML 프로젝트 및 개발 모델 및 LookML 용어 및 개념 문서 페이지를 참고하세요. 기존 프로젝트에 액세스하고 수정하는 방법에 대한 자세한 내용은 프로젝트 정보 액세스 및 수정 문서 페이지를 참조하세요.

LookML 프로젝트에는 모델 파일이 두 개 이상 포함될 수 있습니다. 하지만 특정 모델 파일의 LookML을 보고 수정하는 것과 관련된 권한을 사용자에게 지정하려면 새 프로젝트를 만드는 것이 좋습니다. Looker의 대부분의 권한은 모델 수준에 적용되지만 프로젝트의 LookML을 볼 수 있는 see_lookml 및 LookML을 수정할 수 있는 develop 등 프로젝트 수준에 적용되는 경우도 있습니다.

manage_models 권한이 있는 Looker 사용자는 Looker 인스턴스에서 LookML 모델을 만들 수 있습니다.

프로젝트 만들기

프로젝트를 만들려면 다음 단계를 수행합니다.

  1. 개발 모드에 있는지 확인합니다.

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

  3. LookML 프로젝트 페이지에서 새 LookML 프로젝트를 선택하여 프로젝트 옵션을 선택합니다.

이 작업을 수행하면 새 프로젝트 페이지가 열리고 여기에서 프로젝트 이름 및 시작점을 포함하여 프로젝트의 설정을 지정할 수 있습니다.

Looker는 여러 가지 방법으로 프로젝트를 만들 수 있으며, 수행하는 단계는 새 프로젝트 페이지에서 선택한 시작점 옵션에 따라 다릅니다. 다음 섹션에서는 이러한 시작점의 작동 방식을 설명합니다.

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

새 프로젝트 페이지에서 다음 옵션을 지정하여 데이터베이스에서 모델을 자동으로 생성합니다.

  1. 프로젝트 이름: 프로젝트 이름을 지정합니다. 프로젝트 이름은 대소문자를 구분하며 영숫자 문자, _, ., -만 허용됩니다. 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에서 찾을 수 있습니다.

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

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

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

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

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

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

마지막으로 Create Project를 클릭하여 생성된 모델이 포함된 프로젝트를 만듭니다.

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

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

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

공개 Git 저장소 클론

공개 Git 저장소 클론을 시작점으로 선택하면 Looker에서 공개 Git 저장소의 파일을 새 LookML 프로젝트에 복사합니다.

공개 Git 저장소에서 클론된 Looker 프로젝트는 읽기 전용입니다. 하지만 읽기 전용 프로젝트를 다른 Looker 프로젝트로 가져와 파일을 수정할 수 있습니다. 또한 클론된 저장소 파일을 시작점으로 사용하여 Looker extends 매개변수 또는 상세검색을 사용하여 프로젝트를 빌드할 수 있습니다.

새 프로젝트 페이지에서 다음 옵션을 지정하여 기존 공개 Git 저장소를 Looker 프로젝트로 클론합니다.

  1. 프로젝트 이름: 프로젝트 이름을 지정합니다. 프로젝트 이름은 대소문자를 구분하며 공백이나 특정 특수문자를 사용할 수 없습니다. 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에서 찾을 수 있습니다.

  2. 시작점: 공개 Git 저장소 클론을 선택합니다.

  3. Git 저장소 URL: 공개 Git 저장소의 URL을 입력합니다. URL 형식이 git://github.com/example/my-repository.git여야 합니다.

    https://github.com/llooker/blocks_redshift_admin과 같은 URL이 있는 경우 'https://'를 'git://'으로 바꾸고 끝에 '.git'을 추가하여 올바른 형식으로 사용할 수 있습니다. 입력할 URL은 git://github.com/llooker/blocks_redshift_admin.git입니다.

마지막으로 프로젝트 만들기를 클릭합니다. Looker에서 모든 공개 저장소의 파일을 새 LookML 프로젝트로 가져오고 Looker IDE에서 프로젝트를 엽니다.

빈 프로젝트 만들기

빈 프로젝트를 시작 지점으로 선택하면 Looker에서 빈 프로젝트를 만들어 LookML 파일을 처음부터 만들 수 있습니다.

새 프로젝트 페이지에서 다음 옵션을 지정하여 빈 프로젝트를 만듭니다.

  1. 프로젝트 이름: 프로젝트 이름을 지정합니다. 프로젝트 이름은 대소문자를 구분하며 공백이나 특정 특수문자를 사용할 수 없습니다. 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에서 찾을 수 있습니다.

  2. 시작점: 빈 프로젝트를 선택합니다.

마지막으로 프로젝트 만들기를 클릭합니다. Looker에서 프로젝트를 만들고 Looker IDE에서 엽니다.

다음 단계

프로젝트를 만든 후에는 다음 작업을 수행할 수 있습니다.