GoodData Cloud에 앱을 연결해 Lovable 앱에서 워크스페이스, 지표, 시각화를 탐색하고 분석 쿼리를 실행합니다.

GoodData에 앱 연결하기

GoodData Cloud에 앱을 연결해 Lovable 앱에서 워크스페이스, 지표, 시각화를 탐색하고 분석 쿼리를 실행하세요.

GoodData는 비즈니스 인텔리전스(BI) 및 분석 플랫폼입니다. GoodData는 시맨틱 레이어(semantic layer)를 중심으로 구성되는데, 시맨틱 레이어란 대시보드와 보고서가 함께 재사용하는 공유 지표 정의 모음을 말합니다. GoodData 커넥터를 사용하면 Lovable 앱이 GoodData Cloud 조직의 워크스페이스, 지표, 속성, 저장된 시각화를 탐색하고 이를 바탕으로 보고서 데이터를 계산할 수 있습니다. 이 커넥터는 GoodData의 관리형 분석 제품인 GoodData Cloud와 함께 작동합니다.

GoodData는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.

GoodData를 연결하면 앱에서 다음 작업을 할 수 있습니다.

GoodData Cloud 조직의 워크스페이스 목록 조회
각 워크스페이스의 시맨틱 모델을 구성하는 요소인 지표, 속성, 팩트(fact) 탐색
저장된 시각화와 분석 대시보드 찾기
팀이 이미 정의한 지표와 그룹화 기준으로 보고서 데이터 계산

계산 로직을 앱에서 다시 만드는 대신, 팀이 GoodData 시맨틱 레이어에서 이미 관리하는 지표가 앱에 필요할 때 GoodData를 사용하세요.

주요 활용 사례 및 예시 앱

다음 예시는 GoodData로 만들 수 있는 앱과 시작할 때 사용할 수 있는 프롬프트를 보여 줍니다.

예시 앱	프롬프트 예시	설명
경영진 대시보드	GoodData를 사용해서 우리 지표에서 월별 매출과 활성 계정 수를 보여 주는 대시보드를 만들어줘.	팀이 이미 신뢰하는 수치를 보여 줍니다. 앱이 해당 지표를 월별로 계산하고 차트와 타일로 렌더링합니다.
지표 탐색기	GoodData를 사용해서 워크스페이스를 고른 다음 그룹화할 지표와 속성을 선택할 수 있는 탐색기를 만들어줘.	연결이 접근할 수 있는 데이터를 팀이 둘러볼 수 있게 합니다. 앱이 워크스페이스와 각 워크스페이스의 지표를 나열하고, 이를 바탕으로 필드 선택기를 만듭니다.
지역별 성과표	GoodData를 사용해서 지역별 매출 순위를 매기고 목표에 못 미치는 지역을 표시하는 성과표를 만들어줘.	세그먼트별 성과를 비교합니다. 앱이 매출 지표를 지역별로 그룹화하고 결과를 정렬합니다.
주간 지표 요약	GoodData를 사용해서 이번 주 핵심 지표를 지난주와 비교하는 주간 요약 페이지를 만들어줘.	시간에 따른 변화를 추적합니다. 앱이 두 기간에 대해 같은 지표를 계산하고 차이를 보여 줍니다.
고객 지표 페이지	GoodData를 사용해서 각 고객 계정에 우리 워크스페이스의 자기 사용량 수치를 보여 주는 고객용 페이지를 만들어줘.	고객에게 각자의 데이터를 보여 줍니다. 앱이 로그인한 계정을 기준으로 각 계산을 필터링합니다. 모든 요청은 같은 GoodData 사용자로 실행되므로, 각 고객이 자기 행만 보도록 제한하는 일은 GoodData가 아니라 앱이 맡아야 합니다.
지표 질문 앱	GoodData를 사용해서 팀원이 "지난 분기 서부 지역 매출은 얼마였어?" 같은 질문을 하면 우리 지표에서 답을 찾아 주는 앱을 만들어줘.	지표에 관한 질문에 일상 언어로 답합니다. 앱이 각 질문을 알맞은 지표, 속성, 필터를 사용하는 계산으로 변환합니다.

GoodData 연결하기

GoodData 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이며, 관리자가 Connectors → Admin settings → App + chat connectors에서 변경해야 사용할 수 있습니다.

서로 다른 조직이나 API 토큰으로 GoodData 연결을 여러 개 만들 수 있습니다. 환경을 분리하거나 프로젝트마다 접근 수준을 다르게 주려 할 때 유용합니다.

연결을 만든 뒤에는 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자기 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.

사전 준비

GoodData를 연결하기 전에 다음을 갖추었는지 확인하세요.

GoodData Cloud URL(예: https://<org>.cloud.gooddata.com)로 접속할 수 있는 GoodData Cloud 조직
GoodData API 토큰(만드는 위치는 Step 1에서 안내합니다). 기본적으로 API 토큰은 GoodData 관리자만 만들 수 있습니다. 다른 사용자가 토큰을 만들게 하려면 GoodData 관리자가 해당 사용자에게 SELF_CREATE_TOKEN 조직 권한을 부여해야 합니다
Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)

