Looker 확장 프로그램 프레임워크

Looker 확장 프로그램 프레임워크는 커스텀 자바스크립트 데이터 애플리케이션 및 도구를 빌드하는 데 따른 수고와 복잡성을 크게 줄여주는 다음과 같은 개발 프레임워크입니다.

  • 회사의 내부 플랫폼 애플리케이션
  • Looker의 데이터로 빌드된 임베디드 분석 애플리케이션의 고객 포털과 같은 고객용 외부 플랫폼
  • 타겟팅된 내부 도구
  • 외부 애플리케이션에 삽입하기 위한 애플리케이션

Looker Marketplace에서 현재 제공되는 Looker 확장 프로그램의 예로는 Looker 데이터 사전 및 LookML 다이어그램이 있습니다.

확장 프로그램 프레임워크를 사용하는 이유는 무엇인가요?

일부 웹 애플리케이션을 빌드하는 것은 쉽고 재밌는 반면 다른 일부는 시간이 더 많이 걸리고 재미가 없을 수 있습니다. 확장 프로그램 프레임워크는 번거로운 여러 태스크를 간소화하는 데 도움이 됩니다.

확장 프로그램 프레임워크는 웹 애플리케이션을 빌드할 때의 번거로운 작업을 처리하므로 개발을 바로 시작하는 데 집중할 수 있습니다. 확장 프로그램 프레임워크로 만든 커스텀 애플리케이션과 도구는 Looker 내에서 액세스할 수 있으므로 Looker에서 다음과 같은 종류의 기능을 처리할 수 있습니다.

확장 프로그램 프레임워크 기능

Looker 확장 프로그램 프레임워크에는 다음 기능이 포함됩니다.

  • Looker 확장 SDK: Looker 공개 API 액세스를 위한 기능과 Looker 환경 내에서 상호작용하는 기능을 제공합니다.
  • Looker 구성요소: 확장 프로그램에서 사용할 수 있도록 사전 빌드된 React UI 구성요소의 라이브러리입니다.
  • 삽입 SDK: 확장 프로그램에 대시보드, Look, 탐색을 삽입하기 위해 사용할 수 있는 라이브러리입니다. 코드 예시는 kitchen sink 확장 프로그램을 참고하세요. Embed SDK를 사용하여 확장 프로그램을 서드 파티 애플리케이션에 삽입할 수도 있습니다. 탐색, Look 또는 대시보드를 확장 프로그램에 삽입할 때 브라우저에서 쿠키를 사용 설정해야 합니다.
  • create-looker-extension 유틸리티: 필요한 모든 확장 프로그램 파일과 종속 항목이 포함된 기본 확장 프로그램을 만들고 빌드의 시작점으로 사용할 수 있습니다.
  • Looker 확장 프레임워크 예시 저장소: 빠른 시작을 도와주는 템플릿 및 샘플 확장 프로그램이 포함되어 있습니다.
  • 타사 API 엔드포인트에 액세스하고 타사 데이터를 확장 프로그램에 추가하는 기능

  • Looker 내에서 전체 화면 확장 프로그램을 만드는 기능. 전체 화면 확장 프로그램은 내부 또는 외부 플랫폼 애플리케이션에 사용할 수 있습니다.

    전체 화면 확장 프로그램에서 확장 프로그램 전용 사용자 그룹에 사용자를 추가하여 일부 사용자가 확장 프로그램에서 Looker의 다른 부분으로 이동하지 못하도록 할 수 있습니다. 확장 프로그램 URL에서 /extensions를 /spartan으로 바꿔 Looker 탐색 메뉴를 삭제할 수도 있습니다.

  • 사용자가 확장 프로그램을 실행할 때 키를 입력해야 하도록 확장 프로그램에 대한 액세스 키 구성 기능. 이 기능은 확장 프로그램에 대한 요금을 부과하려는 경우 유용하지만 확장 프로그램에 대한 액세스가 제공되지 말아야 하는 사용자의 액세스를 제한하기 위해서는 표준 Looker 권한을 사용해야 합니다.

  • Looker 24.0부터는 확장 프로그램이 대시보드의 타일에서 실행되도록 개발할 수 있습니다. 타일 또는 시각화로 실행되도록 지원하는 확장 프로그램을 대시보드가 수정 모드에 있는 동안 추가하거나 Explore에서 시각화로 대시보드에 저장할 수 있습니다. LookML 대시보드에서 확장 프로그램을 타일로 구성할 수도 있습니다.

확장 프로그램 프레임워크 요구사항

Looker 확장 프로그램 프레임워크를 사용하여 개발하려면 다음 단계를 따르세요.

Looker 내에서 실행하려면 기능과 관계없이 모든 확장 프로그램이 Looker 내에 다음 요소를 포함해야 합니다.

  • 다음 요구사항을 충족하는 LookML 프로젝트:

  • 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"
    mount_points: {
      standalone: no
    }
    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 확장 프로그램 프레임워크 코드 예시 문서 페이지에서 예시 코드와 함께 일반적인 사용 사례 목록을 확인할 수 있습니다.

  • Looker UI 구성요소 사이트를 참고하여 구성요소 라이브러리를 사용하여 빠르게 UI 및 레이아웃을 개발하세요.

  • Looker 확장 Kitchensink 템플릿은 다양한 확장 기능 예시를 제공하는 확장 프로그램입니다. 이 템플릿은 백과사전이나 참조 가이드로 사용할 수 있지만 시작점이나 실제 템플릿으로 사용할 수는 없습니다. 시작하려면 확장 프로그램 생성기를 사용하거나 더 간단한 예시 중 하나를 클론하는 것이 좋습니다.

  • 대시보드 타일로 사용할 수 있는 확장 프로그램의 예시도 제공됩니다. 타일 시각화 확장 프로그램에서는 확장 프로그램 프레임워크를 사용하여 커스텀 시각화를 빌드하는 방법을 보여줍니다. 타일 SDK 확장 프로그램은 사용 가능한 타일 확장 관련 API 메서드를 보여줍니다.