Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Looker 데이터 앱 개요 및 설정

Looker 데이터 앱은 Gemini CLI, Claude Code, Cursor와 같은 로컬 AI 코딩 에이전트가 자연어 프롬프트에서 빌드하는 자유 형식 캔버스 대시보드입니다. 표준 그리드 대시보드와 달리 데이터 앱은 Looker의 관리 LookML 시맨틱 레이어 및 사용자 권한에 바인딩된 상태로 유지되면서 절대 위치 지정, 중복 요소, 맞춤 웹 구성요소를 비롯한 완전한 시각적 레이아웃 제어를 제공합니다.

데이터 앱을 빌드할 때 AI 코딩 에이전트는 로컬 머신에서 실행되어 애플리케이션 코드를 생성합니다. 데이터 앱을 Looker에 게시한 후에는 사용자가 대시보드를 열거나 대시보드와 상호작용할 때 AI 모델이 관여하지 않습니다.

Looker 데이터 앱 개요

데이터 앱은 Looker 확장 프로그램 프레임워크로 구동되고 단일 요소 사용자 정의 대시보드 (UDD) 내에서 실행되는 Looker 확장 프로그램입니다.

주요 기능은 다음과 같습니다.

AI 지원 작성, 런타임 AI 없음: 컴퓨터에서 AI 코딩 에이전트를 사용하여 프롬프트에서 레이아웃 및 구성요소 코드를 생성합니다. 게시된 데이터 앱은 사용자가 대시보드를 볼 때 AI 모델을 호출하지 않고 Looker 내에서 표준 웹 구성요소로 실행됩니다.
네트워크 격리 샌드박스: AI 에이전트가 애플리케이션 코드를 작성하므로 Looker는 아웃바운드 네트워크 연결을 차단하는 격리된 브라우저 샌드박스 내에서 모든 데이터 앱을 실행합니다. 애플리케이션 코드는 Looker 인스턴스와만 통신할 수 있으므로 쿼리 결과와 사용자 인증 정보를 외부 서버로 전송할 수 없습니다.
관리되는 데이터 액세스: 데이터 앱은 Looker의 LookML 시맨틱 레이어를 통해서만 데이터를 쿼리합니다. 모든 쿼리는 보기 사용자의 Looker 권한, 모델 액세스, 행 수준 액세스 필터에 따라 실행됩니다.
대화형 컨트롤 및 예약된 전송: 데이터 앱에는 앱 내에 기본 제공 대화형 필터, 교차 필터링, 드릴 뷰가 포함되어 있으며 데이터 앱은 Looker PDF 다운로드 및 예약된 이메일 전송을 지원합니다.

시작하기 전에

개발자 도구를 설치하고 데이터 앱을 작성하기 전에 다음 기본 요건을 충족하는지 확인하세요.

인스턴스 요구사항

Looker 26.18 이상을 실행하는 Looker 호스팅 인스턴스를 사용해야 합니다.
Looker 관리자는 관리 패널의 일반 > 미리보기에서 데이터 앱 미리보기 전환을 사용 설정해야 합니다. 자세한 내용은 미리보기 기능 문서 페이지를 참고하세요.
사용자의 브라우저가 데이터 앱 런타임 라이브러리를 로드하려면 www.gstatic.com에 대한 네트워크 액세스 권한이 있어야 합니다.

필수 권한

데이터 앱을 만들고 게시하려면 다음이 필요합니다.

대시보드를 배치할 폴더에 대한 액세스 관리, 수정 액세스 수준
access_data, explore, see_user_dashboards, save_dashboards (또는 save_content) Looker 권한
대시보드에서 사용하려는 모든 데이터에 대한 LookML 모델에 액세스할 수 있어야 합니다.

게시된 데이터 앱을 보려면 사용자에게 다음이 있어야 합니다.

대상 폴더에 대한 보기 액세스 수준
기본 LookML 모델의 access_data, explore, see_user_dashboards Looker 권한

Looker API 사용자 인증 정보

개발자 도구는 Looker API를 사용하여 Looker 인스턴스에 액세스합니다. 개발자 도구에 Looker API 액세스 권한을 부여하려면 클라이언트 ID와 클라이언트 보안 비밀번호로 구성된 API 키가 필요합니다. 설정 옵션을 구성할 때 클라이언트 ID와 클라이언트 보안 비밀번호를 개발자 도구에 제공합니다.

API 키를 검색하려면 다음 단계를 따르세요.

