H2 Database 설치, 서버 실행, 접속 방법 (Windows, MacOS with homebrew)

H2 Database 설치, 서버 실행, 접속 방법 (Windows, MacOS)

H2 데이터베이스는 설치가 필요 없고 용량이 매우 가벼우며 웹용 콘솔(쿼리툴)을 제공하여 개발용 로컬 DB로 사용하기 좋은 데이터베이스이다. H2의 특징을 정리하면 다음과 같다.

 

• Java로 작성된 오픈소스 RDBMS
• 스프링 부트가 지원하는 인메모리 관계형 데이터베이스이다.
• 인메모리로 띄우면 애플리케이션을 재시작할 때마다 초기화된다.
• 별도의 설치가 필요 없다.
• 로컬 환경, 테스트 환경에서 많이 사용된다.

 

---

 

1. H2 데이터베이스 다운로드

http://h2database.com에 들어가서 All Platforms를 클릭한다.

즉시 다운로드가 시작된다.

해당 링크로 받아지는 버전은 2020년 3월 기준으로 1.4.2 버전이다.

 

2. H2 데이터베이스 서버 실행

압축을 풀고 bin 디렉토리 아래의 h2.bat 또는 h2w.bat을 실행하면 H2 데이터베이스가 서버 모드로 실행된다.

Unix 계열은 h2.sh를 실행한다.

 

 

H2 콘솔 로그인 화면

h2 서버를 실행하면 자동으로 위와 같은 화면의 h2 콘솔 로그인 화면이 나온다.

자동으로 실행되지 않으면 웹브라우저에 http://localhost:8082 또는 http://127.0.0.1:8082를 입력하거나 윈도우 시스템 트레이에서 H2 아이콘을 한 번 클릭하면 열린다.

 

시스템 트레이 H2 아이콘

 

3. H2 데이터베이스 생성

그냥 연결하려고 하면 Database not found, either pre-create it or allow remote database creation (not recommended in secure environments) [90149-200] 90149/90149 에러가 발생하기 때문에 연결 전에 데이터베이스를 생성해야 한다.

 

✏️ 참고
h2 1.4.198 이후 버전부터는 보안 문제로 데이터베이스가 자동으로 생성되지 않기 때문에 본 포스팅에 이어서 나오는 내용과 같이 데이터베이스를 직접 생성해야 한다.
간단한 로컬 테스트용이라면 버전을 1.3대로 낮춰서 데이터베이스 자동 생성 기능을 사용해도 된다.

 

존재하지 않는 데이터베이스에 연결 시도 시 에러

 

H2 데이터베이스는 다음과 같이 만들면 된다.

Generic H2 (Embedded)를 선택하고 JDBC URL에 jdbc:h2:~/test를 입력하고 연결을 클릭한다.

test라는 데이터베이스가 생성되며, 생성할 데이터베이스 이름을 다른걸로 하고싶으면 test 말고 다른 이름을 입력하면 된다.

 

반응형

 

H2 데이터베이스가 성공적으로 생성된 화면

데이터베이스가 자동으로 생성되고, 콘솔에 연결된다.

 

이렇게 데이터베이스를 생성하면 사용자 계정 디렉토리에 test.mv.db 파일이 생성된다.

 

4. H2 데이터베이스 접속

다시 첫화면으로 가서

저장한 설정: Generic H2 (Server)

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

를 입력하고 연결을 클릭한다.

 

데이터베이스 파일을 생성한 다음에 JDBC URL을 저렇게 변경하는 이유는 파일 직접 접근이 아닌 TCP 소켓을 통해 접속해야 어플리케이션과 콘솔이 동시에 접근했을 때 오류가 발생하지 않기 때문이다.

 

정상적으로 접속한 화면

H2 데이터베이스를 사용할 모든 준비가 완료되었다.

표시한 영역에 SQL을 입력하고 실행을 클릭하면 SQL을 실행할 수 있다.

 

---

추가 - Mac에서 brew로 H2 Database 설치하기

터미널에서 다음 명령어를 입력한다.

$ brew install h2

 

설치가 완료되면 h2 명령어로 서버를 실행한다.

실행 시 -webAllowOthers 옵션을 넣어 실행한다.

그렇지 않으면 쿼리 실행 시 'Sorry, remote connections ('webAllowOthers') are disabled on this server.' 에러 메시지가 발생한다.

$ h2 -webAllowOthers

 

서버를 실행하면 바로 웹 콘솔이 실행된다.

나머지 DB 생성, 접속은 위 내용과 동일하므로 Generic H2 (Embedded)를 선택하고 JDBC URL에 jdbc:h2:~/test를 입력하고 연결을 클릭한다.

 

사용자 디렉토리에 생성된 test.mv.db

 

추가 - 위 방법으로 해결이 안되는 경우

다른 PC에서 brew로 H2 1.4.200 버전을 설치한 뒤 위에 적은 방법으로도 데이터베이스 파일 생성이 되지 않아서 해결 방법을 추가한다.

Database ... not found, either pre-create it or allow remote database creation (not recommended in secure environments) [90149-200] 90149/90149

 

H2를 -web 옵션을 넣고 실행하면 터미널에 아래와 같은 웹 콘솔 url이 출력된다.

$ h2 -web
Web Console server running at http://localhost:8082?key=5a2cbb4701528a42716722624fb5aa241f7f36c94fe2753a4dac92b06399a86c (only local connections)

 

전체 url을 복사하여 브라우저로 접속한다.

• 저장한 설정(Saved Settings): Generic H2 (Server)
• JDBC URL: jdbc:h2:~/test

로 설정하고 연결(Connect)를 클릭하면 정상적으로 test.mv.db 파일이 생성된다.

이후 사용할 때는 -web 옵션으로 실행중인 h2를 종료하고 다음 명령어로 h2를 다시 실행한다.

$ brew services start h2

 

그 다음 http://localhost:8082로 웹 콘솔에 접속하고, TCP 소켓을 통해 생성된 DB에 접속하도록 JDBC URL을 변경하여 사용한다.

• JDBC URL: jdbc:h2:tcp://localhost/~/test

 

참고로 brew services 명령어로 실행한 h2는 다음과 같이 종료한다.

$ brew services stop h2

 

References

https://h2database.com/html/tutorial.html