스프링부트 h2 database, h2 console 설정

✅ 스프링부트에서 h2 database를 사용하는 방법

pom.xml에 h2 의존성을 추가하고, 

application.properties에 관련 설정을 추가해주면 된다.

 

---

 

📌 h2 database 실행을 위한 최소 설정

pom.xml

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

 

application.properties

# h2 데이터베이스를 인메모리 모드 (mem) 로 실행하는 설정. 이때 db이름은 testdb로 생성된다.
spring.datasource.url=jdbc:h2:mem:testdb

# 데이터베이스 아이디, 비밀번호 설정 (디폴트 username: sa, 디폴트 password: 없음) 
spring.datasource.username=sa
spring.datasource.password=

# h2 데이터베이스 웹 콘솔 활성화
# 이렇게 하면, 브라우저에서 localhost:8080/h2-console 로 접속 가능합니다.
spring.h2.console.enabled=true

 

 

📌 각 설정에 대해 좀 더 자세히 알아보기

 

spring.datasource.url 속성 ( 공식문서 참고)

 

- h2 db의 경우, `jdbc:h2:{실행모드}:{데이터베이스 이름}` 형식으로 작성해야 한다.

- h2 db 실행 모드에는 embedded모드, in-memory 모드, server 모드가 있다.

1️⃣ Embedded 모드

spring.datasource.url=jdbc:h2:{데이터베이스 경로와 이름}
# 예시: jdbc:h2:~/testdb

- 파일 기반이다.

- 데이터베이스에서 관리하는 데이터가 로컬에 파일(testdb.mv.db)로 저장되기 때문에, 

    애플리케이션을 종료하라도 데이터가 유지된다.

2️⃣ In-Memory 모드

spring.datasource.url=jdbc:h2:mem:{데이터베이스 이름}
# 예시: jdbc:h2:mem:testdb

- 지정한 이름의 데이터베이스가 생성된다.

- 애플리케이션이 종료되면 데이터베이스도 삭제된다.

3️⃣ Server 모드

spring.datasource.url=jdbc:h2:tcp://{데이터베이스 서버 url}
# 예시: jdbc:h2:tcp://localhost/~/testdb

- 독립적인 h2 서버를 실행한다.

 

✅ 브라우저에서 h2-console 접속하기

브라우저에서 localhost:8080/h2-console 로 접속하고
application.properties에 정의한 url, username, password를 사용하면
H2 웹 콘솔에 접근 가능하다.

 

 

 

- 참고로, application.properties에 아래 설정을 추가하여 웹 콘솔 접속 경로를 직접 설정할 수도 있다.
    (설정하지 않는 경우 접속 경로는 디폴트로 /h2-console이 됨)

spring.h2.console.path=/asdf
# 이렇게 설정하면, 브라우저에서 http://localhost:8080/asdf 경로로 웹 콘솔에 접속 가능