[SpringBoot] H2 데이터베이스 사용 방법 (+오류 해결)

H2 데이터베이스

자바로 작성된 파일 기반의 RDBMS이다. 작은 크기와 빠른 속도를 특징으로 하며 주로 개발용이나 소규모 프로젝트에서 사용된다. 실제 운영시스템은 좀 더 굵직한 Oracle, MSSQL 등의 DB를 사용하는 것이 일반적인 개발 패턴이다.

---

사용방법

1. build.gradle 파일의 dependencies에 runtimeOnly 'com.h2database:h2' 를 추가해준다.
2. src/main/resources/application.properties 파일을 다음과 같이 수정해준다.

#DATABASE
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
spring.datasource.url=jdbc:h2:~/local
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

 

 

이제 브라우저에서 spring.h2.console.path 를 입력하면 H2 콘솔에 접속할 수 있다. (한국어도 지원해준다!! 👏🏻)

콘솔에 접속한 후에 [연결]을 클릭했는데 위와 같은 오류가 났다...ㅠ test라는 db가 없으니까 미리 만들던지 remote로 만드는 방식을 허용하던지 하라는 메시지 같다.

기본 경로로 설정된 test는 db가 자동으로 생성된다는데 오류가 나서 당황스러웠다.

알고 보니 H2 1.4.198 버전부터는 보안상의 문제로 db가 자동으로 생성되지 않는다고 한다.

그래서 홈 디렉터리에 직접 파일을 만들어줬다. 어차피 나는 spring.datasource.url 에 local 이라고 설정해놨기 때문에 파일 이름은 local.mv.db 로 작성했다.

 

 

JDBC URL을 jdbc:h2:~/local로 수정한 뒤 [연결]을 클릭했더니 아래 사진과 같이 콘솔 화면이 떴고 성공적으로 연결된 것을 확인할 수 있었다.

 

 

이제 자바에서 H2를 사용할 수 있게 해주면 준비가 완료된다.

스프링부트는 데이터베이스를 처리할 때 JPA를 사용하기 때문에 이를 위한 추가적인 작업이 필요하다.

JPA(Java Persistence API)란? 자바 진영에서 ORM의 기술 표준으로 사용하는 인터페이스의 모음이다. 인터페이스이기 때문에 이를 구현해주는 실제 클래스가 필요하며 JPA 인터페이스를 구현한 대표적인 클래스로는 Hibernate가 있다.

 

 

우선 build.gradle 파일의 dependencies 에

implementation 'org.springframework.boot:spring-boot-starter-data-jpa' 를 추가해준다.

(build.gradle 파일을 수정한 뒤에는 synchronize 해주는 것을 잊으면 안 된다)

 

그리고 src/main/resources 의 application.properties 파일에 JPA 설정을 추가해주면 환경설정이 끝난다.

# JPA
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect
spring.jpa.hibernate.ddl-auto=update