PostgreSQL 쿼리 분석기

개요

PostgreSQL 데이터베이스에서 SQL 쿼리의 성능을 분석하고 최적화 제안을 제공하는 웹 애플리케이션입니다.

주요 기능

1. 쿼리 성능 분석

• SQL 쿼리 실행 및 실행 계획 분석
• EXPLAIN ANALYZE 자동 실행
• 실행 시간, 비용, 처리된 행 수 분석
• 리소스 사용량 분석

2. 최적화 제안

• 누락된 인덱스 감지 및 제안
• 비효율적인 쿼리 패턴 식별
• 성능 개선을 위한 권장사항 제공

3. 스키마 브라우저

• 데이터베이스 테이블 목록 조회
• 테이블 구조 및 인덱스 정보 표시
• 데이터 미리보기 기능

🚀 설치 및 실행

사전 요구사항

• Java 17+
• Maven 3.6+
• PostgreSQL 13+

빠른 시작

# 1. 저장소 클론
git clone https://github.com/yejinj/PostgreSQL-Query-Simulator.git
cd PostgreSQL-Query-Simulator

# 2. Docker로 PostgreSQL 시작
docker-compose up -d

# 3. 애플리케이션 실행
cd backend
mvn spring-boot:run

# 4. 웹 브라우저에서 접속
# http://localhost:8090

또는 자동 스크립트 사용:

./scripts/start.sh

데이터베이스 설정

backend/src/main/resources/application.yml 파일에서 데이터베이스 연결 정보를 설정합니다.

자세한 설정 방법은 SETUP.md를 참고하세요.

📊 사용 방법

1. 쿼리 실행 및 분석

1. 메인 페이지에서 분석할 SQL 쿼리를 입력
2. "쿼리 실행" 버튼 클릭
3. 실행 결과와 성능 분석 결과 확인
4. 최적화 제안사항 검토

2. 스키마 탐색

1. "스키마 브라우저" 메뉴 선택
2. 테이블 목록에서 원하는 테이블 선택
3. 테이블 구조 및 데이터 확인

📁 프로젝트 구조

PostgreSQL-Query-Simulator/
├── backend/              # 백엔드 (Spring Boot)
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/    # Java 소스 코드
│   │   │   └── resources/
│   │   │       ├── static/     # CSS, JS 정적 파일
│   │   │       └── templates/  # Thymeleaf 템플릿
│   │   └── test/
│   └── pom.xml          # Maven 빌드 설정
├── database/            # 데이터베이스 스크립트
│   ├── init_data.sql
│   └── *.sql
├── docs/               # 문서
│   ├── SETUP.md        # 설치 가이드
│   └── test_openai_analysis.md
├── scripts/            # 실행 스크립트
│   └── start.sh
├── docker-compose.yml  # Docker Compose 설정
└── README.md

🛠️ 기술 스택

• 백엔드: Spring Boot 3.2.1, Java 17
• 프론트엔드: Thymeleaf, HTML/CSS/JavaScript
• 데이터베이스: PostgreSQL 15
• 빌드 도구: Maven
• 컨테이너: Docker, Docker Compose

📝 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다.