콘텐츠로 이동
Search

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 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap