쿼리 실행 (NL2SQL)
MCP 클라이언트를 통해 자연어를 SQL로 변환하고 실행하는 NL2SQL 기능을 안내합니다.
NL2SQL이란?
NL2SQL(Natural Language to SQL)은 자연어 질문을 SQL 쿼리로 자동 변환하는 기능입니다. NeoSQL의 MCP 서버가 데이터베이스 스키마 정보를 AI에게 제공하므로, 테이블 이름이나 컬럼 이름을 정확히 몰라도 원하는 데이터를 조회할 수 있습니다.
사용 방법
MCP 클라이언트에서 NL2SQL을 사용하여 쿼리를 생성하고 실행합니다.
1
MCP 클라이언트에서 질문 입력
Claude Desktop, Cursor 등에서 자연어로 데이터 조회를 요청합니다.
예: "지난 30일간 가입한 사용자 중 주문을 1건 이상 한 사용자 목록을 보여줘"
2
SQL 생성 및 실행
AI가 스키마 정보를 기반으로 SQL 쿼리를 생성하고, NeoSQL의 MCP 서버를 통해 데이터베이스에서 쿼리를 실행합니다.
3
결과 확인
실행 결과가 MCP 클라이언트에 표시됩니다. AI가 결과를 요약하거나 추가 분석을 제공할 수도 있습니다.
질문 예시
MCP 클라이언트에서 사용할 수 있는 질문 예시입니다.
| 자연어 질문 | 생성되는 SQL 유형 |
|---|---|
| "전체 사용자 수를 알려줘" | SELECT COUNT(*) |
| "주문 금액이 높은 순으로 상위 10개" | SELECT ... ORDER BY ... LIMIT |
| "월별 매출 합계를 보여줘" | SELECT ... GROUP BY ... SUM() |
| "주문이 없는 사용자 목록" | SELECT ... LEFT JOIN ... WHERE ... IS NULL |
| "지난주 대비 이번주 가입자 수 비교" | 서브쿼리 또는 CTE 활용 |
Tip
구체적으로 질문할수록 더 정확한 SQL이 생성됩니다. "매출"보다는 "orders 테이블의 total_amount 합계"처럼 구체적으로 표현하세요.