서버리스 Postgres 플랫폼 Neon에 앱을 연결해 Lovable 앱에서 자체 Neon 데이터베이스를 읽고 씁니다.

Neon에 앱 연결하기

서버리스 Postgres 플랫폼 Neon에 앱을 연결해 Lovable 앱에서 자체 Neon 데이터베이스를 읽고 쓰세요.

Neon은 데이터베이스 브랜칭(branching)과 트래픽에 맞춰 확장되는 컴퓨트를 제공하는 서버리스 Postgres 플랫폼입니다. Neon 커넥터를 사용하면 Lovable 앱이 Lovable의 커넥터 게이트웨이를 거쳐 자체 Neon 데이터베이스에 SQL을 실행할 수 있습니다. 따라서 이미 Neon에 보관 중인 데이터를 바탕으로 관리자 페이지, 대시보드, 양식을 만들 수 있습니다. 데이터가 이미 Neon에 있거나 브랜칭 같은 Neon 기능이 필요할 때 사용하세요. Lovable은 기존 데이터베이스가 없고 Neon을 요청하지도 않은 경우에만 Lovable Cloud를 제안합니다.

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

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

매개변수화된 SQL 쿼리로 테이블의 행 읽기
서버 측 코드에서 행 삽입, 업데이트, 삭제
한 번의 요청에서 여러 구문을 하나의 트랜잭션으로 실행

커넥터는 연결 문자열에 지정된 데이터베이스에만 접근합니다. 또한 Lovable은 기능을 빌드하기 전에 프로젝트 채팅에서 테이블과 열 이름을 읽을 수 있습니다.

주요 활용 사례 및 예시 앱

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

예시 앱	프롬프트 예시	설명
주문 관리 페이지	Neon을 사용해서 내 `orders` 테이블의 최신 주문을 검색과 페이지네이션 기능과 함께 나열하는 관리자 페이지를 만들어줘.	SQL 클라이언트를 열지 않고 운영 주문을 둘러봅니다. 앱이 Neon 데이터베이스에 페이지 단위 쿼리를 실행하고 결과 행을 표로 렌더링합니다.
피드백 양식	Neon을 사용해서 이름, 이메일, 메시지를 내 `feedback` 테이블에 저장하는 피드백 양식을 만들어줘.	제출 내용을 자체 Postgres 테이블에 바로 모읍니다. 앱이 서버 측 코드에서 양식 값을 매개변수로 전달해 각 제출 내용을 삽입합니다.
고객 포털	Neon을 사용해서 로그인한 고객이 내 `invoices` 테이블에서 자기 청구서를 볼 수 있는 포털을 만들어줘.	고객마다 자기 레코드만 보여 줍니다. 모든 쿼리가 같은 Neon 역할로 실행되므로, 각 고객이 자기 청구서만 보도록 제한하는 일은 앱이 맡아야 합니다.
보고 대시보드	Neon을 사용해서 내 Neon 데이터베이스에서 집계한 월별 매출과 가입자 수를 보여 주는 대시보드를 만들어줘.	테이블을 차트로 바꿉니다. 앱이 집계 쿼리를 실행하고, 요청할 때마다 새로 고쳐지는 차트로 합계를 렌더링합니다.
재고 관리 도구	Neon을 사용해서 직원이 내 `products` 테이블의 재고 수준을 조정할 수 있는 재고 관리 도구를 만들어줘.	양식으로 행을 업데이트하고 감사 기록을 남깁니다. 앱이 재고 변경 내용과 감사 기록 행을 하나의 트랜잭션으로 씁니다.
데이터 탐색기	Neon을 사용해서 내 테이블 목록을 보여 주고 각 테이블의 처음 몇 행을 미리 보여 주는 읽기 전용 탐색기를 만들어줘.	데이터베이스에 무엇이 있는지 확인합니다. 앱이 데이터베이스에서 테이블 목록을 읽고, 행 수를 제한해 각 테이블을 미리 보여 줍니다.

Neon 연결의 작동 방식

Neon 연결 하나는 연결 문자열 하나이며, Lovable이 이 연결을 바탕으로 빌드하는 모든 것은 연결 문자열에 지정된 역할(role)로 실행됩니다.

연결 문자열: 연결 문자열은 브랜치 컴퓨트 하나, 데이터베이스 하나, 역할 하나를 지정합니다. Lovable은 연결 문자열을 연결에 저장하고 쿼리마다 Neon으로 함께 보냅니다. 연결 문자열은 브라우저나 앱 코드에 전달되지 않습니다.
게이트웨이: 앱이 Lovable의 커넥터 게이트웨이로 SQL을 보내면, 게이트웨이가 연결 문자열을 붙여 Neon으로 전달합니다. 토큰 처리 방식과 프로젝트별 요청 한도는 게이트웨이 기반 커넥터를 참고하세요.
데이터 접근: 연결은 해당 역할이 할 수 있는 모든 작업을 할 수 있습니다. Neon이 프로젝트를 만들 때 함께 생성하는 기본 역할은 폭넓은 관리자 권한을 가진 Neon 역할인 neon_superuser의 멤버입니다. Neon Console에서 만든 역할도 마찬가지로 이 역할의 멤버입니다. 이러한 역할을 사용하는 연결은 데이터베이스의 모든 테이블을 읽고 변경할 수 있습니다.

