IBM Db2에 앱 연결하기
IBM Db2 on Cloud에 앱을 연결해 Lovable 앱에서 스키마와 테이블을 둘러보고 SQL 쿼리를 실행하세요.
IBM Db2는 IBM의 관계형 데이터베이스로, IBM Cloud에서 관리형 서비스로 제공됩니다. IBM Db2 커넥터를 사용하면 Lovable 앱이 Db2 on Cloud 인스턴스의 스키마와 테이블을 둘러보고 SQL 쿼리를 실행할 수 있습니다.
IBM Db2는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
IBM Db2를 사용하면 앱에서 다음과 같은 작업이 가능합니다.
- 연결된 데이터베이스 사용자가 볼 수 있는 스키마, 테이블, 열 둘러보기
- SQL 쿼리를 실행하고 결과를 앱에 표시하기
- 큰 쿼리 결과를 CSV로 내보내기
팀이 이미 IBM Cloud에서 운영하는 Db2 데이터베이스의 실시간 데이터가 앱에 필요할 때 IBM Db2를 사용하세요.
주요 활용 사례 및 예시 앱
다음 예시는 IBM Db2로 만들 수 있는 앱과 각 앱을 시작할 때 쓸 프롬프트를 보여 줍니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 영업 대시보드 | IBM Db2를 사용해서 지역별, 제품군별 월 매출을 보여 주는 대시보드를 만들어줘. | Db2 데이터를 차트와 타일로 확인합니다. 앱이 알맞은 테이블을 찾아 화면마다 쿼리합니다. |
| 테이블 브라우저 | IBM Db2를 사용해서 데이터베이스 테이블 목록을 보여 주고 내용을 미리 볼 수 있는 내부용 앱을 만들어줘. | SQL을 작성하지 않고 데이터베이스를 둘러봅니다. 앱이 스키마와 테이블 목록을 보여 주고 사용자가 고른 테이블을 미리 보여 줍니다. |
| 고객 조회 | IBM Db2를 사용해서 상담원이 이름이나 이메일로 고객을 검색하고 주문 내역을 볼 수 있는 지원 도구를 만들어줘. | 레코드 하나를 필요한 사람 앞에 바로 보여 줍니다. 앱이 고객 테이블과 주문 테이블을 쿼리해 하나의 프로필 화면으로 보여 줍니다. |
| 재고 모니터 | IBM Db2를 사용해서 재고가 재주문 기준치 아래로 떨어진 제품을 표시하는 페이지를 만들어줘. | 판매 기회를 놓치기 전에 재고 부족을 잡아냅니다. 앱이 재고 수준을 기준치와 비교해 조치가 필요한 제품을 강조 표시합니다. |
| 리포트 포털 | IBM Db2를 사용해서 관리자가 분기를 고르면 수주액, 청구액, 수주 잔고를 볼 수 있는 포털을 만들어줘. | 반복되는 리포트를 셀프서비스 페이지로 바꿉니다. 앱이 사용자가 고른 분기에 대해 기반 쿼리를 실행합니다. |
| 데이터 품질 검사기 | IBM Db2를 사용해서 연락처 테이블에서 값이 비어 있거나 중복된 행을 보여 주는 페이지를 만들어줘. | 잘못된 행이 퍼지기 전에 찾아냅니다. 앱이 검증 쿼리를 실행해 문제가 있는 행을 나열합니다. |
IBM Db2 연결 방법
IBM Db2 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이기 때문입니다.
서로 다른 인스턴스나 데이터베이스 사용자로 IBM Db2 연결을 여러 개 만들 수 있습니다. 환경을 분리하거나, 각 앱이 해당 데이터베이스 사용자가 볼 수 있는 데이터만 쓰도록 제한할 때 유용합니다.
연결이 만들어지면 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 요구사항
IBM Db2를 연결하기 전에 다음을 준비하세요.
- IBM Cloud 계정의 Db2 on Cloud 인스턴스
- 해당 인스턴스의 데이터베이스 userid와 비밀번호(찾는 위치는 1단계에서 설명합니다)
- Lovable 워크스페이스에서 연결을 만들 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 쿼리는 Db2 인스턴스에서 실행되며 인스턴스의 컴퓨팅 자원을 사용합니다. 청구는 Lovable이 아닌 IBM Cloud에서 직접 처리합니다.
1단계: Db2 엔드포인트와 자격 증명 가져오기
커넥터는 데이터베이스 userid와 비밀번호로 로그인하며, 인스턴스의 REST API 엔드포인트가 필요합니다. 쿼리는 해당 사용자의 데이터베이스 권한으로 실행됩니다.
연결 정보는 다음 순서로 수집합니다.
IBM Cloud에서 인스턴스 열기
IBM Cloud에 로그인해 Resource list를 열고 Db2 인스턴스를 선택합니다.
데이터베이스 자격 증명 만들기
인스턴스의 Service credentials 탭을 열고 New credential을 클릭합니다. 자격 증명 JSON에는 데이터베이스용 username과 password가 들어 있습니다. 2단계에서 username 값을 Userid 필드에 입력합니다.
배포 CRN 복사
인스턴스 패널에 crn:v1:bluemix:로 시작하는 긴 식별자인 Cloud Resource Name(CRN)이 표시됩니다. 연결 양식에서 이 값을 요청하므로 복사해 둡니다.
REST API 엔드포인트 확인
엔드포인트는 리전별로 다르며 https://<region>.db2.saas.ibm.com 형식입니다. 여기서 <region>은 인스턴스가 있는 리전이며, 예를 들어 us-south입니다.
서비스 자격 증명에는 관리자 권한이 있습니다. 이 자격 증명을 사용하는 앱은 데이터베이스의 데이터를 변경하거나 삭제할 수 있습니다. 대부분의 앱에서는 Db2 콘솔에서 읽기 전용 데이터베이스 사용자를 만들고(IBM 문서 Managing users 참고) 그 사용자의 userid와 비밀번호를 사용하세요.
비밀번호는 안전하게 보관하세요. Lovable의 연결 양식에만 입력하고, 프롬프트나 채팅 메시지, 앱 코드에는 넣지 마세요.
자세한 내용은 IBM 문서 Database details and connection credentials를 참고하세요.
2단계: IBM Db2를 Lovable에 연결
연결 양식을 열고 1단계에서 확인한 값을 입력합니다.
Connectors에서 IBM Db2 열기
Connectors를 열고 IBM Db2를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 접을 수 있는 Details, Configure connection, Sharing 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다. 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다.
연결 구성
Configure connection 아래에 다음 값을 입력합니다.
- REST API endpoint: 1단계에서 확인한 https 엔드포인트입니다. 예를 들어
https://us-south.db2.saas.ibm.com입니다. - Deployment CRN: 1단계에서 복사한 CRN입니다. 양식에는 선택 필드로 표시되지만 Db2 on Cloud에는 필요합니다.
- Userid: 1단계에서 확인한 데이터베이스 userid입니다.
- Password: userid와 함께 발급된 비밀번호입니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Db2 인스턴스에서 자격 증명을 확인합니다.
연결되면 프로젝트에서 빌드하는 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 IBM Db2에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한에 따라). 그러면 Lovable 앱이 스키마를 둘러보고 데이터에 SQL을 실행할 수 있습니다.
프로젝트 채팅에서 Lovable은 읽기 전용 쿼리를 포함해 SQL 쿼리를 실행할 때마다 먼저 승인을 요청합니다. 커넥터는 데이터를 읽는 쿼리와 데이터를 변경하는 쿼리를 구분하지 못하기 때문입니다. Always allow를 선택하면 Lovable은 이후 해당 연결의 모든 쿼리를 묻지 않고 실행할 수 있습니다. 여기에는 데이터를 변경하거나 삭제하는 쿼리도 포함됩니다. 프로젝트 채팅에서 커넥터 작업 승인하기를 참고하세요. 게시된 앱은 승인을 요청하지 않습니다.
데이터베이스 비밀번호가 바뀌면 연결을 열고 Configure connection 아래에 새 Password를 입력한 다음 Update를 클릭합니다. Lovable은 저장하기 전에 Db2 인스턴스에서 새 비밀번호를 확인합니다.
쿼리 결과 다루기
각 쿼리는 Lovable이 정한 행 수 한도까지만 결과를 반환합니다. 쿼리 결과가 한도보다 많으면 Lovable이 앱에 작성한 코드는 불완전한 데이터를 보여 주는 대신 오류를 내고 중단합니다. 많은 행을 보여 주는 페이지가 필요하면 테이블 전체를 불러오지 말고 페이지네이션이나 필터링을 적용해 달라고 Lovable에게 요청하세요. 더 큰 데이터를 추출하려면 결과를 CSV로 내보내 달라고 요청하세요. CSV 내보내기는 100,000행에서 중단될 수 있습니다.
제한 사항
IBM Db2 커넥터는 다음을 할 수 없습니다.
- 직접 운영하는 Db2 서버에 연결. 이 커넥터는 IBM Cloud의 관리형 Db2 인스턴스를 제공하는 IBM Db2 REST API를 사용합니다.
- 최종 사용자별 IBM Db2 로그인 지원. 각 연결은 연결에 링크된 모든 프로젝트가 공유하는 단일 데이터베이스 사용자를 나타냅니다.
IBM Db2 연결 관리
연결은 Connectors에서 관리합니다. **IBM Db2**를 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 사용할 수 있게 두고 특정 프로젝트의 IBM Db2 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 링크 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 링크된 모든 프로젝트에서 자격 증명이 제거되고, IBM Db2를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.