Looker 블록 배포

이 페이지에서는 다음과 같은 공개 GitHub 저장소에 있는 Cortex Framework용 사전 빌드된 Looker 블록을 설치하는 단계를 설명합니다.

Dun & Bradstreet용 Looker 대시보드를 배포하려면 Dun & Bradstreet용 데이터 스튜디오 대시보드를 참고하세요.

기본 요건

이러한 사전 빌드된 대시보드에 액세스하고 사용하려면 먼저 다음을 수행해야 합니다.

Cortex Framework 배포: Cortex Framework가 데이터 소스와 함께 설정 및 구성되어 있는지 확인합니다. 자세한 내용은 배포를 위한 Cortex Framework 기본 요건을 참고하세요.
Looker 액세스: Looker에 액세스하고 플랫폼에 익숙해집니다.
사용 가능한 대시보드 살펴보기: 사전 빌드된 대시보드와 배포하려는 대시보드에서 사용 가능한 통계를 살펴봅니다. 자세한 내용은 사용 가능한 Looker 블록을 참고하세요.

기본 요건을 완료하면 Looker 블록을 설치할 수 있습니다.

설치

Looker 블록은 LookML(Looker 모델링 언어)을 사용하여 Looker 대시보드의 시맨틱 모델을 정의합니다. Cortex 데이터 소스에 해당하는 LookML 모델을 설치하려면 다음 옵션 중 하나를 사용하세요.

옵션 A: Git URL에서 Looker Marketplace를 통해 설치
옵션 B: 저장소를 포크하여 설치합니다.

다음 섹션에서는 각 옵션의 단계를 설명합니다.

옵션 A: Git URL에서 Looker Marketplace를 통해 설치

Looker Marketplace는 Looker 내에서 Looker 블록, 애플리케이션, 시각화, 플러그인을 찾고, 배포하고, 관리하는 중앙 위치입니다. Git URL에서 Looker Marketplace를 통해 설치하려면 다음 단계를 따르세요.

Looker 인스턴스로 이동합니다.
Looker 메뉴 바 에서 Marketplace 버튼을 클릭합니다.
Marketplace 메뉴에서 관리 옵션을 선택합니다.
관리 페이지에서 점 3개로 된 옵션 메뉴 를 선택합니다.
Git URL을 통해 설치 버튼을 선택합니다.
선택한 저장소의 URL과 커밋 SHA를 입력합니다.
설치를 클릭합니다.
이용약관 대화상자에서 동의 및 계속을 클릭합니다.
데이터에 해당하는 필수 매개변수를 입력합니다.
- 연결 이름
- 프로젝트 ID
- 보고 데이터 세트
설치를 클릭합니다.

자세한 내용은 Git URL에서 도구 설치에 대한 Looker 문서를 참고하세요.

옵션 B: 저장소를 포크하여 설치

저장소를 포크하여 Looker 블록을 설치하려면 다음 단계를 따르세요.

GitHub 저장소 포크:
1. 선택한 Looker 블록의 GitHub 저장소로 이동합니다.
2. 저장소의 오른쪽 상단에 있는 포크를 클릭합니다.
3. 사용자 이름으로 포크를 만듭니다. 이렇게 하면 GitHub 계정에 저장소의 사본이 생성됩니다.
빈 LookML 프로젝트 만들기:

참고: Looker 버전 24.20 이전의 경우 새 프로젝트 페이지에서 빈 프로젝트 만들기를 참고하세요.
1. 개발 모드에 있는지 확인합니다.
2. 개발 메뉴에서 프로젝트를 선택합니다.
3. LookML 프로젝트 페이지의 왼쪽 상단에서 새 모델 구성을 선택하여 모델 구성 페이지를 엽니다.
4. 모델 구성 페이지에서 모델의 옵션을 지정합니다.
  1. 모델: 저장소에 있는 model.lkml 파일과 동일한 이름으로 모델의 이름을 지정합니다. 예를 들어 모델 이름을 cortex-<datasource>로 지정합니다.
    
    참고: Looker는 고유한 모델 이름을 적용합니다. 원하는 이름의 모델이 이미 있으면 오류 메시지가 표시됩니다. 설치 실패를 방지하려면 모델 이름이 고유해야 합니다.
  2. 프로젝트: 프로젝트 이름을 지정합니다. 모델과 동일한 이름을 지정하거나 다른 이름을 지정합니다.
  3. 허용된 연결: 모델에서 사용할 수 있는 데이터베이스 연결을 지정하거나 모델에서 현재 또는 향후 연결을 모두 사용할 수 있도록 지정합니다.