Looker 관리자는 관리 > 사용자 페이지에서 사용자 계정에 API 키를 사용 설정해야 합니다.
Looker에서 사용자 계정 페이지로 이동합니다.
인증 섹션에서 API 키 제목 옆에 있는 관리를 클릭합니다.
API 키 페이지에서 기존 API 키를 보거나 새 API 키를 만들 수 있습니다.
선택한 API 키의 클라이언트 ID와 클라이언트 보안 비밀번호를 복사합니다.

폴더 식별자

데이터 앱을 게시할 Looker 폴더의 숫자 ID를 확인합니다. Looker에서 대상 폴더 (예: 공유 또는 내 폴더)를 열고 URL 끝에 있는 숫자를 확인합니다.

https://LOOKER_INSTANCE_URL/folders/FOLDER_ID

제한사항

Looker 데이터 앱에는 다음과 같은 제한사항이 있습니다.

삽입, 테마, 인쇄: 데이터 앱은 삽입, 내부 대시보드 테마, 인쇄를 지원하지 않습니다. 하지만 AI 코딩 에이전트에게 프롬프트를 입력하여 데이터 앱에서 직접 시각적 스타일을 맞춤설정할 수 있습니다.
데이터 앱 복사: Looker에서 데이터 앱을 복사하지 마세요. 사본은 동일한 기본 애플리케이션을 참조하므로 한 사본에 적용된 변경사항은 모든 사본에 반영됩니다.
LookML 내보내기 및 가져오기: 데이터 앱을 LookML로 내보내고 LookML에서 데이터 앱을 가져오는 기능은 지원되지 않습니다.
www.gstatic.com 종속 항목: 데이터 앱은 런타임 및 구성요소 라이브러리를 로드하기 위해 www.gstatic.com에 대한 네트워크 액세스가 필요합니다. 사용자의 브라우저가 데이터 앱을 렌더링하려면 www.gstatic.com에 연결할 수 있어야 합니다.

개발자 도구 설치

데이터 앱을 작성하려면 로컬 개발 환경 (macOS 또는 Linux)에 개발자 도구를 설치하세요.

설치 스크립트를 실행합니다.

AI 코딩 에이전트에 액세스할 수 있는 머신에서 터미널을 열고 다음 명령어를 실행합니다.

