H2 Database + Spring JPA 연동

H2 DB

H2 DB는 자바 기반의 오픈소스 관계형 데이터베이스 관리 시스템이다. 보통 테스트 단계나 작은 단계에서 사용이 되며, Gradle이나 Maven에 의존성만 추가해주면 빠르게 이용이 가능하다. 

 

이러한 H2 DB 는 3가지 모드로 지원된다.

• In-memory
•  Embedded Mode
•  Server Mode

Inmemory mode

WAS 구동시에 H2 DB의 데이터를 메모리에 올려서 관리하는 방법이다. WAS가 종료되면, 메모리에 올라가있던 모든데이터가 휘발성으로 사라진다. 즉 이방식을 사용하면 휘발성으로 테스트등에 사용하기 적합하다.

 

Embedded Mode

WAS 구동시에 H2 DB를 PC의 디스크에 저장하여 관리하는 방식이다. In-memory와 달리 데이터가 사라지지 않는 비휘발성모드이기 때문에 , 개발 초기에 사용하기 적합하다.

 

 

사용방법

1. 의존성 추가

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    developmentOnly 'org.springframework.boot:spring-boot-devtools'
    
    runtimeOnly 'com.h2database:h2' //h2 의존성 추가
    
    annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

의존성을 추가해준다. 나의 경우에는 H2, JDBC, JPA 등을 추가했다.

 

 

2. application.yml(properties) 설정

yml이나 properties에 설정을 추가해주자. 나의 경우에는 yml로 사용한다.

server:
  port: 80 # 내장 톰캣 포트번호

spring:
  # H2 Database 설정
  datasource:
    driver-class-name: org.h2.Driver
    url: 'jdbc:h2:mem:test'   # H2 DB 연결 주소 (In-Memory Mode)
    #url: 'jdbc:h2:~/test'    # H2 DB 연결 주소 (Embedded Mode)
    username: username        # H2 DB 접속 ID (사용자 지정)
    password: password        # H2 DB 접속 PW (사용자 지정)

  # H2 Console 설정
  h2:
    console: # H2 DB를 웹에서 관리할 수 있는 기능
      enabled: true           # H2 Console 사용 여부
      path: /h2-console       # H2 Console 접속 주소

  # JPA 설정
  jpa:
    database-platform: org.hibernate.dialect.H2Dialect
    hibernate:
      ddl-auto: create        # DB 초기화 전략 (none, create, create-drop, update, validate)
    properties:
      hibernate:
        dialect: org.hibernate.dialect.H2Dialect
        format_sql: true      # 쿼리 로그 포맷 (정렬)
        show_sql: true        # 쿼리 로그 출력

 

spring.datasource.url

H2 DB는 url을 기준으로 위에서 설명했던 2가지 모드를 설정가능하다. 

url에 `mem`이 붙게된다면 H2 DB가 In-Memory 모드로 작동하고, `~`로 선언을 하면 Embedded 모드 방식으로 작동한다.

 

 

jpa.hibernate.ddl-auto

옵션에 따라서 Entitiy 클래스의 DDL 쿼리를 자동으로 실행할것인지 아닌지, 어떤 쿼리를 실행할것인지 등을 설정할수있다.

옵션	설명
none	테이블 생성 전략을 사용하지 않습니다. 보통 운영 환경에서는 해당 옵션이 권장됩니다.
create	기존 테이블을 삭제한 후 테이블을 재생성합니다.
create-drop	기존 테이블을 삭제한 후 테이블을 재생성하고, 애플리케이션 종료 시점에 테이블을 삭제합니다.
update	기존 테이블 구조는 유지하고, 새로 추가된 컬럼(멤버)만 테이블에 반영합니다. 기존 컬럼(멤버)은 속성이 변경되더라도 테이블에 반영되지 않습니다.
validate	DDL 쿼리를 실행하지 않고, 온전히 엔티티와 테이블이 정상적으로 매핑되었는지만 확인합니다. none과 마찬가지로 운영 환경에서 권장되는 옵션입니다.

 

 

3. 사용

나의 경우에는 Inmemory 방식으로 사용하였다. WAS를 실행시키고, locahost:8080/h2 를 입력하여 접속하면 아래와 같이 h2 DB의 콘솔모드가 실행된다.

 

추가 : Embedded Mode

Embedded 모드는 PC에 데이터가 저장되기 때문에 직접 삭제하기 전까지 삭제되지않는다. 그래서 몇가지 설정을 더해보자.

server:
  port: 80 # 내장 톰캣 포트번호

spring:
  # H2 Database 설정
  datasource:
    driver-class-name: org.h2.Driver
    #url: 'jdbc:h2:mem:test'  # H2 DB 연결 주소 (In-Memory Mode)
    url: 'jdbc:h2:~/test'     # H2 DB 연결 주소 (Embedded Mode)
    username: username        # H2 DB 접속 ID (사용자 지정)
    password: password        # H2 DB 접속 PW (사용자 지정)
    
  # H2 Console 설정
  h2:
    console: # H2 DB를 웹에서 관리할 수 있는 기능
      enabled: true           # H2 Console 사용 여부
      path: /h2-console       # H2 Console 접속 주소

  # JPA 설정
  jpa:
    database-platform: org.hibernate.dialect.H2Dialect
    hibernate:
      ddl-auto: update        # DB 초기화 전략 (none, create, create-drop, update, validate)
    properties:
      hibernate:
        dialect: org.hibernate.dialect.H2Dialect
        format_sql: true      # 쿼리 로그 포맷 (정렬)
        show_sql: true        # 쿼리 로그 출력

 

• DDL-AUTO 를 UPDATE 로 변경
• H2 연결 주소를 ~ 로 변경

이렇게 두가지를 설정해준다. 왜냐하면 CREATE 로 DDL-AUTO를 설정하면 DB가 생성될때 마다 전에 있던 것들을 삭제 시키기 때문에 인메모리로 사용하는것과 다를것이 없기때문이다.

 

H2 DB 파일 위치

이렇게 Embedded로 생성된 데이터베이스파일은 PC의 디스크에 저장이 된다. 나는 윈도우를 사용하고 있고, 윈도우에서 가본적으로 작성되는 곳은 C:/Users/사용자 에 생성이 된다. 이를 초기화 하고 싶으면 

 

.h2.server.properties, test.mv.db 를 삭제해 주면 된다.