Spring boot 에서 H2 데이터베이스 사용하기 (Kotlin)

 

 

현재 DB가 세팅되지 않은 상황에서 급하게 프론트엔드와의 연동 테스트를 위해 임시 회원가입 로직을 확인할일이 생겼다

이를 위해 실제로 사용할 DB가 세팅되기 전까진 H2 DB를 임시로 선택하였고, 관련 내용 학습 및 실제 사용에 대한 기록을 남기려고 한다

 

H2 데이터베이스란?

 

H2는 JAVA로 작성된 오픈 소스 RDBMS임 

 

• 인메모리 데이터베이스 : 인메모리 모드에서 작동하여 데이터를 메모리에 저장하므로 빠른 성능을 제공함
  (이 경우 애플리케이션 종료 시 데이터가 사라짐)
  
  
• 파일 기반 데이터베이스 : 데이터를 파일로 저장할 수 도 있기에 영구적인 저장이 가능함
  
  
• JDBC 지원 : JDBC API를 통해 자바 애플리케이션과 쉽게 통합될 수 있음
  
  
• 웹 콘솔 : 웹 기반 GUI 콘솔 제공해줌
  (관리 용이)

 

굉장히 작고 가볍기 때문에 제공되는 기능은 제한적이지만 속도가 빠르고 별도의 프로그램 없이 웹브라우저 기반의 DB 콘솔을 사용할 수 있음

 

=> 현재 백엔드 서버를 AWS상에 배포 후 프론트엔드와 간단한 api 연동 테스트만 진행하면 되기에 prod 환경에서 사용할 DB 세팅이 마무리 되기 전까지 H2 데이터베이스를 임시로 테스트를 진행하는게 좋다고 판단함

(추후 prod에서 사용하게될 DB는 RDB라는 점도 함께 고려)

 

 

사실 더 자세히 들어가면 여러 모드들이 존재함

 

Server Mode

 

H2를 독립적인 DB 서버로 실행하는 방식임
(그냥 여타 DBMS와 동일하게 DB엔진 설치하고 엔진을 구동하여 사용하는 방식으로 생각)

 

=> H2 프로세스가 별도로 실행되며, 여러 클라이언트가 동시에 접근할 수 있음

 

• H2가 네트워크를 통해 여러 클라이언트에 서비스함
  
  
• TCP 또는 WebSocket을 통해 연결 가능
  
  
• 애플리케이션이 종료되어도 데이터가 유지됨
  
  
• 여러 인스턴스에서 같은 DB를 공유할 수 있음

 

In-memory Mode

 

H2가 메모리 내에서만 실행되는 방식임
(애플리케이션에 DB 엔진이 내장됨)

 

• 빠른 데이터 처리 속도
  
  
• 데이터가 디스크에 저장되지 않기에 휘발성
  
  
• 애플리케이션 종료되면 DB도 사라짐

 

Embedded Mode

 

H2가 애플리케이션 내부에 내장되어, 애플리케이션과 함께 실행되는 방식임
(애플리케이션에 DB 엔진이 내장됨)

 

=> 별도의 DB 서버를 실행할 필요 없이 파일 기반으로 데이터가 저장됨

 

• 애플리케이션이 실행될 때만 DB가 활성화됨
  
  
• 파일 기반 저장이 가능하여 데이터 유지가 가능
  
  
• 네트워크 연결 필요 X
  
  
• 애플리케이션이 종료되면 DB도 함께 종료

 

현재 상황에서는?

 

현재는 AWS EC2에 서버 배포 후 프론트엔드와 API 연동 테스트를 하는 것이 목적이므로

 

In-memory Mode를 사용하는 것이 적절한 선택이라고 생각함

 

=> 데이터가 날아가지만 실제 prod 환경이 아닌 단순 테스트이며 빠르고 간편하게 사용이 가능하다고 판단

 

H2 데이터베이스(In-memory mode) 사용해보기

 

로컬을 기준으로 사용해보았음

 

implementation("org.springframework.boot:spring-boot-starter-data-jpa")
runtimeOnly("com.h2database:h2")

 

 

우선 build.gradle.kts 에 위 의존성을 추가해줌

 

=> Spring Data JPA를 사용하면 내부에서 이미 JDBC 드라이버와 DataSource 관련 설정을 자동으로 포함하기에 JDBC 의존성이 따로 필요하진 않음

 

spring:

  datasource: 
    url: 'jdbc:h2:mem:test' # test라는 이름의 H2 메모리 데이터베이스 생성
    driver-class-name: org.h2.Driver # H2 드라이버 클래스 이름
    username: test 
    password: qwer1234

  h2:
    console:
      enabled: true # H2 콘솔 활성화
      path: /h2-console # H2 콘솔 경로
      settings:
      	web-allow-others: true # AWS에 배포 후 H2 콘솔 확인을 위해 외부에서 접근 가능하도록 설정

 

application.yaml 에서 위와 같이 설정해줌

 

import jakarta.persistence.*

@Entity
@Table(name = "users")
data class User(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long = 0,

    @Column(nullable = false, unique = true)
    val username: String,

    @Column(nullable = false)
    val password: String,

    @Column(nullable = false)
    val email: String
)

 

이런식으로 간단하게 User 엔티티 클래스도 추가해줌

---

 

이제 어플리케이션을 시작하고 http://localhost:8080/h2-console로 접속하면

 

 

다음과 같은 H2 Console 화면을 볼 수 있음

 

JDBC URL 확인해주고 User Name과 Password 부분에 application.yaml에서 설정한 test / qwer1234를 각각 넣어주면

 

 

Connect에 성공할 수 있음

 

 

 

 

로컬에서 진행하므로 postman을 이용하여 미리 만들어놓은 간단한 회원가입 테스트 api를 쏴보면

 

 

 

잘 저장되는 것을 확인할 수 있음

 

위에서 말한 In-memory의 특성상 애플리케이션을 종료했다가 다시 H2 Console을 확인해보면

 

 

데이터가 삭제된 것을 확인할 수 있음