이 커넥터를 통한 보고서 계산은 GoodData Cloud 조직에서 실행되며 해당 조직의 리소스를 사용합니다. 요금과 할당량은 Lovable이 아니라 GoodData가 직접 관리합니다.

Step 1: GoodData API 토큰 만들기

커넥터는 GoodData API 토큰으로 인증합니다. 토큰은 토큰을 소유한 GoodData 사용자로 동작하며 그 사용자가 볼 수 있는 모든 것을 볼 수 있습니다. 따라서 해당 사용자에게는 앱이 읽는 워크스페이스에 대한 VIEW 권한만 주세요. API로 시맨틱 모델을 탐색하고 보고서를 계산하는 데는 VIEW 권한이면 충분합니다.

GoodData API 토큰을 만드는 방법은 다음과 같습니다.

GoodData Cloud에 로그인하기

GoodData Cloud URL(예: https://<org>.cloud.gooddata.com)에서 GoodData Cloud 조직에 로그인합니다.

Personal access tokens 열기

GoodData Cloud 홈페이지에서 Settings로 이동합니다. Developer 섹션의 Personal access tokens 옆에 있는 Manage를 클릭합니다.

토큰 만들기

+ Create를 클릭하고 Lovable처럼 알아보기 쉬운 토큰 이름을 입력한 다음 Create를 클릭합니다.

토큰 복사하기

토큰을 복사합니다.

API 토큰은 비밀번호처럼 작동합니다. 안전하게 보관하고 Lovable의 연결 양식에만 붙여넣으세요. 프롬프트, 채팅 메시지, 앱 코드에는 넣지 마세요. GoodData 관리자가 소유한 토큰을 사용하면 앱이 그 관리자가 볼 수 있는 모든 GoodData 워크스페이스의 데이터를 읽을 수 있습니다.

자세한 내용은 GoodData 문서의 Create an API access token을 참고하세요.

Step 2: GoodData를 Lovable에 연결하기

연결 양식을 열고 Step 1에서 얻은 값을 입력합니다.

Connectors에서 GoodData 열기

Connectors를 열고 GoodData를 선택합니다. 카탈로그를 여는 다른 방법은 커넥터를 찾는 위치를 참고하세요.

연결 추가하기

Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 Details, Configure connection, Sharing의 접을 수 있는 섹션으로 나뉩니다.

연결 이름 지정하기

Details에서 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 변경할 수 있습니다. 이름은 Lovable 안에서 연결을 구분하는 용도로만 쓰입니다.

연결 구성하기

Configure connection에 다음 값을 입력합니다.

GoodData Cloud URL: GoodData Cloud 조직의 https URL입니다. 예를 들면 https://yourorg.cloud.gooddata.com입니다. 브라우저의 전체 주소를 붙여넣어도 되며, Lovable은 조직 URL만 남깁니다.
API token: Step 1에서 만든 토큰입니다.

이 연결을 사용할 수 있는 사람 선택하기

Sharing에서 연결은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 연결을 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나, Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.

접근 권한이 있는 모든 사람은 토큰 소유자인 GoodData 사용자로 GoodData를 조회합니다. 자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.

연결하기

Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 GoodData Cloud 조직을 대상으로 API 토큰을 검증합니다.

연결이 완료되면 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자기 프로젝트를 GoodData에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한 기준). 그러면 Lovable 앱에서 워크스페이스를 탐색하고 지표를 바탕으로 보고서를 계산할 수 있습니다.

프로젝트 채팅에서 Lovable은 승인을 요청하지 않고 워크스페이스, 지표, 시각화를 읽고 보고서를 계산합니다. Lovable은 커넥터 게이트웨이를 거쳐 GoodData를 호출하며, 게이트웨이는 이러한 읽기 요청과 보고서 계산만 전달합니다. 토큰 소유자인 사용자에게 GoodData에서 해당 권한이 있더라도, 연결을 통해 GoodData 객체를 만들거나 변경하거나 삭제할 수는 없습니다.

API 토큰이 바뀌면 Lovable에서 연결을 열고 Configure connection 아래의 Update를 클릭해 토큰을 교체하세요.

제한 사항

GoodData 커넥터로는 다음 작업을 할 수 없습니다.

GoodData의 이전 제품인 GoodData Platform에 연결하기. 이 커넥터는 GoodData Cloud 조직과 함께 작동합니다.
앱에 GoodData 대시보드나 시각화를 임베드하기. 앱은 보고서 데이터를 계산한 뒤 자체 컴포넌트로 렌더링합니다. 보는 사람마다 로그인하는 GoodData 대시보드를 임베드하려면 조직 URL과 함께 GoodData 자체 임베딩 기능을 사용하세요.
최종 사용자별 GoodData 로그인 지원하기. 각 연결은 해당 연결에 링크된 모든 프로젝트가 공유하는 단일 API 토큰을 나타냅니다.

GoodData 연결 관리

연결은 Connectors에서 관리합니다. GoodData 커넥터를 선택한 다음 연결을 여세요.

Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 GoodData 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 자격 증명이 제거되고, GoodData를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.