flyway 설정

gradle 설정

dependencies {
    implementation 'org.flywaydb:flyway-core'
}

패키지 설정

main > resource > db.migration 패키지 추가

마이그레이션 파일 이름 설정

V(숫자)__(언더바 2개)init.sql

V는 꼭 대문자로 할것

YAML 설정

spring:
  hibernate:
    ddl-auto: validate

ddl-auto설정

validate 는 실제 db와 entity mapping이 서로 같이 일을 할 수 있는 상태인지 확인만한다.

spring을 실행 하면 flyway가 같이 작동하면서 작성한 sql을 실행하고 hibernate가 entity와 db table이 올바르게 연결됬는지 확인한다.

이 과정에서 성공 또는 에러가 발생 할 수 있는데 db table을 보면 flyway_schema_history 테이블이 생성되는것을 확인 할 수 있다

flyway_schema_history에는 sql에서 작성했던 스크립트에 대한 정보가 저장된다.

주의점

만약 sql 파일을 작성하고 flyway가 작동하고 flyway_schema_history에 정보가 저장되었다면 그 이후 sql파일의 내용을 공백 하나라도 추가 삭제 하면안된다 ( 공백 하나라도 변경된다면 checksum missing 에러 발생)

DB 변경

예) Column 추가시

V2__init.sql파일을 만들어서 다음과 같이 작성

ALTER TABLE `testTable`
    ADD
        (
        `testColumn1` varchar(255),
        `testColumn2` varchar(255),
        `testColumn3` varchar(255)
        );

V1__init.sql은 이미 flyway가 실행 했기 때문에 변경 하면안됨

flyway가 V2 의 스크립트를 찾아서 적용하고 하이버네이트가 validate해서 문제 없으면 정상 작동된다.