5. 저장을 클릭하여 프로젝트를 대기 중인 프로젝트로 저장합니다.
6. LookML 프로젝트 페이지에서 대기 중인 프로젝트 섹션 아래에 있는 새 프로젝트를 찾습니다.
7. LookML 추가를 클릭하여 새 프로젝트 페이지를 엽니다.
8. 새 프로젝트 페이지에서 프로젝트 옵션을 지정합니다.
  1. 프로젝트 이름: 이전 단계에서 지정한 값으로 이미 채워져 있습니다.
  2. 시작점: 빈 프로젝트를 선택합니다.
9. 프로젝트 만들기를 선택합니다. Looker에서 프로젝트를 만들고 Looker IDE에서 엽니다.
자세한 내용은 LookML 모델 생성에 관한 원래 Looker 문서를 참고하세요.
포크된 저장소에 새 LookML 프로젝트 연결: Looker 문서 Git 연결 설정 및 테스트의 단계를 따릅니다.
manifest.lkml 파일에서 상수 값을 업데이트합니다.
1. Looker에서 포크된 저장소의 manifest.lkml 파일을 엽니다.
2. 상수 섹션을 찾아 필수 매개변수 섹션에 설명된 대로 값을 업데이트합니다.
변경사항을 커밋하고 프로덕션에 배포합니다. 포크된 저장소를 기반으로 하는 Looker 프로젝트를 사용하면 고유한 비즈니스 요구사항에 맞게 LookML을 맞춤설정할 수 있습니다. 프로덕션에 변경사항 적용의 단계를 따릅니다.

필수 매개변수

이러한 필수 값은 Marketplace 설치 과정에서 구성됩니다. 또는 포크된 Git 저장소에서 이 블록을 설치한 경우 프로젝트의 manifest.lkml 파일에서 이러한 상수의 값을 업데이트해야 합니다.

매개변수	값	설명	Looker 블록
`Connection Name`	연결 이름	Looker가 Cortex 보고 데이터 세트를 쿼리할 수 있도록 허용하는 BigQuery 연결 이름입니다. 사용 설정되어 있어야 합니다.	전체
`Project ID`	프로젝트 ID	보고 데이터 세트가 BigQuery에 있는 Google Cloud 프로젝트입니다. 자세한 내용은 프로젝트 식별을 참고하세요.	전체
`Reporting Dataset`	보고용 데이터 세트의 이름	데이터 소스 데이터 세트 뷰가 Google Cloud BigQuery 프로젝트 내에 있는 배포된 Cortex Data Foundation 보고 데이터 세트입니다. Cortex Data Foundation의 배포 설정에 따라 이 데이터 세트 이름은 일반적으로 `_REPORTING`로 끝나는 패턴입니다.	전체
`Client`	SAP 클라이언트 번호 (`mandt`)	보고에 사용할 SAP 클라이언트 번호 (`mandt`)입니다.	SAP
`Sign Change`	`Yes` 또는 `No`	손익계산서/소득 명세서 보고의 경우 수익은 일반적으로 총계정원장에 음수로 표시되며 이는 대변을 나타냅니다. 부호 변경 값을 `Yes`로 설정하면 손익계산서 보고서에 양수로 표시됩니다.	SAP

추가 블록별 요구사항

일부 블록에는 배포를 위한 특정 요구사항이 있습니다. 자세한 내용은 블록별 배포를 참고하세요.

Block	추가 요구사항 링크
SAP	SAP용 Cortex Framework Looker 블록의 추가 사양
Oracle EBS	Oracle EBS용 Cortex Framework Looker 블록의 추가 사양

추가 리소스

LookML에 대한 자세한 내용은 다음 문서와 교육을 참고하세요.