Pgdbtemplate
lastmod 2026-11-16created 2025-10-202 edits
pgdbtemplate은 PostgreSQL 의 템플릿 데이터베이스 기능으로 테스트용 DB 를 만드는 Go 라이브러리이다. 마이그레이션을 한 번만 적용한 템플릿 DB 를 만들어 두고, 테스트마다 그 템플릿을 복제해 새 DB 를 받는다. 테스트마다 DB 를 만들고 마이그레이션을 다시 돌리는 방식보다 스키마가 복잡할수록 시간이 덜 든다. Andrei Polukhin 이 개인 프로젝트로 만들었다.
About
-
TestMain()에서TemplateManager를 한 번 초기화하고, 테스트마다CreateTestDatabase()로 DB 를 받아DropTestDatabase()로 지움. 끝에서Cleanup()이 남은 DB 와 템플릿을 모두 지움 - 템플릿 초기화는 mutex 로 보호하고, DB 이름은 타임스탬프와 atomic 카운터로 겹치지 않게 만듦.
go test -parallel N에서 그대로 씀 - Apple M4 Pro 벤치마크에서 DB 하나에 기존 방식 약 28.9~43.1ms, 템플릿 방식 약 28.2~28.8ms. 테이블 1개일 때 1.03배, 5개일 때 1.50배 빠름
- DB 500개를 만들 때 22.31초가 14.82초로 줄어 34% 빠르고, 작업당 메모리는 17% 적게 씀
- 연결은
pgx/v5,pgx/v4,lib/pq용 ConnectionProvider 를 별도 모듈로 제공 - 마이그레이션은 내장 SQL 파일 러너(파일 이름 알파벳 순)나 goose, golang-migrate, Atlas 어댑터를 씀. testcontainers-go 연동 예제 있음
- PostgreSQL 9.5 이상, Go 1.20 이상. MIT 라이선스