전용 역할을 사용하세요. SQL로 만든 역할은 기본 권한만 가진 상태로 시작합니다. 따라서 읽기 전용 앱이라면 이렇게 역할을 하나 만들고 앱에 필요한 권한만 부여하세요. 아래 SQL은 프로젝트 채팅이 아니라 Neon SQL Editor나 다른 Postgres 클라이언트에서 실행하세요. 프로젝트 채팅에서 실행하면 비밀번호가 채팅 기록에 남습니다. 그런 다음 아래 Step 1에서 이 역할의 연결 문자열을 복사합니다. 대화상자에 비밀번호 대신 자리표시자가 표시되면, 직접 정한 비밀번호를 연결 문자열에 입력하세요. Neon은 강력한 비밀번호를 요구합니다.

create role app_reader with login password '<strong password>';
grant usage on schema public to app_reader;
grant select on all tables in schema public to app_reader;
alter default privileges in schema public grant select on tables to app_reader;

프로젝트 채팅에서 Lovable은 읽기 전용 쿼리를 포함해 SQL 쿼리를 실행하기 전마다 승인을 요청합니다. 커넥터는 데이터를 읽는 쿼리와 데이터를 변경하는 쿼리를 구분하지 못하기 때문입니다. Always allow를 선택하면 Lovable은 이후 그 연결에서 실행하는 모든 쿼리를 묻지 않고 실행할 수 있습니다. 여기에는 데이터를 변경하거나 삭제하는 쿼리도 포함됩니다. 프로젝트 채팅에서 커넥터 작업 승인하기를 참고하세요. 게시된 앱은 승인을 요청하지 않습니다.

Neon 연결하기

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

서로 다른 연결 문자열로 Neon 연결을 여러 개 만들 수 있습니다. 프로덕션 브랜치와 미리보기 브랜치처럼 브랜치를 분리하거나, 권한이 다른 역할을 나눠 쓸 때 유용합니다. 프로덕션 프로젝트는 프로덕션 브랜치용 연결에만 링크하세요.

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

사전 준비

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

Neon 계정과 데이터베이스가 하나 이상 있는 프로젝트
앱이 사용할 브랜치, 데이터베이스, 역할의 연결 문자열
Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)

이 커넥터를 통한 모든 쿼리는 Neon 컴퓨트에서 실행되며 Neon 플랜 사용량에 포함됩니다. 요금과 할당량은 Lovable이 아니라 Neon이 직접 관리합니다.

Step 1: Neon 연결 문자열 가져오기

연결 문자열은 앱이 사용하는 브랜치 컴퓨트, 데이터베이스, 역할을 Lovable에 알려 주며, 역할의 비밀번호도 포함합니다.

연결 문자열을 복사하는 방법은 다음과 같습니다.

Neon 프로젝트 열기

Neon Console에 로그인하고 연결할 프로젝트를 엽니다.

Connect 대화상자 열기

Connect를 클릭합니다. Connect to your branch 대화상자가 열립니다.

브랜치, 데이터베이스, 역할 선택하기

앱이 사용할 브랜치, 컴퓨트, 데이터베이스, 역할을 선택합니다. 직접 연결이 필요한 경우가 아니라면 Connection pooling은 켜 둡니다. 두 형식 모두 Lovable에서 사용할 수 있습니다.

연결 문자열 복사하기

postgresql://로 시작하는 일반 연결 문자열을 복사합니다. 프레임워크용 코드 조각, psql 명령, .env 줄은 복사하지 마세요.

연결 문자열에는 역할의 비밀번호가 들어 있으므로 비밀번호처럼 작동합니다. 안전하게 보관하고 Lovable의 연결 양식에만 붙여넣으세요. 프롬프트, 채팅 메시지, 앱 코드에는 넣지 마세요.

자세한 내용은 Neon 문서의 Connect from any application을 참고하세요.

Step 2: Neon을 Lovable에 연결하기

Lovable은 연결 문자열을 연결에 저장하며, 저장하기 전에 연결 문자열을 검증합니다.

Connectors에서 Neon 열기

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

연결 추가하기

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

연결 이름 지정하기

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

연결 구성하기

Configure connection에서 Neon에서 복사한 연결 문자열을 따옴표나 접두사 없이 하나의 postgresql:// URL 형태로 Connection string에 붙여넣습니다. Neon이 생성한 비밀번호는 그대로 사용하면 됩니다. 비밀번호나 데이터베이스 이름에 @, #, /, ? 같은 문자가 있으면 각 문자를 퍼센트 인코딩하세요. 예를 들어 @는 %40이 됩니다. 필드 옆의 Get value를 클릭하면 Neon의 연결 가이드가 열립니다.

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

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

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

연결하기

Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Neon 데이터베이스에 select 1 쿼리를 실행해 연결 문자열을 검증합니다.

연결이 완료되면 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자기 프로젝트를 Neon에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한 기준). 그러면 Lovable 앱이 커넥터 게이트웨이를 거쳐 Neon 데이터베이스를 읽고 쓸 수 있습니다.

제한 사항

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

Neon 계정 관리하기. 커넥터는 연결된 데이터베이스에 SQL을 실행할 뿐이며, 프로젝트, 브랜치, 컴퓨트를 만들거나 나열하지 않습니다. 이러한 작업은 Neon Console에서 하세요.
연결된 역할 자체의 권한을 넘어 쿼리가 할 수 있는 일을 제한하기. 연결을 사용하는 모든 사람은 그 역할로 쿼리를 실행합니다.
최종 사용자별 Neon 로그인 지원하기. 각 연결은 해당 연결에 링크된 모든 프로젝트가 공유하는 단일 Neon 데이터베이스와 역할을 나타냅니다.
한 요청에서 64MB가 넘는 데이터 주고받기. Neon이 요청과 응답 각각에 이 한도를 적용합니다.

문제 해결

연결에 실패하거나 쿼리가 예상치 못한 오류를 반환하면 다음 항목을 확인하세요.

Neon 연결 관리

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

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