remote_dependency

사용

remote_dependency:  public_project {
  url:  "https://github.com/llooker/google_ga360"
  ref:  "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}

계층 구조 매니페스트 파일 remote_dependency

기본값 없음 수락 Git 저장소의 URL을 포함하는 url 하위 매개변수 Git 브랜치, Git 출시 태그, Git 저장소에서 커밋의 SHA를 지정하는 ref 하위 매개변수 override_constant 하위 매개변수: 다른 프로젝트에서 가져온 상수 값을 재정의하는 데 사용됩니다.

정의

remote_dependency 매개변수는 이 프로젝트에서 사용하려는 파일이 있는 LookML 프로젝트를 포함하는 외부 Git 저장소의 세부정보를 제공합니다. 매니페스트 파일에 remote_dependency 문을 여러 개 포함하여 프로젝트를 여러 개 가져올 수 있습니다.

remote_dependency 매개변수는 프로젝트의 매니페스트 파일에 있습니다. 프로젝트에 파일이 없는 경우 매니페스트 파일을 생성할 수 있습니다.

remote_dependency 매개변수는 이름을 사용하며, 원하는 이름을 지정할 수 있습니다. 이 이름은 include 문에서 LookML 프로젝트에서 가져온 파일을 참조하는 데 사용됩니다. 이 이름은 Looker IDE의 imported_projects 폴더 아래에 있는 폴더 이름으로도 사용됩니다.

또한 remote_dependency 매개변수에는 다음과 같은 하위 매개변수가 있습니다.

• url
• ref
• override_constant

url

url 하위 매개변수는 외부 Git 저장소의 주소를 지정합니다. 저장소의 기본 URL을 사용합니다. 예를 들어 HTTPS를 사용하는 경우:

url: "https://github.com/llooker/google_ga360"

또는 SSH를 사용하는 경우:

url: "[e-mail]:llooker/google_ga360.git"

ref

ref 하위 매개변수는 Looker가 Looker 프로젝트로 가져와야 하는 원격 프로젝트의 Git 저장소에 있는 Git 브랜치, Git 출시 태그 또는 커밋 SHA를 지정합니다.

• Git 브랜치: Looker가 원격 프로젝트에서 해당 브랜치의 새 커밋을 자동으로 감지하도록 하려면 Git 브랜치를 지정하면 됩니다. 자세한 내용은 다른 프로젝트에서 파일 가져오기 문서 페이지를 참고하세요.
• Git 출시 태그: Looker가 원격 프로젝트에서 해당 태그의 새 커밋을 자동으로 감지하도록 하려면 Git 출시 태그를 지정하면 됩니다. 자세한 내용은 다른 프로젝트에서 파일 가져오기 문서 페이지를 참고하세요.
• Git 커밋 SHA: 정적 버전 관리를 원하는 경우 커밋 SHA를 지정할 수 있습니다. 그러면 가져온 프로젝트의 변경사항이 프로젝트에 자동으로 반영되지 않습니다. 일반적으로 이는 가장 최근 커밋이지만 반드시 그래야 하는 것은 아닙니다. 커밋 기록을 탐색할 수 있는 곳이라면 어디에서나 커밋 SHA를 확인할 수 있습니다. Git 서비스 제공업체는 일반적으로 SHA를 명확하게 표시하고 복사할 수 있도록 합니다. 이 옵션은 Looker 블록에 적합합니다.

다음은 원격 Git 프로젝트의 커밋 SHA를 지정하는 원격 종속 항목의 예입니다.

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "f99720c597f524d0756b8194990342efa11b3813"
  }

다음은 원격 Git 프로젝트에서 기본 브랜치를 지정하는 원격 종속 항목의 예입니다.

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "main"
}

지정한 ref 유형에 관계없이 프로젝트에 remote_dependency를 추가하고 LookML의 유효성을 검사하면 IDE에 종속 항목 업데이트 버튼이 표시됩니다. 버튼을 클릭하여 원격 프로젝트 파일을 가져옵니다. 프로젝트에 추가한 첫 번째 원격 프로젝트인 경우 종속 항목을 업데이트하면 Looker가 매니페스트 잠금 파일을 만들라는 메시지를 표시합니다. Looker는 매니페스트 잠금 파일을 사용하여 원격 프로젝트의 버전을 추적합니다. 자세한 내용은 다른 프로젝트에서 파일 가져오기 문서 페이지의 원격 프로젝트의 새 버전 자동 감지 섹션을 참고하세요.

override_constant

override_constant 매개변수를 사용하면 가져온 프로젝트에 정의된 상수 값을 재정의할 수 있습니다.

override_constant 매개변수는 로컬 프로젝트 가져오기를 위해 local_dependency 매개변수와 함께 사용할 수도 있습니다.

한 프로젝트에서 다른 프로젝트로 파일을 가져올 때 가져온 프로젝트의 매니페스트 파일에 정의된 상수의 값을 재정의할 수 있습니다. 상수의 값을 재정의하면 해당 상수를 참조하는 가져온 파일이 가져오기 프로젝트에 제공된 새 값을 사용합니다.

가져온 프로젝트에 정의된 상수의 export 매개변수가 override_required 또는 override_optional로 설정된 경우 local_dependency의 override_constant 하위 매개변수를 사용하여 해당 상수에 새 값을 제공할 수 있습니다. 예를 들어 가져온 프로젝트의 매니페스트 파일에 정의된 상수 connection이 있다고 가정해 보겠습니다.

constant: connection {
  value: "imported_project_connection"
  export: override_required
}

이 예시에서는 export 매개변수가 override_required로 설정되어 있으므로 가져오기 프로젝트의 매니페스트 파일에서 값을 재정의해야 합니다.

project_name: "importing_project"

remote_dependency: public_project {
  url: "https://github.com/llooker/project"
  ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: connection {
    value: "importing_project_connection"
  }
}

자세한 내용과 가져오는 프로젝트에서 상수를 재정의하는 또 다른 예는 다른 프로젝트에서 파일 가져오기 문서 페이지를 참고하세요.

예

매니페스트 파일에서 파일을 가져올 소스로 'Google GA 360' Git 저장소를 추가합니다.

project_name: "thelook"

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "6a95679c92efa56243c17fb4d66c820cd4a8db03"
}