explorerhq/sql-explorer

SQL Explorer – LLM 기반 쿼리 작성 지원을 갖춘 Django 기반 BI 도구

개요 – 모든 Django 프로젝트에 연결하거나 독립적으로 실행할 수 있는 웹 애플리케이션으로, 사용자가 Django에서 지원하는 모든 데이터베이스에 대해 SQL 쿼리를 실행, 공유 및 시각화할 수 있으며 CSV/JSON 업로드도 지원합니다.

중요성 – 브라우저 내 편집기, 스키마 인식 자동 완성, 결과 시각화, 그리고 LLM(예: OpenAI)을 사용하여 쿼리를 초안 작성하거나 디버깅할 수 있는 선택적 AI 어시스턴트를 제공하여 데이터 활용 파이프라인을 가속화합니다. 이를 통해 SQL에 익숙하지 않은 사용자도 임시 분석을 수행할 수 있으며, 파워 유저의 요구 사항도 충족합니다.

주요 기능

• 다중 데이터베이스(Postgres, MySQL, SQLite 등) 및 사용자가 업로드한 CSV/JSON 파일에 연결.
• 스키마 도우미와 자동 완성을 갖춘 깔끔한 편집기에서 쿼리 작성.
• AI 기반 SQL 어시스턴트 – OpenAI(또는 호환) API 키를 제공하면 스키마 컨텍스트를 LLM 프롬프트에 자동으로 주입하여 자연어 지원을 받을 수 있습니다.
• 쿼리 저장, 기록 보기, 스냅샷 예약, 저장된 쿼리를 간단한 JSON API로 노출.
• 브라우저 내 분석: 빠른 통계, 피벗 테이블, 산점도 – Excel로 내보낼 필요가 없습니다.
• 매개변수화된 쿼리를 통해 SQL을 모르는 사용자를 위한 친숙한 UI 생성.
• 결과 이메일 발송, 로그 보기 및 데이터 내보내기.

시작하기

1. 저장소를 복제하고 docker compose up을 실행합니다(데모 Django 프로젝트 포함).
2. http://127.0.0.1:8000/explorer/에 접속하여 admin/admin으로 로그인합니다.
3. Docker 설정에는 프론트엔드 변경 사항을 실시간으로 반영하는 Vite 개발 서버도 포함되어 있습니다.

일반적인 워크플로우

1. 데이터 연결을 선택하거나 추가합니다.
2. 쿼리를 작성합니다(또는 AI 어시스턴트에게 생성을 요청합니다).
3. 쿼리를 실행하고 결과를 확인하며, 필요에 따라 시각화를 생성하거나 내보냅니다.
4. 쿼리를 저장하여 나중에 재사용하거나 팀원들과 공유합니다.

권장 사용자

• 이미 Django를 운영 중이며, 무거운 플랫폼을 배포하지 않고 내부 BI 계층이 필요한 팀.
• 빠르고 공유 가능한 SQL 대시보드와 간단한 시각화가 필요한 분석가.
• LLM을 활용하여 비기술 사용자의 데이터 탐색을 돕고자 하는 개발자.

링크

• 공식 사이트: https://www.sqlexplorer.io/
• 라이브 데모: https://demo.sqlexplorer.io/
• 문서: https://django-sql-explorer.readthedocs.io/en/latest/