DuckDB용 클라우드 서비스인 MotherDuck에 앱을 연결해 SQL로 데이터를 쿼리하고 Lovable 앱에서 대시보드와 리포트를 만듭니다.

MotherDuck에 앱 연결하기

DuckDB용 클라우드 서비스인 MotherDuck에 앱을 연결해 SQL로 데이터를 쿼리하고 Lovable 앱에서 대시보드와 리포트를 만드세요.

MotherDuck은 분석용 SQL 데이터베이스인 DuckDB의 클라우드 서비스입니다. DuckDB 데이터베이스와 share를 호스팅하고, 그 위에서 DuckDB SQL을 실행합니다. share는 다른 MotherDuck 사용자가 나에게 공유한 읽기 전용 데이터베이스입니다. Parquet, CSV, JSON 같은 파일에서 MotherDuck으로 데이터를 불러올 수 있습니다. MotherDuck 커넥터를 사용하면 Lovable 앱이 이런 데이터베이스에 SQL을 실행하고, 테이블과 열을 살펴보고, 결과를 대시보드, 리포트, 데이터 도구로 바꿀 수 있습니다. 이미 MotherDuck에 보관하고 있는 데이터를 바탕으로 동작하는 앱에 맞게 설계되었습니다.

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

MotherDuck을 사용하면 앱에서 다음 작업을 할 수 있습니다.

MotherDuck 데이터베이스와 attach한 share에 DuckDB SQL 쿼리 실행
데이터베이스, 테이블, 뷰, 열을 나열해 Lovable이 실제 스키마 이름을 기준으로 빌드하도록 지원
키워드로 카탈로그에서 테이블과 열 검색
SQL로 데이터를 집계하는 대시보드와 리포트 빌드
명시적으로 요청했고 토큰이 쓰기를 허용하는 경우 행 삽입 또는 업데이트

데이터를 변경해 달라고 요청하지 않는 한, Lovable은 모든 쿼리를 읽기 전용으로 실행하라고 MotherDuck에 지시합니다. 그러면 MotherDuck은 데이터를 변경하려는 쿼리를 거부합니다.

프로젝트 채팅에서 Lovable은 읽기 전용 쿼리를 포함해 모든 SQL 쿼리를 실행하기 전에 승인을 요청합니다. 데이터베이스, 테이블, 열을 나열할 때는 승인을 요청하지 않습니다. Agent approval for this connection 설정은 본인과 해당 연결에 적용되며, Lovable이 계속 승인을 요청할지 결정합니다. 프로젝트 채팅에서 커넥터 작업 승인하기를 참고하세요. 게시된 앱은 승인을 요청하지 않으므로, Lovable은 데이터를 변경하는 기능을 앱의 로그인 뒤에 둡니다.

주요 활용 사례 및 예시 앱

다음 예시는 MotherDuck으로 만들 수 있는 앱과, 각 앱을 시작할 때 쓸 수 있는 프롬프트입니다.

예시 앱	프롬프트 예시	설명
매출 대시보드	MotherDuck을 사용해 orders 테이블에서 월별 매출과 주문 수를 보여 주는 대시보드를 만들어줘.	CSV로 내보내지 않고 매출 추세를 확인합니다. 앱이 SQL로 orders 테이블을 집계하고 월별 시계열을 차트로 렌더링합니다.
테이블 브라우저	MotherDuck을 사용해 내 데이터베이스의 테이블을 나열하고 각 테이블의 처음 몇 행을 미리 보여 주는 페이지를 만들어줘.	SQL 클라이언트를 열지 않고 데이터베이스를 살펴봅니다. 앱이 데이터베이스, 테이블, 열을 나열한 다음, 선택한 테이블에 대해 행 수를 제한한 미리보기 쿼리를 실행합니다.
고객 360 뷰	MotherDuck을 사용해 고객의 주문, 지출, 마지막 활동을 보여 주는 고객 조회 화면을 만들어줘.	고객 한 명의 이력을 한 화면에 모읍니다. 앱이 고객별로 필터링한 쿼리를 실행하고 결과를 카드와 표로 보여 줍니다.
Parquet 레이크 탐색기	MotherDuck을 사용해 MotherDuck에 불러온 Parquet 파일을 날짜와 지역으로 필터링할 수 있는 탐색기를 만들어줘.	레이크 파일을 테이블처럼 쿼리합니다. 앱이 불러온 데이터에 DuckDB SQL을 실행하고 필터를 쿼리 조건(predicate)으로 적용합니다.
데이터 품질 모니터	MotherDuck을 사용해 매일 밤 null 비율 검사와 중복 검사를 실행하고 실패한 항목을 표시하는 내부 도구를 만들어줘.	팀보다 먼저 잘못된 데이터를 잡아냅니다. 앱이 일정에 따라 검증 쿼리를 실행하고 결과를 저장하며 실패한 검사를 강조 표시합니다.
공유 데이터셋 뷰어	MotherDuck을 사용해 sample_data share 위에 검색창이 있는 읽기 전용 뷰어를 만들어줘.	공유된 데이터베이스의 일부를 게시합니다. 앱이 attach한 share를 쿼리하고 검색어와 일치하는 행을 반환합니다.

MotherDuck 연결 방법

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

서로 다른 액세스 토큰으로 MotherDuck 연결을 여러 개 만들 수 있습니다. 환경을 분리할 때 유용합니다(예: 게시된 대시보드에는 Read Scaling 토큰, 관리자 도구에는 Read/Write 토큰).

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

