NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드
사내 데이터를 분석하고 싶을 때마다 SQL을 작성하거나 데이터 팀에 요청해야 했던 경험이 있으신가요?DbSphere는 자연어를 SQL로 자동 변환하여 데이터베이스를 조회합니다. “이번 달 매출 알려줘”라고 질문하면 AI가 SQL을 생성하고 실행하여 결과를 자연어와 표로 응답하고, 요청 시 차트로 시각화합니다.
예시
“부서별 이번 분기 매출 비교해줘”
방법
과정
소요 시간
직접 SQL 작성
SQL 작성 → 실행 → 결과 해석
10~30분
데이터 팀 요청
요청 → 대기 → 결과 수령
수시간~수일
DbSphere
자연어 질문 → 즉시 답변 (표·차트)
10초
워크스페이스 > 데이터베이스에서 연결된 DB 목록을 확인합니다
NL-to-SQL 파이프라인
단계
설명
스키마 분석
AI가 연결된 테이블 구조와 컬럼 설명을 분석합니다
SQL 생성
자연어 질문을 해당 DB 문법에 맞는 SQL로 변환합니다
안전 검증
기본값은 읽기 전용입니다 — SELECT만 실행하고 INSERT·UPDATE·DELETE·DDL은 차단합니다. 데이터베이스별 데이터 변경 허용을 켜면 쓰기도 가능하지만, 매 호출마다 사용자 승인을 거칩니다 (데이터 변경 제어)
쿼리 실행
검증된 SQL을 데이터베이스에서 실행합니다
자연어 응답
쿼리 결과를 표·자연어로 반환하고, 요청 시 차트로 시각화합니다
지원 데이터베이스
기본적으로 10종의 데이터베이스를 지원합니다.
데이터베이스
유형
특징
PostgreSQL
RDBMS
고급 기능, JSON 지원, 오픈소스
MySQL
RDBMS
가장 널리 사용되는 RDBMS
Microsoft SQL Server (MSSQL)
RDBMS
엔터프라이즈 환경
Oracle
RDBMS
대규모 엔터프라이즈
SQLite
RDBMS
경량 임베디드 데이터베이스
Snowflake
Cloud DW
클라우드 데이터 웨어하우스
BigQuery
Cloud DW
Google Cloud 데이터 웨어하우스, 서비스 계정 키 인증
Databricks
Lakehouse
Databricks SQL Warehouse, Delta Lake 통합
Azure Synapse
Cloud DW
Azure 통합 분석 플랫폼
Microsoft Fabric
Lakehouse / DW
Power BI 통합 분석 환경
10종은 기본 활성화 상태입니다. 관리자가 DBSPHERE_TYPES 환경 변수로 노출 목록을 좁히거나 넓힐 수 있습니다.
데이터베이스 연결
1
기본 정보 입력
워크스페이스 > 데이터베이스에서 + 새 데이터베이스를 누르면 생성 폼이 열립니다.
이름과 설명을 입력하고 권한을 설정합니다.
이름, 설명, 권한을 입력합니다
필드
설명
예시
이름
연결 표시 이름
”매출 분석 DB”
설명
데이터베이스 용도
”영업팀 매출 데이터”
권한
공개 / 비공개. 비공개면 아래 그룹 카드에서 대상 지정
비공개 + “영업팀”
2
접속 정보 입력
DB Information에서 구성 버튼을 클릭하여 데이터베이스 접속에 필요한 정보를 입력합니다. 데이터베이스 유형에 따라 입력 정보가 달라집니다.공통 필드:
필드
설명
호스트
DB 서버 주소
포트
접속 포트
데이터베이스
접속할 DB 이름
사용자 이름
DB 계정
비밀번호
DB 비밀번호
쿼리 최대 실행시간
쿼리 제한시간(초). 비워두면 서버 기본값 사용
DB 유형별 추가 필드
공통 필드(호스트·포트·데이터베이스·사용자 이름·비밀번호·쿼리 최대 실행시간) 외에 DB 유형별로 아래 필드가 추가됩니다.
DB 유형
추가 필드
비고
MySQL
—
공통 필드만 사용
MSSQL
스키마
스키마 이름 (기본: dbo)
PostgreSQL
스키마
스키마 이름 (기본: public)
Snowflake
계정, 웨어하우스, 역할, 스키마
호스트·포트 불필요
Oracle
스키마, 서비스 이름, SID
데이터베이스 대신 서비스 이름 또는 SID 사용
SQLite
데이터베이스 파일
호스트·포트·인증 불필요, 파일 경로만 입력
Databricks
서버 호스트명, HTTP 경로, 액세스 토큰, 카탈로그, 스키마
Delta Lake / SQL Warehouse
Synapse
스키마
스키마 이름 (기본: dbo)
Fabric
스키마
스키마 이름 (기본: dbo)
BigQuery
프로젝트 ID, 데이터셋, 서비스 계정 JSON
호스트·포트·사용자 이름·비밀번호 불필요
3
연결 테스트
“연결 테스트” 버튼을 클릭하여 접속을 확인합니다.
4
테이블 선택
연결 성공 후 AI가 참조할 테이블을 선택합니다.
AI가 참조할 테이블만 선택합니다 — 민감 데이터 테이블은 반드시 제외하세요
민감한 정보(개인정보, 비밀번호 등)가 포함된 테이블은 반드시 제외하세요. 선택된 테이블은 AI가 조회할 수 있습니다.
5
도구 설명 설정 (선택)
에이전트가 이 데이터베이스를 언제, 어떻게 활용할지 안내하는 도구 설명을 작성합니다.AI 자동 생성: 도구 설명 입력란 옆의 자동 생성 버튼을 클릭하면, 연결된 테이블 구조와 컬럼 정보를 분석하여 AI가 도구 설명을 자동 작성합니다.
도구 설명 예시
이 데이터베이스는 영업팀의 주문, 고객, 재고 정보를 담고 있습니다.매출 분석, 고객 조회, 재고 현황 확인 등의 질문에 활용하세요.주문 테이블(orders)과 고객 테이블(customers)을 JOIN하여고객별 구매 내역을 조회할 수 있습니다.
도구 설명이 정확할수록 에이전트가 여러 데이터베이스 중 적절한 것을 선택하는 정확도가 높아집니다.
6
접근 권한 설정
상단의 자물쇠 모양 버튼을 눌러 데이터베이스의 접근 권한을 설정합니다.
옵션
설명
공개
모든 사용자가 사용 가능
비공개
본인만 사용 가능
그룹 지정
지정한 그룹의 구성원만 사용 가능
활동 이력
데이터베이스 상세 화면 상단의 활동 이력 버튼을 누르면, 이 데이터베이스에 일어난 변경이 시간순으로 표시됩니다. 각 줄에 동작 · 수행한 사람 · 대상 · 정확한 시각이 함께 나오고, 창 아래에 전체 건수가 표시됩니다. 연결 정보나 테이블 구성이 언제 바뀌었는지 되짚을 때 사용하세요.
AI가 SQL을 생성하는 흐름
에이전트에 DB를 연결하면, 사용자 질문이 다음 과정을 거쳐 SQL로 변환됩니다.
성공한 쿼리가 자동으로 메모리에 누적됩니다. 사용할수록 AI가 비슷한 질문에 더 정확한 SQL을 생성하게 됩니다.
메모리 시스템
DbSphere는 4종류의 메모리를 활용하여 SQL 생성 정확도를 높입니다. 메모리가 많을수록 AI가 더 정확한 쿼리를 작성합니다.
메모리
뱃지
내용
생성 방식
DDL 스키마
DDL 스키마
테이블 구조 + 컬럼 설명
스키마 추출 시 자동
SQL 퓨샷
SQL 퓨샷
질문-SQL 쌍 (과거 성공 쿼리)
쿼리 성공 시 자동 누적
문서 조사
문서 조사
비즈니스 용어, 규칙, 컨텍스트
수동 입력
SQL 예제
SQL 예제
참조용 SQL 예제 (use case, 태그)
수동 입력 또는 추출 시 자동
메모리 탭에서 4종 메모리를 확인하고 관리할 수 있습니다
DDL 스키마 설명으로 정확도 높이기
DDL 스키마 메모리의 테이블·컬럼에 비즈니스 설명을 추가하면 AI의 SQL 생성 정확도가 크게 향상됩니다. 스키마 추출 후 메모리 탭 → DDL 스키마 클릭 → 편집에서 각 테이블과 컬럼에 한국어 설명을 입력합니다.
메모리 탭 → DDL 스키마 → 편집에서 테이블·컬럼 설명을 입력합니다
스키마 추출 시 LLM이 테이블·컬럼 설명과 샘플 Q&A를 자동 생성하도록 설정할 수도 있습니다. 자동 생성 결과를 검토하고 보정하면 정확도가 더 높아집니다.
스키마 설명 예시
테이블: orders설명: 주문 내역 테이블컬럼:- order_id: 주문 고유 번호- customer_id: 고객 ID (customers 테이블 참조)- order_date: 주문 일시- total_amount: 총 주문 금액 (원)- status: 주문 상태 (pending/confirmed/shipped/delivered)
SQL 퓨샷이 핵심
SQL 퓨샷은 성공한 쿼리가 자동으로 저장되는 few-shot learning 메모리입니다.
AI가 틀린 SQL을 생성하는 패턴이 반복되면, 문서 조사에 해당 규칙을 추가하세요. AI가 다음 질문부터 해당 규칙을 참고합니다.
데이터 시각화
SQL 실행 결과는 기본적으로 표로 제공됩니다. “차트로 보여줘”처럼 요청하면 데이터에 맞는 차트로 시각화하고, 결과 상단의 차트 타입 토글로 직접 전환할 수 있습니다.
차트 타입
적합한 데이터
막대 (Bar)
카테고리별 비교
선 (Line)
시계열 추이
파이 (Pie)
비율/구성
산점도 (Scatter)
상관관계
히트맵 (Heatmap)
교차 분석
히스토그램
분포
그룹 막대
다차원 비교
표 (Table)
상세 데이터
차트로 요청하면 데이터 구조에 맞는 차트 타입을 추천·자동 선택하며, 상단 토글에서 다른 타입으로 변경할 수 있습니다.
데이터베이스 조회
에이전트에 연결
에이전트 편집 화면에서 “데이터베이스” 섹션의 “데이터베이스 선택” 클릭
연결할 데이터베이스 선택
적용 클릭
채팅에서 사용
데이터베이스가 연결된 에이전트와 대화하면, AI가 질문을 분석하여 자동으로 SQL을 생성하고 실행합니다.
사용자: 지난 분기 대비 이번 분기 매출 성장률은?AI: 분기별 매출을 분석했습니다:| 분기 | 매출액 | 전분기 대비 ||------|--------|------------|| Q4 2024 | ₩12.5억 | - || Q1 2025 | ₩14.2억 | +13.6% |이번 분기 매출은 전분기 대비 13.6% 성장했습니다.주요 성장 요인: 신규 고객 유치(+23%), 기존 고객 재구매율 상승(+8%)
질문 예시
매출 분석
고객 분석
재고 관리
인사 관리
- 이번 달 매출 얼마야?- 지난주 일별 매출 추이 보여줘- 매출 TOP 10 고객 알려줘- 제품 카테고리별 매출 비중은?
- 이번 달 신규 가입 고객 수는?- VIP 고객 목록 보여줘- 최근 3개월간 구매하지 않은 고객은?- 고객 지역별 분포 알려줘
- 재고가 10개 미만인 상품 알려줘- 이번 주 입고 예정 상품은?- 재고 회전율이 낮은 상품 TOP 5는?
- 부서별 인원 현황 보여줘- 이번 달 입사/퇴사자 수는?- 평균 근속연수는?
SQL 실행 결과 확인
AI 응답 하단에 “SQL Query” 버튼이 표시됩니다. 클릭하면 실제 실행된 SQL과 결과를 상세하게 확인할 수 있습니다.
기능
설명
SQL 보기
실행된 SQL을 포맷팅된 형태로 표시 (키워드 대문자, 들여쓰기 적용)
SQL 복사
클립보드에 SQL 복사 — 별도 쿼리 도구에서 재실행할 때 유용
결과 테이블
쿼리 결과를 표 형태로 확인
결과 데이터는 최대 100행까지 표시됩니다. 전체 행 수가 100행을 초과하면 “Showing 100 of N rows” 안내가 표시됩니다. 전체 데이터가 필요하면 **채팅 결과 표 우측 상단의 CSV로 내보내기**로 내려받으세요.
DB 문법 차이
각 DB는 SQL 문법이 조금씩 다릅니다. Cloosphere는 자연어 → SQL 변환 시 DB별 문법 규칙을 시스템 프롬프트에 동적으로 주입해 AI가 올바른 SQL을 생성하도록 유도합니다. 다만 다음 항목은 사용자가 의도를 명확히 표현하면 더 정확한 SQL이 생성됩니다.
핵심 차이 비교
항목
PostgreSQL
MySQL
Oracle
MSSQL/Synapse/Fabric
SQLite
Snowflake
BigQuery
Databricks
식별자 인용
"name"
`name`
"NAME"
[name]
"name"
"NAME"
`name`
`name`
LIMIT 표현
LIMIT n
LIMIT n
FETCH FIRST n ROWS ONLY
TOP n
LIMIT n
LIMIT n
LIMIT n
LIMIT n
날짜 리터럴
'2026-04-26'
'2026-04-26'
TO_DATE('2026-04-26', 'YYYY-MM-DD')
'2026-04-26'
'2026-04-26'
'2026-04-26'
DATE '2026-04-26'
'2026-04-26'
날짜 포맷 함수
TO_CHAR()
DATE_FORMAT()
TO_CHAR()
FORMAT()
strftime()
TO_CHAR()
FORMAT_DATE()
date_format()
날짜 산술
+ INTERVAL '1 day'
DATE_ADD(d, INTERVAL 1 DAY)
+ 1 (직접)
DATEADD(day, 1, d)
date(d, '+1 day')
DATEADD(day, 1, d)
DATE_ADD(d, INTERVAL 1 DAY)
date_add(d, 1)
문자열 연결
||
CONCAT()
||
+
||
||
CONCAT()
||
빈 문자열 = NULL
✗
✗
✓ ⚠️
✗
✗
✗
✗
✗
대소문자 민감 (식별자)
따옴표 시 ✓
기본 ✗
대문자 기본
기본 ✗
따옴표 시 ✓
따옴표 시 ✓
기본 ✗
따옴표 시 ✓
시스템 자동 보정 vs 사용자 책임
자동으로 처리되는 것:
대시보드 기간 필터($st/$ed 플레이스홀더): DB별 날짜 리터럴로 자동 변환
지식 그래프 값 추출 시 식별자 인용: DB별 따옴표 자동 선택
AI에 전달되는 시스템 프롬프트에 DB별 문법 규칙 동적 주입 (LIMIT, 날짜, 식별자 등)
사용자/AI가 신경 써야 하는 것:
자연어 쿼리에 한글·특수문자 컬럼명을 직접 적을 때 — AI가 따옴표를 누락하면 실패할 수 있음
Oracle 빈 문자열 비교 (아래 Oracle 특이점 섹션 참조)
복잡한 윈도우 함수·CTE 같은 고급 SQL은 DB별 지원 차이가 있어 AI 생성 결과 검증 필요
Oracle DB 특이점
Oracle은 ANSI SQL과 일부 동작이 달라 사용자가 알아둘 만한 항목이 있습니다.
빈 문자열은 NULL로 처리됩니다 ⚠️
Oracle은 ''(빈 문자열)을 NULL과 동일하게 취급합니다. 따라서 다음 같은 조건은 항상 0행을 반환합니다:
-- ❌ 모두 잘못된 패턴 (Oracle)WHERE col <> ''WHERE col = ''WHERE TRIM(col) <> ''
올바른 사용:
-- ✅ NULL 검사로 대체WHERE col IS NOT NULLWHERE TRIM(col) IS NOT NULL
Cloosphere의 시스템 프롬프트에 이 규칙이 포함되어 있어 AI가 자동으로 회피하지만, 자연어 쿼리에서 “비어있지 않은 항목” 같은 모호한 표현 사용 시 0행이 반환되면 이 패턴을 의심하세요.
DATE_TRUNC() 대신 TRUNC(col, 'DD'), 요일 추출은 EXTRACT(DOW FROM col) 대신 TO_CHAR(col, 'D')를 사용합니다.
한글·특수문자 컬럼명 인용
Oracle에서 한글 컬럼 별칭(AS 공장코드)을 그대로 쓰면 ORA-00936: missing expression 오류가 발생합니다.
-- ❌ Oracle 실패SELECT plant_code AS 공장코드 FROM plants-- ✅ Oracle 권장SELECT plant_code AS "공장코드" FROM plants
이 규칙은 시스템 프롬프트에 포함되어 AI가 따옴표를 자동으로 적용하지만, 한글 컬럼이 많은 환경에서는 결과를 확인하고 누락 시 직접 수정하세요.
LIMIT 대신 FETCH FIRST
-- ❌ Oracle 12c 미만 또는 잘못된 사용SELECT * FROM users LIMIT 10-- ✅ Oracle 12c+SELECT * FROM users FETCH FIRST 10 ROWS ONLY-- ✅ Oracle 11g 호환 (서브쿼리)SELECT * FROM (SELECT * FROM users) WHERE ROWNUM <= 10
보안
데이터 변경 제어
DbSphere는 기본적으로 읽기 전용입니다. 다만 이는 고정된 성질이 아니라 데이터베이스마다 켜고 끌 수 있는 설정입니다.DB 설정 모달 최상단의 데이터 변경 허용 스위치가 이를 결정합니다. 화면 설명 그대로:
끔: 에이전트가 SELECT (읽기 전용) 만 실행 가능. 켬: INSERT/UPDATE/DELETE/DDL 도 가능하지만 매 호출마다 사용자 승인이 필요합니다.
꺼짐 (기본값)
켜짐
SELECT · 집계 함수 · JOIN · 서브쿼리
즉시 실행
즉시 실행
INSERT · UPDATE · DELETE
차단
사용자 승인 후 실행
DDL (CREATE, DROP, ALTER, TRUNCATE, GRANT)
차단
사용자 승인 후 실행
분류 불가 구문 · 여러 구문 동시 실행
차단
쓰기로 취급 → 승인 필요
데이터 변경 허용을 켜면 에이전트가 실제로 데이터를 바꿀 수 있습니다. 읽기 전용을 전제로 보안 검토나 접근 승인을 진행 중이라면, 대상 데이터베이스에서 이 스위치가 꺼져 있는지 반드시 확인하세요.이 스위치는 관리자도 우회할 수 없습니다. 관리자는 접근 권한(ACL)은 통과하지만 이 안전 스위치는 그대로 적용받습니다.
쓰기 승인 흐름
변경 허용이 켜진 상태에서 에이전트가 쓰기 SQL을 만들면, 바로 실행되지 않고 채팅에 승인 카드가 나타납니다.
카드 구성
내용
승인 대기 배지
실행 대기 상태 표시
만료 시간
이 시간이 지나면 요청이 자동으로 사라집니다
SQL 원문
에이전트가 생성한 구문 전체
영향 행 미리보기
변경 대상 데이터 (조회 가능한 경우)
커밋 / 롤백
커밋해야 실제로 반영되고, 롤백하면 취소됩니다
변경 허용이 필요하더라도, 아래 데이터베이스 계정 설정 의 최소 권한 원칙은 그대로 지키는 편이 안전합니다. 계정 권한과 이 스위치는 서로 독립된 두 겹의 방어선입니다.
자격 증명 보호
데이터베이스 비밀번호는 암호화하여 저장합니다
연결 정보는 접근 권한이 있는 사용자만 확인할 수 있습니다
베스트 프랙티스
데이터베이스 계정 설정
전용 계정 생성: AI 전용 읽기 전용 계정을 만드세요
최소 권한 부여: 필요한 테이블에 대해서만 SELECT 권한을 부여하세요
쿼리 제한: 타임아웃과 결과 행 수 제한을 설정하세요
테이블 선택
필요한 것만 선택: 모든 테이블을 연결하면 AI가 혼란스러워질 수 있습니다
민감 데이터 제외: 개인정보, 비밀번호가 포함된 테이블은 반드시 제외하세요
관련 테이블 함께 선택: JOIN이 필요한 테이블은 함께 선택하세요
스키마 설명 작성
한국어 설명 권장: 업무 용어를 사용하여 테이블과 컬럼을 설명하세요
비즈니스 컨텍스트 추가: “status” 컬럼의 가능한 값과 의미를 기술하세요
테이블 관계 명시: 외래 키 관계와 JOIN 조건을 설명하세요
트러블슈팅
연결 테스트가 실패합니다
원인
해결 방법
네트워크 문제
방화벽 규칙, VPN 연결 상태 확인
인증 실패
계정, 비밀번호, 권한 재확인
포트 차단
DB 포트가 열려 있는지 확인
SSL 설정
SSL 인증서 요구 여부 확인
AI가 잘못된 SQL을 생성합니다
원인
해결 방법
스키마 설명 부족
테이블, 컬럼에 상세 설명 추가
비즈니스 규칙 미반영
문서 조사 메모리에 규칙 추가
관련 테이블 누락
JOIN이 필요한 테이블을 함께 선택
질문이 모호함
구체적인 조건(날짜 범위, 필터)을 포함하여 질문
과거 참고 쿼리 없음
SQL 예제 메모리에 올바른 쿼리 예제 추가
응답이 느립니다
원인
해결 방법
대용량 데이터
날짜 범위 등 조건을 추가하여 질문
복잡한 쿼리
질문을 단순화하거나 여러 질문으로 분리
DB 성능 문제
인덱스 최적화, DB 리소스 확인
FAQ
데이터가 변경될 수 있나요?
기본값은 읽기 전용이라 변경되지 않습니다. SELECT가 아닌 구문은 차단됩니다.다만 데이터베이스마다 DB 설정 모달에서 데이터 변경 허용을 켤 수 있고, 켜면 에이전트가 INSERT·UPDATE·DELETE·DDL도 실행할 수 있습니다. 이 경우에도 바로 반영되지는 않고 매 호출마다 승인 카드가 떠서 사용자가 커밋해야 적용됩니다.읽기 전용을 보장해야 한다면 해당 데이터베이스에서 이 스위치가 꺼져 있는지 확인하세요 — 관리자도 이 스위치는 우회하지 못합니다. 자세한 내용은 데이터 변경 제어 를 참고하세요.
실행된 SQL을 볼 수 있나요?
네, AI 응답에서 생성된 SQL을 확인할 수 있습니다. 추적에서도 실행된 SQL과 결과를 상세하게 확인할 수 있습니다.
여러 테이블을 JOIN할 수 있나요?
네, 관련 테이블을 모두 선택하고 테이블 간 관계를 스키마 설명에 기술하면 AI가 적절한 JOIN 쿼리를 생성합니다.
한 에이전트에 여러 데이터베이스를 연결할 수 있나요?
네, 에이전트에 여러 데이터베이스를 연결하면 AI가 질문에 따라 적절한 데이터베이스를 자동으로 선택합니다. 이때 각 DB의 도구 설명을 구체적으로 작성하면 선택 정확도가 높아집니다.
스키마 추출 시 모델을 선택하면 뭐가 달라지나요?
모델을 선택하면 LLM이 테이블/컬럼에 비즈니스 설명을 자동 생성하고, 샘플 Q&A 쌍도 만들어줍니다. 모델 없이 추출하면 DDL 구조만 저장됩니다. 모델 선택을 권장합니다.
관련 페이지
에이전트
DB를 에이전트에 연결하여 자연어 질의 활성화
용어집
DB 비즈니스 용어를 AI에게 알려주어 정확도 향상
추적
SQL 생성·실행 과정을 단계별로 추적
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/workspace/database","slug":"/ko/workspace/database","pageMetadata":{"title":"데이터베이스","description":"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드","href":"/ko/workspace/database"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`사내 데이터를 분석하고 싶을 때마다 SQL을 작성하거나 데이터 팀에 요청해야 했던 경험이 있으신가요?`}),`\n`,_jsxs(_components.p,{children:[`DbSphere는 `,_jsx(_components.strong,{children:`자연어를 SQL로 자동 변환`}),`하여 데이터베이스를 조회합니다. “이번 달 매출 알려줘”라고 질문하면 AI가 SQL을 생성하고 실행하여 결과를 자연어와 표로 응답하고, 요청 시 차트로 시각화합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`예시`,children:`예시`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`“부서별 이번 분기 매출 비교해줘”`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`방법`}),_jsx(_components.th,{children:`과정`}),_jsx(_components.th,{style:{textAlign:`center`},children:`소요 시간`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`직접 SQL 작성`}),_jsx(_components.td,{children:`SQL 작성 → 실행 → 결과 해석`}),_jsx(_components.td,{style:{textAlign:`center`},children:`10~30분`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`데이터 팀 요청`}),_jsx(_components.td,{children:`요청 → 대기 → 결과 수령`}),_jsx(_components.td,{style:{textAlign:`center`},children:`수시간~수일`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DbSphere`}),_jsx(_components.td,{children:`자연어 질문 → 즉시 답변 (표·차트)`}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`10초`})})]})]})]}),`\n`,_jsx(Frame,{caption:`워크스페이스 > 데이터베이스에서 연결된 DB 목록을 확인합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=d23c6ad52a993b697b42cbe1d29b9de1`,alt:`데이터베이스 목록`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`949`,height:`949`,\"data-path\":`images/workspace/database-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=764552770c6882588d9783eaad0df34b 280w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=089b69894cbf438bcb5921a8bc2ae179 560w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=a38135c1d4fdbf57953e0b3a08e4fcf7 840w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=007c3f360eb8ea99401f2f3eb660f245 1100w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=d0397e354ae3e2e08267f99858e49f7f 1650w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=217a5959f3abc95e3f56c2d23d68b499 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`nl-to-sql-파이프라인`,children:`NL-to-SQL 파이프라인`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[자연어 질문] --> B[스키마 분석]\n B --> C[SQL 생성]\n C --> D{쓰기 구문?}\n D -->|아니오 · SELECT| F[쿼리 실행]\n D -->|예| E{데이터 변경 허용?}\n E -->|꺼짐 · 기본값| X[차단]\n E -->|켜짐| Y[사용자 승인 대기]\n Y -->|커밋| F\n Y -->|롤백| X\n F --> G[결과 반환]\n G --> H[표/차트/자연어 응답]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`스키마 분석`})}),_jsx(_components.td,{children:`AI가 연결된 테이블 구조와 컬럼 설명을 분석합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQL 생성`})}),_jsx(_components.td,{children:`자연어 질문을 해당 DB 문법에 맞는 SQL로 변환합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`안전 검증`})}),_jsxs(_components.td,{children:[`기본값은 읽기 전용입니다 — SELECT만 실행하고 INSERT·UPDATE·DELETE·DDL은 차단합니다. 데이터베이스별 `,_jsx(_components.code,{children:`데이터 변경 허용`}),`을 켜면 쓰기도 가능하지만, 매 호출마다 사용자 승인을 거칩니다 (`,_jsx(_components.a,{href:`#%EB%8D%B0%EC%9D%B4%ED%84%B0-%EB%B3%80%EA%B2%BD-%EC%A0%9C%EC%96%B4`,children:`데이터 변경 제어`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`쿼리 실행`})}),_jsx(_components.td,{children:`검증된 SQL을 데이터베이스에서 실행합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`자연어 응답`})}),_jsx(_components.td,{children:`쿼리 결과를 표·자연어로 반환하고, 요청 시 차트로 시각화합니다`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`지원-데이터베이스`,children:`지원 데이터베이스`}),`\n`,_jsx(_components.p,{children:`기본적으로 10종의 데이터베이스를 지원합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`데이터베이스`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`특징`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`PostgreSQL`})}),_jsx(_components.td,{children:`RDBMS`}),_jsx(_components.td,{children:`고급 기능, JSON 지원, 오픈소스`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`MySQL`})}),_jsx(_components.td,{children:`RDBMS`}),_jsx(_components.td,{children:`가장 널리 사용되는 RDBMS`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Microsoft SQL Server (MSSQL)`})}),_jsx(_components.td,{children:`RDBMS`}),_jsx(_components.td,{children:`엔터프라이즈 환경`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Oracle`})}),_jsx(_components.td,{children:`RDBMS`}),_jsx(_components.td,{children:`대규모 엔터프라이즈`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQLite`})}),_jsx(_components.td,{children:`RDBMS`}),_jsx(_components.td,{children:`경량 임베디드 데이터베이스`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Snowflake`})}),_jsx(_components.td,{children:`Cloud DW`}),_jsx(_components.td,{children:`클라우드 데이터 웨어하우스`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`BigQuery`})}),_jsx(_components.td,{children:`Cloud DW`}),_jsx(_components.td,{children:`Google Cloud 데이터 웨어하우스, 서비스 계정 키 인증`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Databricks`})}),_jsx(_components.td,{children:`Lakehouse`}),_jsx(_components.td,{children:`Databricks SQL Warehouse, Delta Lake 통합`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure Synapse`})}),_jsx(_components.td,{children:`Cloud DW`}),_jsx(_components.td,{children:`Azure 통합 분석 플랫폼`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Microsoft Fabric`})}),_jsx(_components.td,{children:`Lakehouse / DW`}),_jsx(_components.td,{children:`Power BI 통합 분석 환경`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`10종은 `,_jsx(_components.strong,{children:`기본 활성화`}),` 상태입니다. 관리자가 `,_jsx(_components.code,{children:`DBSPHERE_TYPES`}),` 환경 변수로 노출 목록을 좁히거나 넓힐 수 있습니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`데이터베이스-연결`,children:`데이터베이스 연결`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`기본 정보 입력`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 데이터베이스`}),`에서 `,_jsx(_components.strong,{children:`+ 새 데이터베이스`}),`를 누르면 생성 폼이 열립니다.\n이름과 설명을 입력하고 권한을 설정합니다.`]}),_jsx(Frame,{caption:`이름, 설명, 권한을 입력합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=ed3f097be2859e29502a7465249095b5`,alt:`데이터베이스 생성 폼`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/database-create-top.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?w=280\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=1cec195439b945e4ae1e5ce82d171a30 280w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?w=560\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=b9cf46de2c6b94679e99ef0500280a68 560w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?w=840\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=d8c65625de50ef155c8b6c961497323e 840w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?w=1100\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=28936f43c5130e356434991e5d4b1817 1100w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?w=1650\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=2234221efe3ea97783102e42e8178903 1650w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/database-create-top.png?w=2500\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=23dd16870c4e8043961753c92c2d0d89 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`이름`})}),_jsx(_components.td,{children:`연결 표시 이름`}),_jsx(_components.td,{children:`”매출 분석 DB”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{children:`데이터베이스 용도`}),_jsx(_components.td,{children:`”영업팀 매출 데이터”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`권한`})}),_jsxs(_components.td,{children:[`공개 / 비공개. 비공개면 아래 `,_jsx(_components.strong,{children:`그룹`}),` 카드에서 대상 지정`]}),_jsx(_components.td,{children:`비공개 + “영업팀”`})]})]})]})]}),_jsxs(Step,{title:`접속 정보 입력`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`DB Information`}),`에서 `,_jsx(_components.strong,{children:`구성`}),` 버튼을 클릭하여 데이터베이스 접속에 필요한 정보를 입력합니다. `,_jsx(_components.strong,{children:`데이터베이스 유형`}),`에 따라 입력 정보가 달라집니다.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`공통 필드:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`호스트`})}),_jsx(_components.td,{children:`DB 서버 주소`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`포트`})}),_jsx(_components.td,{children:`접속 포트`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`데이터베이스`})}),_jsx(_components.td,{children:`접속할 DB 이름`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`사용자 이름`})}),_jsx(_components.td,{children:`DB 계정`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`비밀번호`})}),_jsx(_components.td,{children:`DB 비밀번호`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`쿼리 최대 실행시간`})}),_jsx(_components.td,{children:`쿼리 제한시간(초). 비워두면 서버 기본값 사용`})]})]})]}),_jsxs(Accordion,{title:`DB 유형별 추가 필드`,id:`db`,children:[_jsx(_components.p,{children:`공통 필드(호스트·포트·데이터베이스·사용자 이름·비밀번호·쿼리 최대 실행시간) 외에 DB 유형별로 아래 필드가 추가됩니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`DB 유형`}),_jsx(_components.th,{children:`추가 필드`}),_jsx(_components.th,{children:`비고`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`MySQL`})}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`공통 필드만 사용`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`MSSQL`})}),_jsx(_components.td,{children:`스키마`}),_jsxs(_components.td,{children:[`스키마 이름 (기본: `,_jsx(_components.code,{children:`dbo`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`PostgreSQL`})}),_jsx(_components.td,{children:`스키마`}),_jsxs(_components.td,{children:[`스키마 이름 (기본: `,_jsx(_components.code,{children:`public`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Snowflake`})}),_jsx(_components.td,{children:`계정, 웨어하우스, 역할, 스키마`}),_jsx(_components.td,{children:`호스트·포트 불필요`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Oracle`})}),_jsx(_components.td,{children:`스키마, 서비스 이름, SID`}),_jsx(_components.td,{children:`데이터베이스 대신 서비스 이름 또는 SID 사용`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQLite`})}),_jsx(_components.td,{children:`데이터베이스 파일`}),_jsx(_components.td,{children:`호스트·포트·인증 불필요, 파일 경로만 입력`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Databricks`})}),_jsx(_components.td,{children:`서버 호스트명, HTTP 경로, 액세스 토큰, 카탈로그, 스키마`}),_jsx(_components.td,{children:`Delta Lake / SQL Warehouse`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Synapse`})}),_jsx(_components.td,{children:`스키마`}),_jsxs(_components.td,{children:[`스키마 이름 (기본: `,_jsx(_components.code,{children:`dbo`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Fabric`})}),_jsx(_components.td,{children:`스키마`}),_jsxs(_components.td,{children:[`스키마 이름 (기본: `,_jsx(_components.code,{children:`dbo`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`BigQuery`})}),_jsx(_components.td,{children:`프로젝트 ID, 데이터셋, 서비스 계정 JSON`}),_jsx(_components.td,{children:`호스트·포트·사용자 이름·비밀번호 불필요`})]})]})]})]})]}),_jsx(Step,{title:`연결 테스트`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`“연결 테스트”`}),` 버튼을 클릭하여 접속을 확인합니다.`]})}),_jsxs(Step,{title:`테이블 선택`,children:[_jsx(_components.p,{children:`연결 성공 후 AI가 참조할 테이블을 선택합니다.`}),_jsx(Frame,{caption:`AI가 참조할 테이블만 선택합니다 — 민감 데이터 테이블은 반드시 제외하세요`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=4deca12ff8268aa7105634dcfb7df8e3`,alt:`테이블 선택`,\"data-og-width\":`803`,width:`803`,\"data-og-height\":`572`,height:`572`,\"data-path\":`images/workspace/database-tables.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=d345bcf81db774aad46b8afb32f7c7b0 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=169943fca822618867b2012297f8b4b2 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=3d67cb97b6bf0869cbed1071056e7b71 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=c56e4447b770d4e9689764daa2be6c89 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=863838ad861d0a42e2ce2742f5c79f9a 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/database-tables.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=c35d2175e3154989f2abf5956b95a49f 2500w`})}),_jsx(Warning,{children:_jsx(_components.p,{children:`민감한 정보(개인정보, 비밀번호 등)가 포함된 테이블은 반드시 제외하세요. 선택된 테이블은 AI가 조회할 수 있습니다.`})})]}),_jsxs(Step,{title:`도구 설명 설정 (선택)`,children:[_jsx(_components.p,{children:`에이전트가 이 데이터베이스를 언제, 어떻게 활용할지 안내하는 도구 설명을 작성합니다.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`AI 자동 생성:`}),` 도구 설명 입력란 옆의 자동 생성 버튼을 클릭하면, 연결된 테이블 구조와 컬럼 정보를 분석하여 AI가 도구 설명을 자동 작성합니다.`]}),_jsx(Accordion,{title:`도구 설명 예시`,id:`%EC%9D%B4-%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4%EB%8A%94-%EC%98%81%EC%97%85%ED%8C%80%EC%9D%98-%EC%A3%BC%EB%AC%B8%2C-%EA%B3%A0%EA%B0%9D%2C-%EC%9E%AC%EA%B3%A0-%EC%A0%95%EB%B3%B4%EB%A5%BC-%EB%8B%B4%EA%B3%A0-%EC%9E%88%EC%8A%B5%EB%8B%88%EB%8B%A4.-%EB%A7%A4%EC%B6%9C-%EB%B6%84%EC%84%9D%2C-%EA%B3%A0%EA%B0%9D-%EC%A1%B0%ED%9A%8C%2C-%EC%9E%AC%EA%B3%A0-%ED%98%84%ED%99%A9-%ED%99%95%EC%9D%B8-%EB%93%B1%EC%9D%98-%EC%A7%88%EB%AC%B8%EC%97%90-%ED%99%9C%EC%9A%A9%ED%95%98%EC%84%B8%EC%9A%94.-%EC%A3%BC%EB%AC%B8-%ED%85%8C%EC%9D%B4%EB%B8%94(orders)%EA%B3%BC-%EA%B3%A0%EA%B0%9D-%ED%85%8C%EC%9D%B4%EB%B8%94(customers)%EC%9D%84-join%ED%95%98%EC%97%AC-%EA%B3%A0%EA%B0%9D%EB%B3%84-%EA%B5%AC%EB%A7%A4-%EB%82%B4%EC%97%AD%EC%9D%84-%EC%A1%B0%ED%9A%8C%ED%95%A0-%EC%88%98-%EC%9E%88%EC%8A%B5%EB%8B%88%EB%8B%A4.`,children:_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`이 데이터베이스는 영업팀의 주문, 고객, 재고 정보를 담고 있습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`매출 분석, 고객 조회, 재고 현황 확인 등의 질문에 활용하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`주문 테이블(orders)과 고객 테이블(customers)을 JOIN하여`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`고객별 구매 내역을 조회할 수 있습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tip,{children:_jsx(_components.p,{children:`도구 설명이 정확할수록 에이전트가 여러 데이터베이스 중 적절한 것을 선택하는 정확도가 높아집니다.`})})]}),_jsxs(Step,{title:`접근 권한 설정`,children:[_jsxs(_components.p,{children:[`상단의 `,_jsx(_components.strong,{children:`자물쇠`}),` 모양 버튼을 눌러 데이터베이스의 접근 권한을 설정합니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`옵션`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`공개`})}),_jsx(_components.td,{children:`모든 사용자가 사용 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`비공개`})}),_jsx(_components.td,{children:`본인만 사용 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`그룹 지정`})}),_jsx(_components.td,{children:`지정한 그룹의 구성원만 사용 가능`})]})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`활동-이력`,children:`활동 이력`}),`\n`,_jsxs(_components.p,{children:[`데이터베이스 상세 화면 상단의 `,_jsx(_components.strong,{children:`활동 이력`}),` 버튼을 누르면, 이 데이터베이스에 일어난 변경이 시간순으로 표시됩니다. 각 줄에 `,_jsx(_components.strong,{children:`동작 · 수행한 사람 · 대상 · 정확한 시각`}),`이 함께 나오고, 창 아래에 전체 건수가 표시됩니다. 연결 정보나 테이블 구성이 언제 바뀌었는지 되짚을 때 사용하세요.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`ai가-sql을-생성하는-흐름`,children:`AI가 SQL을 생성하는 흐름`}),`\n`,_jsx(_components.p,{children:`에이전트에 DB를 연결하면, 사용자 질문이 다음 과정을 거쳐 SQL로 변환됩니다.`}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[사용자 질문] --> B[DB 스키마 조회]\n B --> C[메모리 시맨틱 검색]\n C --> D[\"과거 성공 쿼리 + 비즈니스 규칙 + SQL 예제 수집\"]\n D --> E[AI가 SQL 생성]\n E --> F{쓰기 구문?}\n F -->|예 · 변경 허용 꺼짐| G[차단]\n F -->|예 · 변경 허용 켜짐| G2[사용자 승인 대기] --> H\n F -->|아니오 · SELECT| H[SQL 실행]\n H --> I{성공?}\n I -->|실패| J[\"자동 재시도 (최대 3회)\"]\n J --> E\n I -->|성공| K[\"결과 표시 (표·차트)\"]\n K --> L[\"성공 쿼리를 메모리에 자동 저장 (few-shot 누적)\"]`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`성공한 쿼리가 자동으로 메모리에 누적됩니다. 사용할수록 AI가 비슷한 질문에 더 정확한 SQL을 생성하게 됩니다.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`메모리-시스템`,children:`메모리 시스템`}),`\n`,_jsx(_components.p,{children:`DbSphere는 4종류의 메모리를 활용하여 SQL 생성 정확도를 높입니다. 메모리가 많을수록 AI가 더 정확한 쿼리를 작성합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`메모리`}),_jsx(_components.th,{style:{textAlign:`center`},children:`뱃지`}),_jsx(_components.th,{children:`내용`}),_jsx(_components.th,{children:`생성 방식`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`DDL 스키마`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`DDL 스키마`}),_jsx(_components.td,{children:`테이블 구조 + 컬럼 설명`}),_jsx(_components.td,{children:`스키마 추출 시 자동`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQL 퓨샷`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`SQL 퓨샷`}),_jsx(_components.td,{children:`질문-SQL 쌍 (과거 성공 쿼리)`}),_jsxs(_components.td,{children:[`쿼리 성공 시 `,_jsx(_components.strong,{children:`자동 누적`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문서 조사`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`문서 조사`}),_jsx(_components.td,{children:`비즈니스 용어, 규칙, 컨텍스트`}),_jsx(_components.td,{children:`수동 입력`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQL 예제`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`SQL 예제`}),_jsx(_components.td,{children:`참조용 SQL 예제 (use case, 태그)`}),_jsx(_components.td,{children:`수동 입력 또는 추출 시 자동`})]})]})]}),`\n`,_jsx(Frame,{caption:`메모리 탭에서 4종 메모리를 확인하고 관리할 수 있습니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=8046fcb61f673d94ab405252338b7f8f`,alt:`메모리 목록`,\"data-og-width\":`791`,width:`791`,\"data-og-height\":`213`,height:`213`,\"data-path\":`images/workspace/database-memory.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=08a08bb361596f28cea4298f2eebcdb6 280w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=b46b63c48488da4f3adc5162a580a610 560w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=0d74262f0d349e6cdd78c9751f7d6cf0 840w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=d4e861ea3981c59e3d09653f7f45b9f3 1100w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=73a9fe41639a8465b8068835a6506ab6 1650w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-memory.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=11d3949900b383a69608d8e284f3f372 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`ddl-스키마-설명으로-정확도-높이기`,children:`DDL 스키마 설명으로 정확도 높이기`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`DDL 스키마`}),` 메모리의 테이블·컬럼에 비즈니스 설명을 추가하면 AI의 SQL 생성 정확도가 크게 향상됩니다. 스키마 추출 후 `,_jsx(_components.strong,{children:`메모리 탭 → DDL 스키마 클릭 → 편집`}),`에서 각 테이블과 컬럼에 한국어 설명을 입력합니다.`]}),`\n`,_jsx(Frame,{caption:`메모리 탭 → DDL 스키마 → 편집에서 테이블·컬럼 설명을 입력합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=18ab1d574aae08b4948c3d5ef77bf4ce`,alt:`DDL 스키마 설명 입력`,\"data-og-width\":`989`,width:`989`,\"data-og-height\":`836`,height:`836`,\"data-path\":`images/workspace/database-schema-desc.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?w=280\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=3bdec3ce4dca9d269c815ade8bd48a0a 280w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?w=560\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=d2170bc7d2ad9c697373ffdaf3299d91 560w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?w=840\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=43e9083709535e052208a61715f5b65a 840w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=6473beaf35e70cf5d80dcda2b4155dbd 1100w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=355cef83b1c5edb7f28f06f074fdb5bf 1650w, https://mintcdn.com/cloocus/Q-yPA47cBazgesjY/images/workspace/database-schema-desc.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Q-yPA47cBazgesjY\u0026q=85\u0026s=94f9894cb4f1291825f166d267a0b5a4 2500w`})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`스키마 추출 시 LLM이 테이블·컬럼 설명과 샘플 Q\u0026A를 자동 생성하도록 설정할 수도 있습니다. 자동 생성 결과를 검토하고 보정하면 정확도가 더 높아집니다.`})}),`\n`,_jsx(Accordion,{title:`스키마 설명 예시`,id:`-1`,children:_jsx(CodeBlock,{numberOfLines:`9`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`테이블: orders`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`설명: 주문 내역 테이블`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`컬럼:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- order_id: 주문 고유 번호`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- customer_id: 고객 ID (customers 테이블 참조)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- order_date: 주문 일시`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- total_amount: 총 주문 금액 (원)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- status: 주문 상태 (pending/confirmed/shipped/delivered)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),`\n`,_jsx(Heading,{level:`3`,id:`sql-퓨샷이-핵심`,children:`SQL 퓨샷이 핵심`}),`\n`,_jsxs(_components.p,{children:[`SQL 퓨샷은 `,_jsx(_components.strong,{children:`성공한 쿼리가 자동으로 저장`}),`되는 few-shot learning 메모리입니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`center`},children:`사용 횟수`}),_jsx(_components.th,{style:{textAlign:`center`},children:`SQL 퓨샷`}),_jsx(_components.th,{children:`AI 동작`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:`처음`}),_jsx(_components.td,{style:{textAlign:`center`},children:`0건`}),_jsx(_components.td,{children:`스키마만 보고 SQL 추측`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:`5회`}),_jsx(_components.td,{style:{textAlign:`center`},children:`5건`}),_jsx(_components.td,{children:`유사한 과거 쿼리 참고하여 생성`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:`50회+`}),_jsx(_components.td,{style:{textAlign:`center`},children:`50건+`}),_jsx(_components.td,{children:`검증된 패턴으로 정확한 SQL 생성`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`문서-조사-활용`,children:`문서 조사 활용`}),`\n`,_jsx(_components.p,{children:`AI가 모르는 비즈니스 규칙을 문서로 알려줄 수 있습니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`용어 (term)`})}),_jsx(_components.td,{children:`“MRR은 Monthly Recurring Revenue의 약자로 monthly_revenue 컬럼에 저장됨”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`규칙 (rule)`})}),_jsx(_components.td,{children:`“매출 집계 시 status=‘cancelled’인 주문은 반드시 제외해야 함”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`컨텍스트 (context)`})}),_jsx(_components.td,{children:`“고객 등급은 S/A/B/C 4단계이며 S가 가장 높음”`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`AI가 틀린 SQL을 생성하는 패턴이 반복되면, `,_jsx(_components.strong,{children:`문서 조사에 해당 규칙을 추가`}),`하세요. AI가 다음 질문부터 해당 규칙을 참고합니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`데이터-시각화`,children:`데이터 시각화`}),`\n`,_jsxs(_components.p,{children:[`SQL 실행 결과는 `,_jsx(_components.strong,{children:`기본적으로 표로 제공`}),`됩니다. `,_jsx(_components.strong,{children:`“차트로 보여줘”처럼 요청하면`}),` 데이터에 맞는 차트로 시각화하고, 결과 상단의 `,_jsx(_components.strong,{children:`차트 타입 토글`}),`로 직접 전환할 수 있습니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`차트 타입`}),_jsx(_components.th,{children:`적합한 데이터`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`막대 (Bar)`})}),_jsx(_components.td,{children:`카테고리별 비교`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`선 (Line)`})}),_jsx(_components.td,{children:`시계열 추이`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`파이 (Pie)`})}),_jsx(_components.td,{children:`비율/구성`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`산점도 (Scatter)`})}),_jsx(_components.td,{children:`상관관계`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`히트맵 (Heatmap)`})}),_jsx(_components.td,{children:`교차 분석`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`히스토그램`})}),_jsx(_components.td,{children:`분포`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`그룹 막대`})}),_jsx(_components.td,{children:`다차원 비교`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`표 (Table)`})}),_jsx(_components.td,{children:`상세 데이터`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`차트로 요청하면 데이터 구조에 맞는 차트 타입을 `,_jsx(_components.strong,{children:`추천·자동 선택`}),`하며, 상단 토글에서 다른 타입으로 변경할 수 있습니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`데이터베이스-조회`,children:`데이터베이스 조회`}),`\n`,_jsx(Heading,{level:`3`,id:`에이전트에-연결`,children:`에이전트에 연결`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`에이전트 편집 화면에서 “데이터베이스” 섹션의 `,_jsx(_components.strong,{children:`“데이터베이스 선택”`}),` 클릭`]}),`\n`,_jsx(_components.li,{children:`연결할 데이터베이스 선택`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`적용`}),` 클릭`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`채팅에서-사용`,children:`채팅에서 사용`}),`\n`,_jsx(_components.p,{children:`데이터베이스가 연결된 에이전트와 대화하면, AI가 질문을 분석하여 자동으로 SQL을 생성하고 실행합니다.`}),`\n`,_jsx(CodeBlock,{numberOfLines:`12`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`사용자: 지난 분기 대비 이번 분기 매출 성장률은?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`AI: 분기별 매출을 분석했습니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| 분기 | 매출액 | 전분기 대비 |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`|------|--------|------------|`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| Q4 2024 | ₩12.5억 | - |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| Q1 2025 | ₩14.2억 | +13.6% |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`이번 분기 매출은 전분기 대비 13.6% 성장했습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`주요 성장 요인: 신규 고객 유치(+23%), 기존 고객 재구매율 상승(+8%)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`질문-예시`,children:`질문 예시`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`매출 분석`,id:`%EB%A7%A4%EC%B6%9C-%EB%B6%84%EC%84%9D`,children:_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 이번 달 매출 얼마야?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 지난주 일별 매출 추이 보여줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 매출 TOP 10 고객 알려줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 제품 카테고리별 매출 비중은?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`고객 분석`,id:`%EA%B3%A0%EA%B0%9D-%EB%B6%84%EC%84%9D`,children:_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 이번 달 신규 가입 고객 수는?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- VIP 고객 목록 보여줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 최근 3개월간 구매하지 않은 고객은?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 고객 지역별 분포 알려줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`재고 관리`,id:`%EC%9E%AC%EA%B3%A0-%EA%B4%80%EB%A6%AC`,children:_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 재고가 10개 미만인 상품 알려줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 이번 주 입고 예정 상품은?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 재고 회전율이 낮은 상품 TOP 5는?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`인사 관리`,id:`%EC%9D%B8%EC%82%AC-%EA%B4%80%EB%A6%AC`,children:_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 부서별 인원 현황 보여줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 이번 달 입사/퇴사자 수는?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 평균 근속연수는?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`sql-실행-결과-확인`,children:`SQL 실행 결과 확인`}),`\n`,_jsxs(_components.p,{children:[`AI 응답 하단에 `,_jsx(_components.strong,{children:`“SQL Query” 버튼`}),`이 표시됩니다. 클릭하면 실제 실행된 SQL과 결과를 상세하게 확인할 수 있습니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`기능`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQL 보기`})}),_jsx(_components.td,{children:`실행된 SQL을 포맷팅된 형태로 표시 (키워드 대문자, 들여쓰기 적용)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SQL 복사`})}),_jsx(_components.td,{children:`클립보드에 SQL 복사 — 별도 쿼리 도구에서 재실행할 때 유용`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`결과 테이블`})}),_jsx(_components.td,{children:`쿼리 결과를 표 형태로 확인`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`결과 데이터는 `,_jsx(_components.strong,{children:`최대 100행`}),`까지 표시됩니다. 전체 행 수가 100행을 초과하면 “Showing 100 of N rows” 안내가 표시됩니다. 전체 데이터가 필요하면 **채팅 결과 표 우측 상단의 `,_jsx(_components.code,{children:`CSV로 내보내기`}),`**로 내려받으세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`db-문법-차이`,children:`DB 문법 차이`}),`\n`,_jsxs(_components.p,{children:[`각 DB는 SQL 문법이 조금씩 다릅니다. Cloosphere는 자연어 → SQL 변환 시 `,_jsx(_components.strong,{children:`DB별 문법 규칙을 시스템 프롬프트에 동적으로 주입`}),`해 AI가 올바른 SQL을 생성하도록 유도합니다. 다만 다음 항목은 `,_jsx(_components.strong,{children:`사용자가 의도를 명확히 표현하면 더 정확한 SQL이 생성`}),`됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`핵심-차이-비교`,children:`핵심 차이 비교`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{style:{textAlign:`center`},children:`PostgreSQL`}),_jsx(_components.th,{style:{textAlign:`center`},children:`MySQL`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Oracle`}),_jsx(_components.th,{style:{textAlign:`center`},children:`MSSQL/Synapse/Fabric`}),_jsx(_components.th,{style:{textAlign:`center`},children:`SQLite`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Snowflake`}),_jsx(_components.th,{style:{textAlign:`center`},children:`BigQuery`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Databricks`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`식별자 인용`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`\"name\"`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:\"`name`\"})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`\"NAME\"`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`[name]`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`\"name\"`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`\"NAME\"`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:\"`name`\"})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:\"`name`\"})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LIMIT 표현`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`LIMIT n`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`LIMIT n`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`FETCH FIRST n ROWS ONLY`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`TOP n`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`LIMIT n`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`LIMIT n`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`LIMIT n`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`LIMIT n`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`날짜 리터럴`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`'2026-04-26'`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`'2026-04-26'`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`TO_DATE('2026-04-26', 'YYYY-MM-DD')`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`'2026-04-26'`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`'2026-04-26'`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`'2026-04-26'`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`DATE '2026-04-26'`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`'2026-04-26'`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`날짜 포맷 함수`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`TO_CHAR()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`DATE_FORMAT()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`TO_CHAR()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`FORMAT()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`strftime()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`TO_CHAR()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`FORMAT_DATE()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`date_format()`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`날짜 산술`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`+ INTERVAL '1 day'`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`DATE_ADD(d, INTERVAL 1 DAY)`})}),_jsxs(_components.td,{style:{textAlign:`center`},children:[_jsx(_components.code,{children:`+ 1`}),` (직접)`]}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`DATEADD(day, 1, d)`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`date(d, '+1 day')`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`DATEADD(day, 1, d)`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`DATE_ADD(d, INTERVAL 1 DAY)`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`date_add(d, 1)`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문자열 연결`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`||`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`CONCAT()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`||`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:_jsx(_components.code,{children:`+`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`||`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`||`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`CONCAT()`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.code,{children:`||`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`빈 문자열 = NULL`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`✓ ⚠️`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✗`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`대소문자 민감 (식별자)`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`따옴표 시 ✓`}),_jsx(_components.td,{style:{textAlign:`center`},children:`기본 ✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`대문자 기본`}),_jsx(_components.td,{style:{textAlign:`center`},children:`기본 ✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`따옴표 시 ✓`}),_jsx(_components.td,{style:{textAlign:`center`},children:`따옴표 시 ✓`}),_jsx(_components.td,{style:{textAlign:`center`},children:`기본 ✗`}),_jsx(_components.td,{style:{textAlign:`center`},children:`따옴표 시 ✓`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`시스템-자동-보정-vs-사용자-책임`,children:`시스템 자동 보정 vs 사용자 책임`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`자동으로 처리되는 것:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`대시보드 기간 필터(`,_jsx(_components.code,{children:`$st`}),`/`,_jsx(_components.code,{children:`$ed`}),` 플레이스홀더): DB별 날짜 리터럴로 자동 변환`]}),`\n`,_jsx(_components.li,{children:`지식 그래프 값 추출 시 식별자 인용: DB별 따옴표 자동 선택`}),`\n`,_jsx(_components.li,{children:`AI에 전달되는 시스템 프롬프트에 DB별 문법 규칙 동적 주입 (LIMIT, 날짜, 식별자 등)`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`사용자/AI가 신경 써야 하는 것:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`자연어 쿼리에 한글·특수문자 컬럼명을 직접 적을 때 — AI가 따옴표를 누락하면 실패할 수 있음`}),`\n`,_jsx(_components.li,{children:`Oracle 빈 문자열 비교 (아래 Oracle 특이점 섹션 참조)`}),`\n`,_jsx(_components.li,{children:`복잡한 윈도우 함수·CTE 같은 고급 SQL은 DB별 지원 차이가 있어 AI 생성 결과 검증 필요`}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`oracle-db-특이점`,children:`Oracle DB 특이점`}),`\n`,_jsx(_components.p,{children:`Oracle은 ANSI SQL과 일부 동작이 달라 사용자가 알아둘 만한 항목이 있습니다.`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`빈 문자열은 NULL로 처리됩니다 ⚠️`,icon:`circle-exclamation`,id:`null`,children:[_jsxs(_components.p,{children:[`Oracle은 `,_jsx(_components.code,{children:`''`}),`(빈 문자열)을 `,_jsx(_components.code,{children:`NULL`}),`과 동일하게 취급합니다. 따라서 다음 같은 조건은 `,_jsx(_components.strong,{children:`항상 0행을 반환`}),`합니다:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ❌ 모두 잘못된 패턴 (Oracle)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` col `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ''`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` col `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ''`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` TRIM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(col) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ''`})]}),`\n`]})})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`올바른 사용:`})}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ✅ NULL 검사로 대체`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` col `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`IS NOT NULL`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` TRIM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(col) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`IS NOT NULL`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Cloosphere의 시스템 프롬프트에 이 규칙이 포함되어 있어 AI가 자동으로 회피하지만, 자연어 쿼리에서 `,_jsx(_components.strong,{children:`“비어있지 않은 항목”`}),` 같은 모호한 표현 사용 시 0행이 반환되면 이 패턴을 의심하세요.`]})]}),_jsxs(Accordion,{title:`날짜 리터럴은 TO_DATE() 사용`,icon:`calendar`,id:`to-date`,children:[_jsx(_components.p,{children:`다른 DB와 달리 Oracle은 문자열을 자동으로 날짜로 캐스팅하지 않습니다.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ❌ Oracle에서 실패`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` created_at `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '2026-04-01'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ✅ Oracle 권장`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` created_at `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` TO_DATE(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'2026-04-01'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'YYYY-MM-DD'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`BI 대시보드의 기간 필터(`,_jsx(_components.code,{children:`$st`}),`/`,_jsx(_components.code,{children:`$ed`}),`)는 Oracle 사용 시 자동으로 `,_jsx(_components.code,{children:`TO_DATE(...)`}),` 형태로 치환됩니다. 그러나 SQL 결과 화면에서 직접 SQL을 작성할 때는 사용자가 명시해야 합니다.`]})]}),_jsxs(Accordion,{title:`날짜 산술은 INTERVAL 대신 직접 가감`,icon:`plus-minus`,id:`interval`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ❌ Oracle은 INTERVAL '1 day' 미지원`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` created_at `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` SYSDATE`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` -`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` INTERVAL `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'1 day'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ✅ Oracle 권장`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` created_at `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` SYSDATE`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` -`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`})]}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`DATE_TRUNC()`}),` 대신 `,_jsx(_components.code,{children:`TRUNC(col, 'DD')`}),`, 요일 추출은 `,_jsx(_components.code,{children:`EXTRACT(DOW FROM col)`}),` 대신 `,_jsx(_components.code,{children:`TO_CHAR(col, 'D')`}),`를 사용합니다.`]})]}),_jsxs(Accordion,{title:`한글·특수문자 컬럼명 인용`,icon:`quote-left`,id:`-2`,children:[_jsxs(_components.p,{children:[`Oracle에서 한글 컬럼 별칭(`,_jsx(_components.code,{children:`AS 공장코드`}),`)을 그대로 쓰면 `,_jsx(_components.code,{children:`ORA-00936: missing expression`}),` 오류가 발생합니다.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ❌ Oracle 실패`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` plant_code `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`AS`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 공장코드 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` plants`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ✅ Oracle 권장`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` plant_code `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`AS`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"공장코드\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` plants`})]}),`\n`]})})}),_jsx(_components.p,{children:`이 규칙은 시스템 프롬프트에 포함되어 AI가 따옴표를 자동으로 적용하지만, 한글 컬럼이 많은 환경에서는 결과를 확인하고 누락 시 직접 수정하세요.`})]}),_jsx(Accordion,{title:`LIMIT 대신 FETCH FIRST`,icon:`arrow-down-1-9`,id:`limit-fetch-first`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`sql`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`sql`,children:_jsxs(_components.code,{language:`sql`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ❌ Oracle 12c 미만 또는 잘못된 사용`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` users `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`LIMIT`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ✅ Oracle 12c+`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` users `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`FETCH`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FIRST`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` ROWS`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ONLY`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`-- ✅ Oracle 11g 호환 (서브쿼리)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`SELECT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` *`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` FROM`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` users) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`WHERE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ROWNUM `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10`})]}),`\n`]})})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`보안`,children:`보안`}),`\n`,_jsx(Heading,{level:`3`,id:`데이터-변경-제어`,children:`데이터 변경 제어`}),`\n`,_jsxs(_components.p,{children:[`DbSphere는 `,_jsx(_components.strong,{children:`기본적으로 읽기 전용`}),`입니다. 다만 이는 고정된 성질이 아니라 `,_jsx(_components.strong,{children:`데이터베이스마다 켜고 끌 수 있는 설정`}),`입니다.`]}),`\n`,_jsxs(_components.p,{children:[`DB 설정 모달 최상단의 `,_jsx(_components.strong,{children:`데이터 변경 허용`}),` 스위치가 이를 결정합니다. 화면 설명 그대로:`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`끔: 에이전트가 SELECT (읽기 전용) 만 실행 가능. 켬: INSERT/UPDATE/DELETE/DDL 도 가능하지만 매 호출마다 사용자 승인이 필요합니다.`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsxs(_components.th,{children:[_jsx(_components.strong,{children:`꺼짐`}),` (기본값)`]}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`켜짐`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`SELECT · 집계 함수 · JOIN · 서브쿼리`}),_jsx(_components.td,{children:`즉시 실행`}),_jsx(_components.td,{children:`즉시 실행`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`INSERT · UPDATE · DELETE`}),_jsx(_components.td,{children:`차단`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`사용자 승인 후 실행`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DDL (CREATE, DROP, ALTER, TRUNCATE, GRANT)`}),_jsx(_components.td,{children:`차단`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`사용자 승인 후 실행`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`분류 불가 구문 · 여러 구문 동시 실행`}),_jsx(_components.td,{children:`차단`}),_jsx(_components.td,{children:`쓰기로 취급 → 승인 필요`})]})]})]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`데이터 변경 허용을 켜면 에이전트가 실제로 데이터를 바꿀 수 있습니다.`}),` 읽기 전용을 전제로 보안 검토나 접근 승인을 진행 중이라면, 대상 데이터베이스에서 이 스위치가 꺼져 있는지 반드시 확인하세요.`]}),_jsxs(_components.p,{children:[`이 스위치는 `,_jsx(_components.strong,{children:`관리자도 우회할 수 없습니다.`}),` 관리자는 접근 권한(ACL)은 통과하지만 이 안전 스위치는 그대로 적용받습니다.`]})]}),`\n`,_jsx(Heading,{level:`4`,id:`쓰기-승인-흐름`,children:`쓰기 승인 흐름`}),`\n`,_jsx(_components.p,{children:`변경 허용이 켜진 상태에서 에이전트가 쓰기 SQL을 만들면, 바로 실행되지 않고 채팅에 승인 카드가 나타납니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`카드 구성`}),_jsx(_components.th,{children:`내용`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`승인 대기`}),` 배지`]}),_jsx(_components.td,{children:`실행 대기 상태 표시`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`만료 시간`}),_jsx(_components.td,{children:`이 시간이 지나면 요청이 자동으로 사라집니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`SQL 원문`}),_jsx(_components.td,{children:`에이전트가 생성한 구문 전체`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`영향 행 미리보기`}),_jsx(_components.td,{children:`변경 대상 데이터 (조회 가능한 경우)`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`커밋`}),` / `,_jsx(_components.strong,{children:`롤백`})]}),_jsx(_components.td,{children:`커밋해야 실제로 반영되고, 롤백하면 취소됩니다`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`변경 허용이 필요하더라도, 아래 `,_jsx(_components.a,{href:`#%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4-%EA%B3%84%EC%A0%95-%EC%84%A4%EC%A0%95`,children:`데이터베이스 계정 설정`}),` 의 최소 권한 원칙은 그대로 지키는 편이 안전합니다. 계정 권한과 이 스위치는 서로 독립된 두 겹의 방어선입니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`자격-증명-보호`,children:`자격 증명 보호`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`데이터베이스 비밀번호는 암호화하여 저장합니다`}),`\n`,_jsx(_components.li,{children:`연결 정보는 접근 권한이 있는 사용자만 확인할 수 있습니다`}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`베스트-프랙티스`,children:`베스트 프랙티스`}),`\n`,_jsx(Heading,{level:`3`,id:`데이터베이스-계정-설정`,children:`데이터베이스 계정 설정`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`전용 계정 생성`}),`: AI 전용 읽기 전용 계정을 만드세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`최소 권한 부여`}),`: 필요한 테이블에 대해서만 SELECT 권한을 부여하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`쿼리 제한`}),`: 타임아웃과 결과 행 수 제한을 설정하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`테이블-선택`,children:`테이블 선택`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`필요한 것만 선택`}),`: 모든 테이블을 연결하면 AI가 혼란스러워질 수 있습니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`민감 데이터 제외`}),`: 개인정보, 비밀번호가 포함된 테이블은 반드시 제외하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`관련 테이블 함께 선택`}),`: JOIN이 필요한 테이블은 함께 선택하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`스키마-설명-작성`,children:`스키마 설명 작성`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`한국어 설명 권장`}),`: 업무 용어를 사용하여 테이블과 컬럼을 설명하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`비즈니스 컨텍스트 추가`}),`: “status” 컬럼의 가능한 값과 의미를 기술하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`테이블 관계 명시`}),`: 외래 키 관계와 JOIN 조건을 설명하세요`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`트러블슈팅`,children:`트러블슈팅`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`연결 테스트가 실패합니다`,icon:`triangle-exclamation`,id:`-3`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`원인`}),_jsx(_components.th,{children:`해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`네트워크 문제`}),_jsx(_components.td,{children:`방화벽 규칙, VPN 연결 상태 확인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`인증 실패`}),_jsx(_components.td,{children:`계정, 비밀번호, 권한 재확인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`포트 차단`}),_jsx(_components.td,{children:`DB 포트가 열려 있는지 확인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`SSL 설정`}),_jsx(_components.td,{children:`SSL 인증서 요구 여부 확인`})]})]})]})}),_jsx(Accordion,{title:`AI가 잘못된 SQL을 생성합니다`,icon:`triangle-exclamation`,id:`ai-sql`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`원인`}),_jsx(_components.th,{children:`해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`스키마 설명 부족`}),_jsx(_components.td,{children:`테이블, 컬럼에 상세 설명 추가`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`비즈니스 규칙 미반영`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`문서 조사 메모리`}),`에 규칙 추가`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`관련 테이블 누락`}),_jsx(_components.td,{children:`JOIN이 필요한 테이블을 함께 선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`질문이 모호함`}),_jsx(_components.td,{children:`구체적인 조건(날짜 범위, 필터)을 포함하여 질문`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`과거 참고 쿼리 없음`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`SQL 예제 메모리`}),`에 올바른 쿼리 예제 추가`]})]})]})]})}),_jsx(Accordion,{title:`응답이 느립니다`,icon:`triangle-exclamation`,id:`-4`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`원인`}),_jsx(_components.th,{children:`해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`대용량 데이터`}),_jsx(_components.td,{children:`날짜 범위 등 조건을 추가하여 질문`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`복잡한 쿼리`}),_jsx(_components.td,{children:`질문을 단순화하거나 여러 질문으로 분리`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DB 성능 문제`}),_jsx(_components.td,{children:`인덱스 최적화, DB 리소스 확인`})]})]})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`데이터가 변경될 수 있나요?`,icon:`circle-question`,id:`-5`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`기본값은 읽기 전용이라 변경되지 않습니다.`}),` SELECT가 아닌 구문은 차단됩니다.`]}),_jsxs(_components.p,{children:[`다만 데이터베이스마다 DB 설정 모달에서 `,_jsx(_components.strong,{children:`데이터 변경 허용`}),`을 켤 수 있고, 켜면 에이전트가 INSERT·UPDATE·DELETE·DDL도 실행할 수 있습니다. 이 경우에도 바로 반영되지는 않고 `,_jsx(_components.strong,{children:`매 호출마다 승인 카드가 떠서 사용자가 커밋해야`}),` 적용됩니다.`]}),_jsxs(_components.p,{children:[`읽기 전용을 보장해야 한다면 해당 데이터베이스에서 이 스위치가 꺼져 있는지 확인하세요 — 관리자도 이 스위치는 우회하지 못합니다. 자세한 내용은 `,_jsx(_components.a,{href:`#%EB%8D%B0%EC%9D%B4%ED%84%B0-%EB%B3%80%EA%B2%BD-%EC%A0%9C%EC%96%B4`,children:`데이터 변경 제어`}),` 를 참고하세요.`]})]}),_jsx(Accordion,{title:`실행된 SQL을 볼 수 있나요?`,icon:`circle-question`,id:`sql`,children:_jsx(_components.p,{children:`네, AI 응답에서 생성된 SQL을 확인할 수 있습니다. 추적에서도 실행된 SQL과 결과를 상세하게 확인할 수 있습니다.`})}),_jsx(Accordion,{title:`여러 테이블을 JOIN할 수 있나요?`,icon:`circle-question`,id:`join`,children:_jsx(_components.p,{children:`네, 관련 테이블을 모두 선택하고 테이블 간 관계를 스키마 설명에 기술하면 AI가 적절한 JOIN 쿼리를 생성합니다.`})}),_jsx(Accordion,{title:`한 에이전트에 여러 데이터베이스를 연결할 수 있나요?`,icon:`circle-question`,id:`-6`,children:_jsxs(_components.p,{children:[`네, 에이전트에 여러 데이터베이스를 연결하면 AI가 질문에 따라 적절한 데이터베이스를 자동으로 선택합니다. 이때 각 DB의 `,_jsx(_components.strong,{children:`도구 설명`}),`을 구체적으로 작성하면 선택 정확도가 높아집니다.`]})}),_jsx(Accordion,{title:`스키마 추출 시 모델을 선택하면 뭐가 달라지나요?`,icon:`circle-question`,id:`-7`,children:_jsxs(_components.p,{children:[`모델을 선택하면 LLM이 테이블/컬럼에 `,_jsx(_components.strong,{children:`비즈니스 설명을 자동 생성`}),`하고, `,_jsx(_components.strong,{children:`샘플 Q\u0026A 쌍`}),`도 만들어줍니다. 모델 없이 추출하면 DDL 구조만 저장됩니다. 모델 선택을 권장합니다.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`관련-페이지`,children:`관련 페이지`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`에이전트`,icon:`robot`,href:`/ko/workspace/agents`,children:_jsx(_components.p,{children:`DB를 에이전트에 연결하여 자연어 질의 활성화`})}),_jsx(Card,{title:`용어집`,icon:`book`,href:`/ko/workspace/glossary`,children:_jsx(_components.p,{children:`DB 비즈니스 용어를 AI에게 알려주어 정확도 향상`})}),_jsx(Card,{title:`추적`,icon:`chart-line`,href:`/ko/monitoring/tracing`,children:_jsx(_components.p,{children:`SQL 생성·실행 과정을 단계별로 추적`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"데이터베이스","description":"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드","href":"/ko/workspace/database"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"예시","slug":"예시","depth":3,"children":[]},{"title":"NL-to-SQL 파이프라인","slug":"nl-to-sql-파이프라인","depth":2,"children":[]},{"title":"지원 데이터베이스","slug":"지원-데이터베이스","depth":2,"children":[]},{"title":"데이터베이스 연결","slug":"데이터베이스-연결","depth":2,"children":[{"title":"활동 이력","slug":"활동-이력","depth":3,"children":[]}]},{"title":"AI가 SQL을 생성하는 흐름","slug":"ai가-sql을-생성하는-흐름","depth":2,"children":[]},{"title":"메모리 시스템","slug":"메모리-시스템","depth":2,"children":[{"title":"DDL 스키마 설명으로 정확도 높이기","slug":"ddl-스키마-설명으로-정확도-높이기","depth":3,"children":[]},{"title":"SQL 퓨샷이 핵심","slug":"sql-퓨샷이-핵심","depth":3,"children":[]},{"title":"문서 조사 활용","slug":"문서-조사-활용","depth":3,"children":[]}]},{"title":"데이터 시각화","slug":"데이터-시각화","depth":2,"children":[]},{"title":"데이터베이스 조회","slug":"데이터베이스-조회","depth":2,"children":[{"title":"에이전트에 연결","slug":"에이전트에-연결","depth":3,"children":[]},{"title":"채팅에서 사용","slug":"채팅에서-사용","depth":3,"children":[]},{"title":"질문 예시","slug":"질문-예시","depth":3,"children":[]},{"title":"SQL 실행 결과 확인","slug":"sql-실행-결과-확인","depth":3,"children":[]}]},{"title":"DB 문법 차이","slug":"db-문법-차이","depth":2,"children":[{"title":"핵심 차이 비교","slug":"핵심-차이-비교","depth":3,"children":[]},{"title":"시스템 자동 보정 vs 사용자 책임","slug":"시스템-자동-보정-vs-사용자-책임","depth":3,"children":[]}]},{"title":"Oracle DB 특이점","slug":"oracle-db-특이점","depth":2,"children":[]},{"title":"보안","slug":"보안","depth":2,"children":[{"title":"데이터 변경 제어","slug":"데이터-변경-제어","depth":3,"children":[]},{"title":"쓰기 승인 흐름","slug":"쓰기-승인-흐름","depth":4,"children":[]},{"title":"자격 증명 보호","slug":"자격-증명-보호","depth":3,"children":[]}]},{"title":"베스트 프랙티스","slug":"베스트-프랙티스","depth":2,"children":[{"title":"데이터베이스 계정 설정","slug":"데이터베이스-계정-설정","depth":3,"children":[]},{"title":"테이블 선택","slug":"테이블-선택","depth":3,"children":[]},{"title":"스키마 설명 작성","slug":"스키마-설명-작성","depth":3,"children":[]}]},{"title":"트러블슈팅","slug":"트러블슈팅","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"관련 페이지","slug":"관련-페이지","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"데이터베이스 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/database","matchLevel":0},"en":{"href":"/en/workspace/database","matchLevel":1}}},"lastModified":"2026-08-26T04:23:58.429Z","originalFileLocation":"ko/workspace/database.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"데이터베이스 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/workspace/database\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%A7%80%EC%8B%9D+%26+%EB%8D%B0%EC%9D%B4%ED%84%B0\u0026amp;title=%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4\u0026amp;description=NL-to-SQL+%EA%B8%B0%EB%B0%98+%EC%9E%90%EC%97%B0%EC%96%B4+%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4+%EC%A1%B0%ED%9A%8C+%E2%80%94+DbSphere+%EC%97%B0%EA%B2%B0+%EC%84%A4%EC%A0%95+%EB%B0%8F+%ED%99%9C%EC%9A%A9+%EA%B0%80%EC%9D%B4%EB%93%9C\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=429a9cd642998b2c688b4ea888133d4eab9d31344893d67ae3d8826370b322d0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"데이터베이스 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%A7%80%EC%8B%9D+%26+%EB%8D%B0%EC%9D%B4%ED%84%B0\u0026amp;title=%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4\u0026amp;description=NL-to-SQL+%EA%B8%B0%EB%B0%98+%EC%9E%90%EC%97%B0%EC%96%B4+%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4+%EC%A1%B0%ED%9A%8C+%E2%80%94+DbSphere+%EC%97%B0%EA%B2%B0+%EC%84%A4%EC%A0%95+%EB%B0%8F+%ED%99%9C%EC%9A%A9+%EA%B0%80%EC%9D%B4%EB%93%9C\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=429a9cd642998b2c688b4ea888133d4eab9d31344893d67ae3d8826370b322d0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/workspace/database\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/workspace/database.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/database\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/database\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/database\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/database#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/database\",\"name\":\"데이터베이스\",\"description\":\"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드\",\"dateModified\":\"2026-08-26T04:23:58.429Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/database#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/database#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"지식 \u0026 데이터\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/knowledge\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"데이터베이스\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/database\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/workspace/database#article\",\"headline\":\"데이터베이스\",\"name\":\"데이터베이스\",\"description\":\"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/database\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/database#webpage\"},\"dateModified\":\"2026-08-26T04:23:58.429Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/workspace/database.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","groups":[{"group":"워크스페이스","pages":[{"title":"워크스페이스 개요","href":"/ko/workspace/overview"}]},{"group":"AI 에이전트","pages":[{"title":"에이전트","href":"/ko/workspace/agents"},{"title":"에이전트 플로우","href":"/ko/workspace/flows"},{"title":"플로우 노드 레퍼런스","href":"/ko/workspace/flows-nodes"}]},{"group":"지식 \u0026 데이터","pages":[{"title":"지식기반","href":"/ko/workspace/knowledge"},{"title":"동적 필터 상세 가이드","href":"/ko/workspace/knowledge-filters"},{"title":"지식 그래프","description":"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조","href":"/ko/workspace/knowledge-graph"},{"title":"데이터베이스","href":"/ko/workspace/database"},{"title":"용어집","description":"도메인 전문 용어와 동의어를 관리하여 AI 답변의 정확도를 높이는 지식 사전","href":"/ko/workspace/glossary"}]},{"group":"안전","pages":[{"title":"가드레일","href":"/ko/workspace/guardrails"}]},{"group":"커스터마이징","pages":[{"title":"프롬프트","href":"/ko/workspace/prompts"},{"title":"스킬","href":"/ko/workspace/skills"},{"title":"도구","href":"/ko/workspace/tools"},{"title":"마켓플레이스","href":"/ko/workspace/marketplace"},{"title":"태그","href":"/ko/workspace/tags"}]}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","pages":[{"title":"모니터링","href":"/ko/monitoring/overview"}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/workspace/database"}]}]},"basePath":"","title":"데이터베이스 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}