Oracle Autonomous AI Database에 앱 연결하기

Lovable 앱을 Oracle Autonomous AI Database에 연결해 SQL 쿼리를 실행하고, 스키마를 탐색하고, Oracle 데이터로 대시보드와 리포트를 만드세요.

Oracle Autonomous AI Database는 Oracle의 완전 자동화된 클라우드 데이터베이스 서비스입니다. Oracle Autonomous AI Database 커넥터를 사용하면 Lovable 앱이 Oracle REST Data Services(ORDS)의 REST-Enabled SQL 엔드포인트를 통해 이 데이터베이스에 SQL 쿼리를 실행할 수 있습니다. 이 커넥터는 하나의 엔진과 엔드포인트를 공유하는 Autonomous 워크로드 유형 전반에서 작동하며, 해당 유형은 AI Lakehouse(이전 이름 Autonomous Data Warehouse), Transaction Processing, JSON Database, APEX Service입니다. Oracle Fusion Data Intelligence는 웨어하우스를 Autonomous 데이터베이스에 저장하므로 이 커넥터로 Fusion ERP(전사적 자원 관리)와 HCM(인적 자본 관리) 데이터에도 접근할 수 있습니다. 이때는 Oracle이 제공하는 OAX_USER 데이터베이스 사용자로 연결하거나, 같은 읽기 권한을 부여받은 사용자로 연결하세요(Oracle 가이드).

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

Oracle Autonomous AI Database를 연결하면 앱에서 다음 작업을 할 수 있습니다.

• ORDS REST-Enabled SQL 엔드포인트로 SQL 쿼리 실행
• Oracle 데이터 딕셔너리를 통해 스키마와 테이블 메타데이터 탐색
• OAX_USER 스키마를 통해 Oracle Fusion Data Intelligence 데이터 읽기
• 큰 결과 집합의 페이지 나누기와 쿼리 매개변수의 안전한 바인딩

주요 활용 사례 및 예시 앱

Oracle Autonomous AI Database로 다음과 같은 내부 리포팅 도구를 만들 수 있습니다.

Oracle Autonomous AI Database 연결의 작동 방식

각 Oracle Autonomous AI Database 연결은 REST-Enabled SQL URL 하나와 데이터베이스 사용자 하나를 사용합니다.

• ORDS REST-Enabled SQL: 커넥터는 Autonomous Database에서 실행되며 HTTPS로 SQL을 제공하는 ORDS와 통신합니다. 이 기능은 기본적으로 켜져 있으므로 wallet이나 Oracle 클라이언트 드라이버가 필요하지 않습니다. /ords/<schema>로 끝나는, REST가 활성화된 스키마의 ORDS URL을 입력하면 됩니다.
• 인증: Oracle은 HTTP 기본 인증(basic auth)을 사용합니다. 연결에 사용할 데이터베이스 사용자의 사용자 이름과 비밀번호를 입력합니다. 자격 증명은 Lovable 게이트웨이에 안전하게 저장되며 브라우저나 앱의 프런트엔드 코드에 노출되지 않습니다.
• 게이트웨이: 쿼리는 Lovable의 커넥터 게이트웨이를 거쳐 전달됩니다. 게이트웨이가 호스트와 자격 증명을 주입하므로 앱이 이를 직접 보내지 않습니다.
• 데이터 접근: 읽거나 실행할 수 있는 범위는 전적으로 연결에 사용한 데이터베이스 사용자의 권한에 따라 정해집니다.

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

Oracle Autonomous AI Database 연결 방법

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

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

사전 요구 사항

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

• 공용 인터넷으로 접근할 수 있는 Oracle Autonomous AI Database 인스턴스(프라이빗 엔드포인트 전용 인스턴스는 사용할 수 없음). 인스턴스에서 접근 제어 목록(ACL)을 사용한다면 Lovable의 IP 범위를 추가하세요.
• REST가 활성화된 스키마를 가진 읽기 전용 데이터베이스 사용자(1단계 참고)
• /ords/<schema>로 끝나는 해당 스키마의 ORDS URL
• Lovable 워크스페이스에서 연결을 만들 수 있는 권한

