[Spring Boot - 🐱PetClinic🐶] 3. Database🗂

🗂 Pet Clinic에서 기본적으로 지원하는 데이터베이스

• H2(default) - 인메모리 DB
• HSQLDB - 인메모리 DB
• MySQL - 일반 DB (user 추가 필요)
• PostgreSQL - 일반 DB (user 추가 필요)

🗂 H2 데이터베이스?

지금까지 오라클 DB와 MySQL밖에 다뤄보지 않아서 H2 DB는 생소했다. 그런데 Pet Clinic에서는 기본 DB로 H2 DB를 쓰고 있었다. H2 DB는 Java로 작성된 오픈소스 기반 데이터베이스라 설치하지 않고 사용(인메모리)할 수 있다는 특징이 있다. 설치하지 않고 사용하기 때문에 용량이 가볍고 웹용 콘솔(쿼리 툴)을 제공해 개발용 로컬 DB로 사용이 용이하다. 이밖에 특징들로 스프링부트가 지원하는 인메모리 관계형 데이터베이스라는 점, 로컬 환경, 테스트 환경에서 많이 쓰인다는 점 등이 있다. 또한, HSQLDB도 Java로 작성된 오픈소스 기반 인메모리 관계형 DB라고 한다.

인메모리와 일반 DB의 가장 큰 차이점은 휘발성/비휘발성인 것 같다. 용도에 따라 적절한 DB를 사용하면 될 것 같다. 실제 프로젝트를 진행할 때는 일반 DB를 써야겠지만 테스트 환경에서는 H2로도 충분할 것 같다.

🗂 Spring Boot에서 H2 데이터베이스 사용

H2 데이터베이스를 Spring Boot에서 사용하기 위해서는 application.properties에 다음과 같이 설정을 추가해주면 된다.

database=h2
spring.sql.init.schema-locations=classpath*:db/${database}/schema.sql
spring.sql.init.data-locations=classpath*:db/${database}/data.sql

🗂 다른 데이터베이스 사용

Pet Clinic Application은 spring-petclinic/src/main/resources 하위에 application.properties가 있고 같은 위치에 db 폴더가 있다. db 폴더 하위에는 데이터베이스별 폴더가 존재하고 그 하위에 각 DB의 쿼리문 형식에 맞는 schema 파일과 data 파일이 존재한다. 어플리케이션 구동 시 위의 파일들을 이용해 데이터베이스를 초기화한다. H2 말고 다른 데이터베이스를 사용하려면 database=h2에서 h2 대신 사용할 데이터베이스명을 입력한다. 인메모리 데이터베이스가 아닌 일반 데이터베이스를 사용하기 위해서는 application.properties에 profile을 지정해줘야 한다.

# application.properties에 다음 옵션 추가
# MySQL
spring.profiles.active=mysql
# PostgreSQL
spring.profiles.active=postgres

주의할 점은 일반 데이터베이스를 사용할 경우 각 데이터베이스에 사용자를 추가하고 권한 설정을 해줘야 한다는 점이다. 사용자 추가를 하지 않을 경우 어플리케이션 실행 시 연결이 거부된다고 나온다. 사용자와 비밀번호는 프로퍼티 파일에 설정돼있다. 설정 파일 내용에 맞춰 사용자를 추가(+DB 생성 및 권한설정)하거나 기존에 사용하던 사용자를 사용하도록 설정 파일을 수정해줘야 한다.

MySQL: application-mysql.properties 파일
PostgreSQL: application-postgres.properties 파일

MySQL과 PostgreSQL 사용 시 각 데이터베이스 설정 파일에 spring.sql.init.mode=always 옵션이 존재한다. 이 옵션에 의해 실행될 때마다 resources 하위의 schema.sql이나 data.sql 파일을 실행하게 된다. 이 옵션은 어플리케이션 로딩 시 쿼리문을 날리기 위해 쓰인다. spring boot 2.4 이하 버전은 resources 하위의 schema.sql(or data.sql)을 무조건 실행시키지만 2.5 이상 버전은 위의 옵션이 있어야만 실행시킨다. 연속성 있는 데이터(비휘발성 데이터)를 사용하기 위해서는 이 옵션을 빼면 된다.

[참고]

로컬 DB 설명 - https://dbheart.tistory.com/36
H2 Database 설명 - https://yjkim-dev.tistory.com/3
spring-boot init sql 설명 - https://kha0213.github.io/spring/schema.sql/