h2 데이터베이스 설치 및 실행방법 정리

꽤 가벼운 DB이기에 실무에서 local에 설치해서 많이 사용한다는 h2 데이터베이스 사용법 정리합니다.

단점으로는 로컬용이기 때문에 컴퓨터 다 끄면 날아갑니다.  😇

테스트용으로만 사용하세요.

 

1. 데이터베이스 설치

https://www.h2database.com/html/download-archive.html

위 링크를 접속하여 사용중인 OS에 맞게 설치합니다.

 

스프링부트 2.7x 버전에서는 h2 데이터베이스 1.4.200 버전이 호환됩니다.

이미 다른 버전이 설치되어 있으면 최상위폴더/test.mv.db 파일을 삭제해주어야 정상 동작합니다.

 

2. 데이터 베이스 실행

0. 압축을 풀고 맥OS 사용자는 터미널에서 권한을 주어야 합니다.

-> 경로는 h2가 설치된 폴더의 h2/bin 에서 해주면 됩니다.

chmod 755 h2.sh

1. 윈도우 사용자는 h2.bat를 실행하면 되고, 맥OS 사용자는 터미널에서 아래 명령어를 입력합니다.

./h2.sh

명령어를 입력하면 위와같은 주소와 함께 창이 뜹니다.

바로 접속이 안되는 경우 앞부분을 localhost로 변경해줍니다.

그러면 위와같은 로그인 페이지가 확인됩니다.

 

2. 처음 실행은 위 경로 그대로 [연결]을 합니다.

이 페이지가 확인이 되면 좌측 상단 접속 끊기를 눌러 접속을 종료합니다.

이렇게 한 번 연결을 해야 test 데이터베이스가 생성이 됩니다.

pc의 최상단으로 가보면 test.mv.db 파일이 생성된 것을 볼 수 있습니다.

3. 이후부터는 jdbc:h2:~/test 로 접근하면 파일에 락을 걸어서 접근이 어렵기 때문에

tcp 모드 주소로 접속하여 사용합니다.

jdbc:h2:tcp://localhost/~/test

위 주소는 소켓방식 접근으로 여러곳에서 접근이 가능해집니다.

 

3. 스프링부트에 연결

1. JDBC템플릿으로 접근하는 경우

build.gradle 추가

implementation 'org.springframework.boot:spring-boot-starter-jdbc'
runtimeOnly 'com.h2database:h2'

application.properties 추가

spring.datasource.url=jdbc:h2:tcp://localhost/~/test
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa

2. JPA로 접근하는 경우

build.gradle 추가

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
runtimeOnly 'com.h2database:h2'

application.properties 추가

spring.datasource.url=jdbc:h2:tcp://localhost/~/test
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa

spring.jpa.show-sql=true   // sql문 보기
spring.jpa.hibernate.ddl-auto=none  // 테이블 자동 생성X