사전 요구 사항

MotherDuck을 연결하기 전에 다음을 준비하세요.

데이터베이스나 attach한 share가 하나 이상 있는 MotherDuck 계정
MotherDuck 액세스 토큰
Lovable 워크스페이스의 연결 생성 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)

이 커넥터를 통한 모든 쿼리는 MotherDuck 계정에서 실행되며 MotherDuck 플랜과 컴퓨팅 사용량에 포함됩니다. 청구는 Lovable이 아닌 MotherDuck이 직접 처리합니다.

1단계: MotherDuck 액세스 토큰 발급하기

MotherDuck 액세스 토큰은 Lovable 앱이 MotherDuck에 인증할 때 사용합니다. MotherDuck은 두 가지 토큰 유형을 제공하며, 유형에 따라 연결이 할 수 있는 작업이 정해집니다.

Read/Write 토큰은 데이터를 읽을 수 있고, 명시적으로 요청한 경우에는 데이터와 스키마를 변경할 수도 있습니다.
Read Scaling 토큰은 모든 쓰기를 거부하는 읽기 복제본(read replica)에 연결합니다. 대시보드를 비롯한 읽기 전용 앱에는 이 토큰을 선택하세요. Read Scaling 토큰으로 읽은 데이터는 최신 변경 사항보다 몇 분 늦을 수 있습니다. 이 토큰은 Read/Write 토큰으로 먼저 attach해 둔 데이터베이스와 share만 쿼리할 수 있습니다.

MotherDuck 액세스 토큰은 다음 순서로 만듭니다.

MotherDuck 계정 열기

MotherDuck에 로그인합니다.

Access Tokens 열기

조직 이름을 클릭하고 Settings를 선택한 다음 Access Tokens를 엽니다.

토큰 만들기

Create token을 클릭합니다. 알아보기 쉬운 이름(예: Lovable integration)을 지정하고, Read/Write 또는 Read Scaling을 선택한 뒤 토큰 만료 여부를 정합니다.

토큰 복사

토큰을 복사해 안전하게 보관합니다. MotherDuck은 토큰을 한 번만 보여 줍니다.

액세스 토큰은 비밀번호와 같은 역할을 합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.

자세한 내용은 MotherDuck 문서의 Authenticating to MotherDuck과 Read scaling을 참고하세요.

2단계: MotherDuck을 Lovable에 연결하기

연결 양식을 열고 1단계에서 만든 토큰을 입력합니다.

Connectors에서 MotherDuck 열기

Connectors를 열고 MotherDuck을 선택합니다. 카탈로그를 열 수 있는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.

연결 추가

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

연결 이름 지정

Details에서 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다. 이름은 Lovable 안에서 연결을 식별하는 데만 쓰입니다.

연결 구성

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

MotherDuck access token: 복사한 토큰을 붙여 넣습니다. 필드 옆의 Get value를 클릭하면 MotherDuck의 토큰 문서가 열립니다.

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

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

추가한 사람은 모두 토큰의 MotherDuck 사용자가 읽을 수 있는 모든 데이터베이스와 share를 쿼리할 수 있습니다.

자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.

연결

Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 데이터베이스 목록을 조회해 MotherDuck에서 토큰을 검증합니다.

연결되면 프로젝트에서 빌드하는 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 MotherDuck에 링크해 달라고 요청할 수 있습니다(구성된 연결 단위 접근 권한 기준). 그러면 Lovable 앱이 이 연결을 통해 MotherDuck 데이터베이스와 share를 쿼리할 수 있습니다.

쿼리 결과 다루기

MotherDuck은 쿼리 하나당 최대 2,000행 또는 50KB의 출력만 반환하며, 55초가 지나면 쿼리를 중단합니다. 쿼리 결과가 2,000행 또는 50KB를 넘으면 Lovable이 앱에 작성한 코드는 불완전한 데이터를 보여 주는 대신 오류를 내고 멈춥니다. Lovable은 작성하는 쿼리에 행 수 제한을 추가하고, 가능한 경우 SQL에서 집계합니다. 많은 행을 보여 주는 페이지가 필요하다면 테이블 전체를 불러오지 말고 페이지를 나누거나 필터링해 달라고 Lovable에게 요청하세요.

쿼리마다 MotherDuck 컴퓨팅을 사용합니다. 앱이 일정에 따라 또는 페이지를 볼 때마다 같은 데이터를 읽는다면 데이터가 얼마나 최신이어야 하는지 Lovable에게 알려 주세요. 그러면 Lovable이 그 시간 동안 결과를 캐시할 수 있습니다.

제한 사항

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

내 컴퓨터나 자체 서버에 있는 DuckDB 데이터베이스 파일 쿼리. MotherDuck에 호스팅된 데이터베이스와 share에만 접근할 수 있습니다. 먼저 파일을 MotherDuck으로 불러오세요.
다른 계정에서 attach한 share에 쓰기. share는 읽기 전용입니다.
최종 사용자별 MotherDuck 로그인 지원. 각 연결은 링크된 모든 프로젝트가 공유하는 단일 MotherDuck 계정을 나타냅니다.

토큰이 만료되었거나 MotherDuck에서 토큰을 취소한 경우처럼 토큰을 교체해야 할 때는 새 토큰을 만들고 Lovable에서 연결을 연 다음 Configure connection에서 Update를 클릭하세요.

MotherDuck 연결 관리

연결은 Connectors에서 관리합니다. **MotherDuck**을 선택한 다음 연결을 여세요.

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