bash <(curl -fsSL https://dl.google.com/looker-data-apps/install.sh)

설정 옵션 구성

설치 중에 대화형 프롬프트에 응답합니다.

설치 디렉터리: 데이터 앱 프로젝트를 저장할 로컬 경로를 입력하거나 Enter 키를 눌러 기본값(~/looker-data-apps)을 수락합니다.
Looker 인스턴스 URL: Looker 인스턴스 URL(예: https://myinstance.looker.com)을 입력합니다.
Looker API client_id: 클라이언트 ID를 입력합니다.
Looker API client_secret: 클라이언트 보안 비밀을 입력합니다 (소유자 전용 파일 권한으로 data-apps-config.json에 로컬로 저장됨).
Looker 폴더 ID: 폴더 식별자에서 확인한 타겟 폴더 ID를 입력하거나 Enter 키를 눌러 기본 폴더(1 폴더, 공유 폴더)를 수락합니다.

프롬프트를 완료하면 설치 프로그램이 사용자 인증 정보가 작동하고 Looker 인스턴스가 데이터 앱을 저장하고 제공할 수 있는지 확인하기 위해 4단계 확인 검사를 자동으로 실행합니다.

데이터 앱 작성, 미리보기, 게시

다음 워크플로에 따라 AI 코딩 에이전트로 데이터 앱을 만드세요.

1단계: AI 코딩 에이전트 시작하기

터미널에서 데이터 앱 설치 디렉터리(~/looker-data-apps)로 이동하여 AI 코딩 에이전트를 실행합니다.

2단계: 에이전트에게 데이터 앱 생성 요청

자연어를 사용하여 프롬프트를 작성하고 에이전트에게 애플리케이션을 빌드해 달라고 요청합니다. 애플리케이션은 기존 탐색 분석 및 보기를 기반으로 해야 하지만 기술 식별자를 사용할 필요는 없습니다. 예를 들면 다음과 같습니다.

Build a responsive Looker Data App using the faa model and the
large\_flight\_data explore. I want this to be a dynamic, dark-themed operations
center.

Please include the following components:

The Map (Centerpiece): Create a custom visual that visualizes flights moving
from their Origin to Destination. Include a timeline slider (or playback
animation) based on Departure Time and Arrival Time so I can watch the flights
move over time.

KPI Strip: Across the top, include a row of KPI cards showing the total flight
Count, average Delay Mins, total Total Revenue, and average Load Factor.

Trend Chart: Include a line chart showing how Carbon Emissions and Total Revenue change over
the Departure Date periods.

Interactive Filters: Include drop-down filters for Airline, Status, and Origin
that wire into the charts and map to update the data dynamically.

AI 에이전트가 LookML Explore를 검사하고, 구성요소 정의를 작성하고, 로컬 미리보기 서버를 시작합니다.

3단계: 로컬 미리보기 검사

에이전트에서 제공하는 로컬 미리보기 URL (http://localhost:8765)을 엽니다.

터미널에서 make start (또는 python3 skills/data-app-previewer/tools/start-preview.py)를 실행하여 만든 모든 로컬 앱의 갤러리를 볼 수도 있습니다.

4단계: 앱을 반복적으로 개선하기

AI 에이전트와 대화하여 레이아웃, 스타일, 상호작용을 미세 조정합니다.

'캔버스 오른쪽으로 3개의 측정항목 카드를 정렬해 줘.'
'추세 차트 위에 기간 슬라이더를 추가해 줘'
"배경을 미묘한 중립 회색으로 바꾸고 부드러운 그림자가 있는 둥근 카드를 추가해 줘."

5단계: Looker에 데이터 앱 게시

디자인이 만족스러우면 에이전트에게 앱을 배포하라고 프롬프트를 표시합니다.

Publish this app to Looker.

에이전트는 구성된 폴더에서 구성요소 스크립트를 패키징하고 대시보드 객체를 만들거나 업데이트하는 게시 스크립트를 실행합니다.

6단계: Looker에서 데이터 앱 보기

에이전트가 반환한 Looker 링크를 클릭합니다. 데이터 앱은 사용자 액세스 필터, 폴더 공유, 플랫폼 기능을 완벽하게 지원하여 Looker 내에서 로드됩니다.

시도해 볼 만한 사항

미리보기 중에 Looker 데이터 앱의 기능을 탐색하려면 다음 시나리오를 시도해 보세요.

이미지에서 기존 보고서 복제

다른 BI 도구 (예: Tableau 또는 Power BI)의 기존 보고서 또는 슬라이드 자료의 스크린샷을 AI 에이전트에 업로드합니다. 에이전트에 프롬프트를 입력합니다.

Replicate the layout, visual hierarchy, and color scheme shown in this
screenshot, binding the charts to our customer_analytics explore.

멀티모달 AI 에이전트는 이미지에서 좌표 기하학, 서체, 색상 팔레트를 추출하여 일치하는 데이터 앱 레이아웃을 생성할 수 있습니다.

맞춤 레이아웃 디자인

비대칭 레이아웃을 만들어 표준 직사각형 그리드를 넘어설 수 있습니다.

히어로 배너와 부분적으로 겹치는 플로팅 KPI 카드를 만듭니다.
넓은 데이터 그리드 옆에 다중 열 핵심 요약 사이드바를 추가합니다.
맞춤 기업 브랜딩, 글꼴 스타일, 배경 그라데이션을 적용합니다.

풍부한 대화형 UI 구성요소 통합

에이전트에게 대화형 웹 요소를 추가해 달라고 요청합니다.

탭 탐색: 페이지를 새로고침하지 않고 여러 탭에서 복잡한 운영 측정항목을 정리합니다.
모달 대화상자 및 드로어: 측정항목을 클릭하면 세부 분류 보기 또는 용어집 정의가 열립니다.
대화형 필터 및 컨트롤: 차트 계열을 동적으로 업데이트하는 맞춤 전환 버튼, 슬라이더, 검색 입력란을 추가합니다.

고급 데이터 표 및 시각화 사용

내장 구성요소 라이브러리를 활용하세요.

AG Grid 통합: 열 정렬, 열 크기 조절, 셀 서식 지정을 지원하는 대화형 데이터 표를 삽입합니다.
고급 Highcharts 유형: 표준 대시보드 타일에서 지원하지 않는 게이지, 히트맵, 트리맵, 생키 다이어그램을 생성합니다.

Looker 플랫폼 기능 테스트

데이터 앱이 Looker 워크플로와 통합되는지 확인합니다.

교차 필터링: 하나의 차트에서 카테고리를 선택하면 나머지 시각화가 필터링되도록 차트를 구성합니다.
PDF 내보내기: 전체 대시보드를 PDF로 다운로드합니다.
예약된 전송: 데이터 앱의 PDF 스냅샷을 이메일로 팀에 전송하는 자동 일정을 설정합니다.