Skip to main content
DbSphere는 자연어를 SQL로 변환하여 데이터베이스를 조회하는 기능입니다. SQL을 모르는 사용자도 “이번 달 매출 알려줘”라고 질문하면 AI가 적절한 SQL을 생성하고 실행하여 결과를 자연어로 응답합니다.

​
NL-to-SQL 파이프라인

단계설명
스키마 분석AI가 연결된 테이블 구조와 컬럼 설명을 분석합니다
SQL 생성자연어 질문을 해당 DB 방언에 맞는 SQL로 변환합니다
안전 검증SELECT 쿼리만 허용하고 INSERT, UPDATE, DELETE 등은 차단합니다
쿼리 실행검증된 SQL을 데이터베이스에서 실행합니다
자연어 응답쿼리 결과를 자연어 텍스트 또는 차트로 변환합니다

​
지원 데이터베이스

기본적으로 6종의 데이터베이스를 지원합니다.
데이터베이스유형특징
PostgreSQLRDBMS고급 기능, JSON 지원, 오픈소스
MySQLRDBMS가장 널리 사용되는 RDBMS
Microsoft SQL ServerRDBMS엔터프라이즈 환경
OracleRDBMS대규모 엔터프라이즈
SQLiteRDBMS경량 임베디드 데이터베이스
SnowflakeCloud DW클라우드 데이터 웨어하우스
관리자가 DBSPHERE_TYPES 환경 변수를 설정하면 Databricks, Azure Synapse, Microsoft Fabric 등 추가 DB 유형을 활성화할 수 있습니다.

​
데이터베이스 연결

1

새 연결 생성

워크스페이스 > 데이터베이스 > ”+ 새 연결” 클릭 후 기본 정보를 입력합니다.
필드설명예시
이름연결 표시 이름”매출 분석 DB”
설명데이터베이스 용도”영업팀 매출 데이터”
DB 유형데이터베이스 종류PostgreSQL
2

접속 정보 입력

데이터베이스 접속에 필요한 정보를 입력합니다.공통 필드:
필드설명
호스트DB 서버 주소
포트접속 포트
데이터베이스명접속할 DB 이름
사용자명DB 계정
비밀번호DB 비밀번호
DB 유형추가 필드설명
SnowflakeAccount, Warehouse, Role, SchemaSnowflake 계정 식별자, 사용 웨어하우스, 역할, 스키마
PostgreSQLSchema스키마 이름 (기본: public)
MSSQLSchema스키마 이름 (기본: dbo)
SQLiteDatabase (파일 경로)호스트/포트/인증 불필요, DB 파일 경로만 입력
3

연결 테스트

“연결 테스트” 버튼을 클릭하여 접속을 확인합니다.
4

테이블 선택

연결 성공 후 AI가 참조할 테이블을 선택합니다.
민감한 정보(개인정보, 비밀번호 등)가 포함된 테이블은 반드시 제외하세요. 선택된 테이블은 AI가 조회할 수 있습니다.
5

스키마 설명 추가 (선택)

테이블과 컬럼에 대한 한국어 설명을 추가합니다. 설명이 상세할수록 AI가 더 정확한 SQL을 생성합니다.
AI 자동 추출 기능을 사용하면 테이블 구조, 컬럼 설명, 샘플 Q&A를 LLM이 자동 생성합니다. 수동으로 작성하지 않아도 되지만, 자동 생성 결과를 검토하고 보정하면 정확도가 더 높아집니다.
테이블: orders
설명: 주문 내역 테이블
컬럼:
- order_id: 주문 고유 번호
- customer_id: 고객 ID (customers 테이블 참조)
- order_date: 주문 일시
- total_amount: 총 주문 금액 (원)
- status: 주문 상태 (pending/confirmed/shipped/delivered)
6

도구 설명 설정 (선택)

에이전트가 이 데이터베이스를 언제, 어떻게 활용할지 안내하는 도구 설명을 작성합니다.AI 자동 생성: 도구 설명 입력란 옆의 자동 생성 버튼을 클릭하면, 연결된 테이블 구조와 컬럼 정보를 분석하여 AI가 도구 설명을 자동 작성합니다.
이 데이터베이스는 영업팀의 주문, 고객, 재고 정보를 담고 있습니다.
매출 분석, 고객 조회, 재고 현황 확인 등의 질문에 활용하세요.
주문 테이블(orders)과 고객 테이블(customers)을 JOIN하여
고객별 구매 내역을 조회할 수 있습니다.
도구 설명이 정확할수록 에이전트가 여러 데이터베이스 중 적절한 것을 선택하는 정확도가 높아집니다.
7

