Sqldef
lastmod 2026-11-16created 2026-02-122 edits
sqldef는 원하는 스키마를 일반 SQL DDL 파일로 적어 두면 현재 데이터베이스와 비교해 필요한 마이그레이션 DDL 을 만들고 적용하는 스키마 관리 도구이다. 몇 번을 실행해도 결과가 같은 멱등 방식이며, Ruby DSL 을 쓰는 Ridgepole 에서 착안했지만 SQL 만 알면 되도록 했다.
About
- DB별 명령은
mysqldef(MySQL·MariaDB·TiDB),psqldef(PostgreSQL),sqlite3def(SQLite3),mssqldef(SQL Server). 접속 옵션은 각 DB 기본 클라이언트와 같음 -
--export로 현재 스키마를 뽑고, 파일을 고친 뒤--dry-run으로 미리 보고--apply로 적용 - DB 에 접속하지 않고 SQL 파일 두 개를 비교하는 오프라인 모드가 있어 CI 의 스키마 검증과 마이그레이션 스크립트 생성에 씀
-
-- @renamed from=old_name주석으로 테이블·컬럼·인덱스·ENUM 값의 이름 변경을 표현 - 의존성 없는 단일 바이너리와 Docker 이미지로 배포
- MIT 라이선스(파서는 Apache-2.0)
sqldef 개요
- 현재 스키마와 목표 스키마의 차이로
ALTER TABLE ... ADD COLUMN같은 DDL 을 만들고, 적용 후 다시 실행하면 변경 사항 없음으로 끝남
온라인 데모 기능
- 웹사이트 데모에서 DB 종류를 고르고 현재·목표 스키마를 넣으면 Up(현재→목표)과 Down(목표→현재) DDL 을 보여 줌. DROP 문 포함 여부는 "Enable DROP" 으로 정함
작동 방식
- 데모는 sqldef 의 WebAssembly 빌드로 브라우저 안에서 스키마를 비교함