Looker 확장 프로그램 프레임워크는 다음과 같은 맞춤 자바스크립트 데이터 애플리케이션 및 도구를 빌드하는 수고와 복잡성을 크게 줄여주는 개발 프레임워크입니다.
- 회사 내부 플랫폼 애플리케이션
- Looker의 데이터로 빌드된 삽입된 애널리틱스 애플리케이션용 고객 포털과 같은 고객을 위한 외부 플랫폼
- 대상 내부 도구
- 외부 애플리케이션에 삽입할 수 있는 애플리케이션
현재 Looker Marketplace에서 사용할 수 있는 Looker 확장 프로그램의 예로는 Looker 데이터 사전과 LookML 다이어그램이 있습니다.
확장 프레임워크를 사용하는 이유
웹 애플리케이션을 빌드하는 작업의 일부는 쉽고 재미있지만, 일부는 시간이 더 오래 걸리고 재미있지 않습니다. 확장 프레임워크는 이러한 재미있지 않은 많은 작업을 간소화하여 도움이 됩니다.
확장 프로그램 프레임워크는 웹 애플리케이션을 빌드하는 좀 더 지루한 작업 일부를 처리하므로 개발자는 바로 개발을 시작하는 데 집중할 수 있습니다. 확장 프로그램 프레임워크로 만든 커스텀 애플리케이션 및 도구를 Looker 내에서 액세스하여 Looker가 다음과 같은 종류의 기능을 처리할 수 있습니다.
- 인증: 로그인 시 Looker의 기존 인증 옵션 (예: 비밀번호 로그인, LDAP, SAML, OpenID Connect)을 사용할 수 있습니다.
- 액세스 제어 및 권한 관리:
- API 액세스 — Looker 내에서 타사 API 엔드포인트와 같은 다른 일반적인 개발자 리소스를 활용할 수 있습니다.
확장 프로그램 프레임워크 기능
Looker 확장 프로그램 프레임워크에는 다음과 같은 기능이 포함되어 있습니다.
- Looker 확장 API: Looker 공개 API 액세스와 Looker 환경 내에서의 상호작용을 위한 함수를 제공합니다.
- Looker 구성요소: 확장 프로그램에서 사용할 수 있도록 사전 빌드된 React UI 구성요소 라이브러리입니다.
- 확장 프로그램에 대시보드, 스타일, 탐색을 삽입하는 데 사용할 수 있는 라이브러리인 삽입 SDK. 코드 예는 주방 싱크 확장 프로그램을 참고하세요. Embed SDK를 사용해 확장 프로그램을 서드 파티 애플리케이션에 삽입할 수도 있습니다. 탐색 분석, 스타일 또는 대시보드를 확장 프로그램에 삽입할 때 브라우저에서 쿠키가 사용 설정되어 있어야 합니다.
- 필요한 확장 프로그램 파일과 종속 항목을 모두 포함하는 기본 확장 프로그램을 만드는
create-looker-extension
유틸리티를 이를 기반으로 출발점으로 사용할 수 있습니다. - Looker 확장 프로그램 프레임워크 예시 저장소에는 템플릿 및 샘플 확장 프로그램이 포함되어 있어 빠르게 시작하는 데 도움이 됩니다.
- 서드 파티 API 엔드포인트에 액세스하고 서드 파티 데이터를 확장 프로그램에 추가할 수 있습니다.
Looker 내에서 전체 화면 확장 프로그램을 만들 수 있는 기능 전체 화면 확장 프로그램을 내부 또는 외부 플랫폼 애플리케이션에 사용할 수 있습니다.
전체 화면 확장 프로그램에서는 확장 프로그램 전용 사용자 그룹에 사용자를 추가하여 일부 사용자가 확장 프로그램에서 Looker의 다른 부분으로 이동하지 못하게 할 수 있습니다. 확장 프로그램 URL에서
/extensions
를/spartan
로 바꿔 Looker 탐색 메뉴를 삭제할 수도 있습니다.사용자가 확장 프로그램을 실행할 때 키를 입력해야 하도록 확장 프로그램의 액세스 키를 구성하는 기능 확장 프로그램에 대한 비용을 청구하고 싶지만 표준 Looker 권한을 사용하여 확장 프로그램에 액세스해서는 안 되는 사용자에게 액세스 권한을 제한해야 하는 경우 유용합니다.
확장 프로그램 프레임워크 요구사항
Looker 확장 프로그램 프레임워크를 사용하여 개발하려면 다음 안내를 따르세요.
- 인스턴스에 LookML 개발자 권한이 필요합니다.
- Looker 관리자가 확장 프레임워크 기능을 사용 설정해야 합니다.
- 자바스크립트나 TypeScript에 익숙해지는 것이 좋습니다.
- React로 개발하는 것이 좋습니다. 단, 원시 자바스크립트용 확장 프로그램 SDK는 있습니다.
Looker 내에서 실행하려면 모든 확장 프로그램이 기능과 관계없이 Looker 내부에 다음 요소를 포함해야 합니다.
다음과 같은 LookML 프로젝트
- 모델 파일 포함
- 프로젝트 매니페스트 파일을 포함합니다.
- Git 저장소에 연결되어 있습니다.
LookML 모델 파일에는 인스턴스의 유효한 데이터베이스 연결을 가리키는
connection
매개변수가 필요합니다.프로젝트 매니페스트 파일에는
application
매개변수가 필요합니다.application
매개변수는 확장 프로그램에 라벨을 지정하고 확장 프로그램 자바스크립트를 찾을 위치를 Looker에 알려주며 확장 프로그램의 사용 권한 목록을 제공합니다. 사용 권한은 확장 프로그램이 액세스할 수 있는 Looker 리소스를 정의합니다. 리소스가 사용 권한에 표시되지 않는 한 Looker 리소스에 액세스할 수 없습니다. 다음은application
매개변수가 있는 프로젝트 매니페스트 파일의 예입니다.
project_name: "super_duper_extension"
application: super_duper_extension {
label: "Super Duper Extension"
url: "http://localhost:8080/dist/bundle.js"
entitlements: {
local_storage: no
navigation: no
new_window: no
new_window_external_urls: []
use_form_submit: yes
use_embeds: no
use_downloads: no
core_api_methods: []
external_api_urls: []
oauth2_urls: []
scoped_user_attributes: []
global_user_attributes: []
}
}
자세한 내용은 application
매개변수 문서 페이지를 참고하세요.
Looker 확장 프로그램 프레임워크로 개발 시작하기
가장 쉬운 방법은 템플릿에서 새로운 시작 광고 확장을 생성한 다음 기능을 맞춤설정하고 해당 시작 도구에 추가하는 것입니다. 이렇게 하면 모든 구성과 패키징이 올바르게 이루어지므로 직접 처리하기가 어려울 수 있습니다. 확장 프로그램의 새 Looker 프로젝트를 만들고 시작 확장 프로그램을 생성하는 방법은 Looker 확장 프로그램 소개 소개 문서를 참고하세요.
더 맞춤설정된 템플릿이나 고급 템플릿의 경우 Looker 확장 프로그램 프레임워크 예시 저장소를 찾아볼 수 있습니다. 이 저장소의 모든 확장 프로그램을 클론하여 프로젝트의 시작점으로 재사용할 수 있습니다.
간단한 확장 프로그램을 만들고 모든 것이 정상적으로 작동하는 것을 확인하고 나면 다음과 같이 추가 기능과 맞춤설정을 추가할 수 있습니다.
Looker 확장 프로그램 프레임워크 코드 예시 문서 페이지에서 예시 코드와 함께 일반적인 사용 사례 목록을 확인할 수 있습니다.
빠른 UI 및 레이아웃 개발을 위해 구성요소 라이브러리를 사용하려면 Looker UI 구성요소 사이트를 참고하세요.
Looker 확장 주방 주방 템플릿은 매우 다양한 확장 프로그램 기능의 예를 제공하는 확장 프로그램입니다. 이 템플릿을 백과사전 또는 참조 가이드로 사용할 수 있지만 시작점이나 실제 템플릿은 사용할 수 없습니다. 먼저 확장 프로그램 생성기를 사용하거나 더 간단한 예시 중 하나를 클론하는 것이 좋습니다.