접근 권한 설정

데이터베이스 사용 권한을 설정합니다.
옵션설명
공개모든 사용자가 사용 가능
비공개본인만 사용 가능
그룹/조직 지정특정 그룹 또는 조직만 사용 가능

​
데이터베이스 조회

​
에이전트에 연결

  1. 에이전트 편집 화면에서 “데이터베이스” 섹션의 ”+ 추가” 클릭
  2. 연결할 데이터베이스 선택
  3. 저장

​
채팅에서 사용

데이터베이스가 연결된 에이전트와 대화하면, AI가 질문을 분석하여 자동으로 SQL을 생성하고 실행합니다. 
사용자: 지난 분기 대비 이번 분기 매출 성장률은?

AI: 분기별 매출을 분석했습니다:

| 분기 | 매출액 | 전분기 대비 |
|------|--------|------------|
| Q4 2024 | ₩12.5억 | - |
| Q1 2025 | ₩14.2억 | +13.6% |

이번 분기 매출은 전분기 대비 13.6% 성장했습니다.
주요 성장 요인: 신규 고객 유치(+23%), 기존 고객 재구매율 상승(+8%)

​
질문 예시

- 이번 달 매출 얼마야?
- 지난주 일별 매출 추이 보여줘
- 매출 TOP 10 고객 알려줘
- 제품 카테고리별 매출 비중은?

​
보안

​
읽기 전용

DbSphere는 SELECT 쿼리만 실행합니다. 데이터 변경은 불가능합니다.
허용차단
SELECTINSERT, UPDATE, DELETE
집계 함수 (COUNT, SUM, AVG)DROP, ALTER, TRUNCATE
JOIN, 서브쿼리CREATE, GRANT

​
자격 증명 보호

  • 데이터베이스 비밀번호는 암호화하여 저장합니다
  • 연결 정보는 접근 권한이 있는 사용자만 확인할 수 있습니다

​
베스트 프랙티스

​
데이터베이스 계정 설정

  1. 전용 계정 생성: AI 전용 읽기 전용 계정을 만드세요
  2. 최소 권한 부여: 필요한 테이블에 대해서만 SELECT 권한을 부여하세요
  3. 쿼리 제한: 타임아웃과 결과 행 수 제한을 설정하세요

​
테이블 선택

  1. 필요한 것만 선택: 모든 테이블을 연결하면 AI가 혼란스러워질 수 있습니다
  2. 민감 데이터 제외: 개인정보, 비밀번호가 포함된 테이블은 반드시 제외하세요
  3. 관련 테이블 함께 선택: JOIN이 필요한 테이블은 함께 선택하세요

​
스키마 설명 작성

  1. 한국어 설명 권장: 업무 용어를 사용하여 테이블과 컬럼을 설명하세요
  2. 비즈니스 컨텍스트 추가: “status” 컬럼의 가능한 값과 의미를 기술하세요
  3. 테이블 관계 명시: 외래 키 관계와 JOIN 조건을 설명하세요

​
트러블슈팅

원인해결 방법
네트워크 문제방화벽 규칙, VPN 연결 상태 확인
인증 실패계정, 비밀번호, 권한 재확인
포트 차단DB 포트가 열려 있는지 확인
SSL 설정SSL 인증서 요구 여부 확인
원인해결 방법
스키마 설명 부족테이블, 컬럼에 상세 설명 추가
관련 테이블 누락JOIN이 필요한 테이블을 함께 선택
질문이 모호함구체적인 조건(날짜 범위, 필터)을 포함하여 질문
원인해결 방법
대용량 데이터날짜 범위 등 조건을 추가하여 질문
복잡한 쿼리질문을 단순화하거나 여러 질문으로 분리
DB 성능 문제인덱스 최적화, DB 리소스 확인

​
FAQ

아니요, DbSphere는 읽기 전용입니다. SELECT 쿼리만 실행하며, 데이터를 수정하거나 삭제할 수 없습니다.
네, AI 응답에서 생성된 SQL을 확인할 수 있습니다.
네, 관련 테이블을 모두 선택하고 테이블 간 관계를 스키마 설명에 기술하면 AI가 적절한 JOIN 쿼리를 생성합니다.
네, 에이전트에 여러 데이터베이스를 연결하면 AI가 질문에 따라 적절한 데이터베이스를 자동으로 선택합니다. 이때 각 DB의 도구 설명을 구체적으로 작성하면 선택 정확도가 높아집니다.