RegreSQL
lastmod 2026-11-16created 2025-11-242 edits
RegreSQL은 PostgreSQL 용 SQL 회귀 테스트 도구이다. 프로젝트의 *.sql 파일을 찾아 데이터베이스에서 실행하고, 결과를 미리 저장해 둔 정상 결과와 비교하며 EXPLAIN 실행 계획의 변화도 추적한다. 스키마 마이그레이션이나 인덱스 변경으로 쿼리 결과나 성능이 조용히 달라지는 것을 배포 전에 잡는 것이 목적이다. Dimitri Fontaine 이 Mastering PostgreSQL 에서 만든 regresql 을 boringSQL 프로젝트가 포크해 확장했다.
About
- 언어·ORM 에 매이지 않고
.sql파일만 있으면 됨. 한 파일에 여러 쿼리를-- name:주석으로 나누고,:id·$1매개변수 값은 plan YAML 에 테스트 케이스별로 적음 - 흐름은
init→discover→add→update(정상 결과 저장) →test. 비교할 때 특정 열 무시, 행 순서 무시, 실수 오차 허용, JSONB 값 비교 가능 - EXPLAIN baseline 으로 비용·버퍼 변화를 추적하고 순차 스캔(seq scan)을 경고함. 테이블별로 경고를 오류로 올리는 severity 정책 지원
- PostgreSQL 18 과
pg_regresql확장으로 운영 DB 의 통계를 주입해 작은 로컬 DB 에서 운영과 같은 실행 계획을 재현함 - 스키마·마이그레이션으로 DB 스냅샷을 만들어 테스트마다 복원하고, 스냅샷에 태그를 붙여 마이그레이션 전후 결과를 비교함
- 출력 형식: console, pgTAP, JUnit, JSON, GitHub Actions 주석
- ORM 이 만든 쿼리는 같은 boringSQL 의 qshape 로
pg_stat_statements에서 뽑아 테스트 뼈대를 만듦 - Go 로 작성됨. Homebrew, macOS·Linux 바이너리,
go install로 설치 - BSD-2-Clause 라이선스