Metabase에 앱 연결하기
Metabase에 앱을 연결해 팀의 저장된 질문과 커스텀 쿼리를 실행하고 그 결과를 Lovable 앱에 표시하세요.
Metabase는 데이터를 탐색하고 질문과 대시보드를 공유하는 오픈 소스 비즈니스 인텔리전스(BI) 도구입니다. Metabase 커넥터를 사용하면 Lovable 앱이 저장된 질문(saved question, 팀이 Metabase에 저장해 둔 쿼리와 차트)을 실행하고, Metabase에 연결된 데이터베이스를 둘러보고, 커스텀 쿼리를 실행할 수 있습니다. Metabase Cloud는 물론, 공용 인터넷에서 접근할 수 있는 셀프 호스팅 인스턴스에서도 작동합니다.
Metabase는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
Metabase를 사용하면 앱에서 다음과 같은 작업이 가능합니다.
- 저장된 질문을 실행하고 결과 표시하기(앱의 수치가 팀이 Metabase에서 관리하는 정의와 계속 일치합니다)
- Metabase에 연결된 데이터베이스, 테이블, 필드 둘러보기
- 연결된 데이터베이스를 대상으로 커스텀 SQL 쿼리 실행하기
- 인스턴스 전체에서 질문, 대시보드, 테이블 검색하기
데이터베이스마다 따로 연결하는 대신, 팀이 이미 Metabase에서 정리해 둔 질문과 데이터가 앱에 필요할 때 Metabase를 사용하세요.
주요 활용 사례 및 예시 앱
다음 예시는 Metabase로 만들 수 있는 앱과 각 앱을 시작할 때 쓸 프롬프트를 보여 줍니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 지표 대시보드 | Metabase를 사용해서 월 매출과 주문량을 보여 주는 대시보드를 만들어줘. | 팀이 이미 신뢰하는 숫자를 보여 줍니다. 앱이 해당하는 저장된 질문을 실행하고 결과를 차트와 타일로 렌더링합니다. |
| 저장된 질문 브라우저 | Metabase를 사용해서 저장된 질문 목록을 보여 주고 사람들이 직접 실행할 수 있는 내부용 앱을 만들어줘. | 팀 전체가 정리된 질문을 셀프서비스로 쓸 수 있게 합니다. 앱이 Metabase의 질문 목록을 보여 주고 사용자가 고른 질문을 실행합니다. |
| 영업 리포트 포털 | Metabase를 사용해서 어카운트 매니저가 지역별, 제품 카테고리별 매출을 볼 수 있는 포털을 만들어줘. | Metabase 리포트를 특정 용도의 내부 도구로 바꿉니다. 앱이 기반 데이터를 쿼리해 한 대상 그룹에 맞게 보여 줍니다. |
| 데이터 탐색기 | Metabase를 사용해서 데이터베이스와 테이블 목록을 보여 주고 내용을 미리 볼 수 있는 탐색기를 만들어줘. | Metabase가 이미 정리해 둔 데이터를 둘러봅니다. 앱이 Metabase의 데이터베이스 메타데이터를 읽고 미리보기 쿼리를 실행합니다. |
| 이상 징후 모니터 | Metabase를 사용해서 가입자 수가 전주 대비 20% 넘게 떨어진 날을 강조 표시하는 페이지를 만들어줘. | Metabase를 열지 않고 지표를 지켜봅니다. 누군가 페이지를 열면 앱이 쿼리를 실행하고 크게 떨어진 날을 표시합니다. |
| 경영진 요약 | Metabase를 사용해서 저장된 질문에서 핵심 지표 다섯 개를 가져오는 한 페이지 요약을 만들어줘. | 여러 질문을 한 화면에 요약합니다. 앱이 저장된 질문을 각각 실행하고 결과를 하나의 개요로 배치합니다. |
Metabase 연결 방법
Metabase 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이기 때문입니다.
서로 다른 인스턴스나 API 키로 Metabase 연결을 여러 개 만들 수 있습니다. 환경을 분리하거나 프로젝트마다 접근 수준을 다르게 줄 때 유용합니다.
연결이 만들어지면 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 요구사항
Metabase를 연결하기 전에 다음을 준비하세요.
- 버전 50 이상인 Metabase 인스턴스. Metabase Cloud와 셀프 호스팅 모두 가능하며, 공용 인터넷에서 HTTPS로 접근할 수 있어야 합니다
- 해당 인스턴스의 관리자 권한, 또는 API 키를 대신 만들어 줄 관리자
- Lovable 워크스페이스에서 연결을 만들 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
Metabase 플랜, 그리고 쿼리가 연결된 데이터베이스에서 사용하는 컴퓨팅 자원은 Lovable 청구와 별개입니다.
1단계: Metabase API 키 만들기
커넥터는 Metabase API 키로 인증합니다. 키는 키를 할당한 그룹의 권한과 All Users 그룹의 권한을 함께 받습니다.
커넥터는 읽기 전용 접근을 강제하지 않습니다. 키가 속한 그룹이 허용하면 연결을 통해 저장된 질문과 대시보드를 변경할 수 있습니다. Metabase가 쓰기 권한이 있는 사용자로 데이터베이스에 연결되어 있다면 SQL 쿼리로 데이터를 쓸 수도 있습니다. 키가 속한 그룹에는 앱에 필요한 접근 권한만 주고, Metabase는 읽기 전용 데이터베이스 사용자로 데이터베이스에 연결하세요.
Metabase API 키는 다음 순서로 만듭니다.
Metabase 관리자 설정 열기
관리자로 Metabase 인스턴스에 로그인합니다. 오른쪽 위의 격자 아이콘을 클릭하고 Admin을 선택합니다. 59 이전 버전의 Metabase에서는 톱니바퀴 아이콘을 클릭하고 Admin settings를 선택합니다.
접근이 제한된 그룹 만들기(권장)
People → Groups에서 Add a group을 클릭합니다. 그룹 이름을 정합니다(예: Lovable integration). 그런 다음 Permissions를 열고 그룹에 앱에 필요한 접근 권한만 줍니다.
- Collections: 앱이 실행하는 저장된 질문이 들어 있는 컬렉션에 View 권한을 줍니다.
- Data: 앱이 쿼리하는 데이터베이스의 Create queries를 Query builder only로 설정합니다. 앱이 SQL을 실행해야 하는 경우에만 Query builder and native를 선택하세요.
모든 API 키는 All Users 그룹에도 속하며 이 그룹의 접근 권한을 받습니다. 계속하기 전에 All Users가 무엇을 볼 수 있는지 확인하세요. 키를 Administrators 그룹에 할당하지 마세요. 이 그룹에 속한 키는 Metabase 전체에 대한 관리자 권한을 갖습니다.
키 만들기
Settings → Authentication으로 이동합니다. API Keys에서 Manage를 클릭한 다음 Create API Key를 클릭합니다. Key name을 입력하고(예: Lovable), Group에서 앞서 만든 그룹을 선택한 뒤 Create를 클릭합니다.
키 복사
mb_로 시작하는 키를 복사합니다. Metabase는 키를 한 번만 보여 줍니다.
API 키는 비밀번호처럼 작동합니다. 안전하게 보관하세요. Lovable의 연결 양식에만 붙여 넣고, 프롬프트나 채팅 메시지, 앱 코드에는 넣지 마세요.
자세한 내용은 Metabase 문서 API keys를 참고하세요.
2단계: Metabase를 Lovable에 연결
연결 양식을 열고 1단계에서 준비한 값을 입력합니다.
Connectors에서 Metabase 열기
Connectors를 열고 Metabase를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 접을 수 있는 Details, Configure connection, Sharing 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다. 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다.
연결 구성
Configure connection 아래에 다음 값을 입력합니다.
- Metabase URL: Metabase 인스턴스의 HTTPS URL입니다. 예를 들어
https://yourcompany.metabaseapp.com입니다. 셀프 호스팅 인스턴스가 경로 접두사 아래에서 제공된다면 접두사까지 포함합니다. 예를 들어https://analytics.example.com/metabase입니다. - API key: 1단계에서 만든
mb_로 시작하는 키입니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다. 접근 권한이 있는 모든 사람은 같은 API 키와 그 그룹의 권한으로 Metabase를 쿼리합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Metabase 인스턴스에서 API 키를 확인합니다.
연결에 성공했다고 데이터에 접근할 수 있다는 뜻은 아닙니다. 연결을 프로젝트에 링크한 뒤 Lovable에게 저장된 질문 하나를 실행해 달라고 요청해 보세요. 질문이 데이터를 반환하지 않으면 Metabase 관리자에게 그룹 권한을 확인해 달라고 요청하세요.
연결되면 프로젝트에서 빌드하는 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 Metabase에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한에 따라). 그러면 Lovable 앱이 Metabase를 통해 저장된 질문을 실행하고 데이터를 쿼리할 수 있습니다.
프로젝트 채팅에서 Lovable은 읽기 전용 쿼리를 포함해 저장된 질문이나 쿼리를 실행할 때마다 먼저 승인을 요청합니다. 데이터베이스 목록 조회와 Metabase 검색은 묻지 않고 실행합니다. Always allow를 선택하면 Lovable은 이후 해당 연결의 모든 요청을 묻지 않고 실행할 수 있습니다. 여기에는 저장된 질문, 대시보드, 데이터를 변경하는 요청도 포함됩니다. 프로젝트 채팅에서 커넥터 작업 승인하기를 참고하세요. 게시된 앱은 승인을 요청하지 않습니다.
API 키가 바뀌면 Lovable에서 연결을 열고 Configure connection 아래의 Update를 클릭해 키를 교체하세요.
제한 사항
Metabase 커넥터는 다음을 할 수 없습니다.
- Metabase 대시보드나 차트를 앱에 임베드. 앱은 질문과 쿼리를 실행하고 결과를 자체 컴포넌트로 렌더링합니다.
- 사설 네트워크의 인스턴스에 접근. Metabase URL은 공용 인터넷에서 HTTPS로 접근할 수 있어야 합니다.
- 최종 사용자별 Metabase 로그인 지원. 각 연결은 연결에 링크된 모든 프로젝트가 공유하는 단일 API 키를 나타냅니다.
Metabase 연결 관리
연결은 Connectors에서 관리합니다. **Metabase**를 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 사용할 수 있게 두고 특정 프로젝트의 Metabase 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 링크 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 링크된 모든 프로젝트에서 자격 증명이 제거되고, Metabase를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.