1단계: 읽기 전용 Oracle 사용자 준비하기

ADMIN으로 연결하지 말고 전용 읽기 전용 사용자를 만들어 해당 스키마의 REST를 활성화하세요. Oracle Cloud Infrastructure(OCI) 콘솔에서 인스턴스의 Database actions → SQL을 열고, 이름, 비밀번호, 권한 부여 대상을 데이터에 맞게 조정한 다음 ADMIN으로 아래 SQL을 실행합니다.

CREATE USER reporting_ro IDENTIFIED BY "<strong-password>";
GRANT CREATE SESSION TO reporting_ro;

-- 앱에 필요한 테이블과 뷰에만 SELECT 권한을 부여합니다. 아래는 예시입니다.
GRANT SELECT ON sales.orders TO reporting_ro;

-- ORDS가 /ords/reporting_ro/ 경로로 제공하도록 스키마의 REST를 활성화합니다.
BEGIN
  ORDS_ADMIN.ENABLE_SCHEMA(
    p_enabled             => TRUE,
    p_schema              => 'REPORTING_RO',
    p_url_mapping_type    => 'BASE_PATH',
    p_url_mapping_pattern => 'reporting_ro',
    p_auto_rest_auth      => TRUE
  );
  COMMIT;
END;
/

REST-Enabled SQL URL은 인스턴스의 ORDS 공개 접근 URL 뒤에 스키마 별칭을 붙인 값입니다. 예를 들면 https://<db>.adb.<region>.oraclecloudapps.com/ords/reporting_ro입니다. ORDS URL을 찾으려면 OCI 콘솔에서 인스턴스를 열고 Tool configuration을 선택한 다음 **Web Access (ORDS)**의 Public access URL을 복사하세요.

Fusion Data Intelligence용으로 OAX_USER로 연결한다면 같은 ORDS_ADMIN.ENABLE_SCHEMA 블록으로 OAX_USER 스키마의 REST를 활성화하세요. p_schema는 'OAX_USER'로, p_url_mapping_pattern은 'oax_user'로 설정하고, URL은 /ords/oax_user로 끝나게 합니다.

2단계: Lovable에서 연결하기

연결 양식에는 1단계에서 준비한 URL, 사용자 이름, 비밀번호를 입력합니다.

연결되면 프로젝트에서 빌드하는 누구나 프로젝트 채팅에서 Lovable에게 자신의 프로젝트를 Oracle Autonomous AI Database에 링크해 달라고 요청할 수 있습니다(구성된 연결 단위 접근 권한 기준). 그러면 Lovable 앱이 Oracle 데이터에 SQL 쿼리를 실행하고 그 결과를 활용할 수 있습니다.

제한 사항

Oracle Autonomous AI Database로 빌드할 때는 다음 제한을 염두에 두세요.

• 사용자별 데이터 범위 지정 불가. 연결을 사용하는 모든 사람이 같은 데이터베이스 사용자로 쿼리합니다. 필요한 테이블로 범위를 좁힌 읽기 전용 사용자를 사용하고, 연결을 사용할 수 있는 사람을 제한하세요.
• 커넥터는 읽기 전용 접근을 강제하지 않습니다. 모든 문은 데이터베이스 사용자의 권한으로 실행되므로, 해당 사용자에게 쓰기 권한이 있으면 쿼리도 데이터를 쓸 수 있습니다. 실제로 효과가 있는 통제 수단은 데이터베이스 권한 부여입니다. CREATE SESSION과 SELECT 권한만 있는 사용자로 연결하세요.
• 게이트웨이 한도는 게이트웨이 기반 커넥터에 설명된 대로 적용됩니다.

Oracle Autonomous AI Database 연결 관리

연결은 Connectors에서 관리합니다. **Oracle Autonomous AI Database**를 선택한 다음 연결을 여세요.

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

관련 주제

• Fireworks AI에 앱 연결하기
• ElevenLabs로 앱에 음성 AI 연결하기
• Lovable 변경 로그
• 데이터베이스
• Supabase에 연결