DB 연결·쿼리 오류를 진단하는 프롬프트

언제 사용하나

커넥션 타임아웃, 풀 고갈, 쿼리 실패 등 DB 관련 오류를 진단할 때.

요청 전 확인

• 정확한 DB 오류 메시지와 코드(SQLSTATE 등)를 확보한다.
• 커넥션 풀 설정과 최근 트래픽 변화를 파악한다.

복사해서 쓰는 프롬프트

아래 DB 오류의 원인을 진단해줘.

오류 메시지: {{DB_ERROR}}
쿼리/코드: {{QUERY}}
풀/환경 설정: {{CONFIG}}

원하는 출력:
1. 오류 분류(연결/권한/문법/제약/락/타임아웃)와 근거
2. 가장 가능성 높은 원인과 확인 방법(로그/지표)
3. 커넥션 누수 여부 점검 포인트
4. 임시 완화책과 근본 해결책의 구분

placeholder 설명

• {{DB_ERROR}} : DB 오류 메시지
• {{QUERY}} : 실행 쿼리/코드
• {{CONFIG}} : 풀 크기·타임아웃 설정

입력 예시

{{DB_ERROR}} = "connection pool exhausted"

기대 결과

오류 분류, 원인 후보, 누수 점검, 완화/해결 구분.

검증 방법

지표(활성 커넥션 수)를 관찰하며 가설을 확인한다.

주의사항

• 접속 문자열의 비밀번호는 가린 채 공유한다.

관련 문서

• PostgreSQL 오류 코드: https://www.postgresql.org/docs/current/errcodes-appendix.html