Spring Boot와 H2 데이터베이스: 가볍고 빠른 임베디드 DB 활용 가이드

 

H2 데이터베이스 는 가볍고 빠른 임베디드 데이터베이스 로, Spring Boot와 함께 사용할 때 테스트와 개발에 최적화된 환경 을 제공합니다. 이 글에서는 H2 데이터베이스 설정과 활용 방법 , H2 콘솔 사용법 을 알아보고, 애플리케이션 테스트 시 임베디드 DB를 효과적으로 사용하는 방법 을 코드 예제와 함께 설명합니다.

 

---

 

 

목차

1. H2 데이터베이스란 무엇인가?
2. Spring Boot에서 H2 데이터베이스 설정하기
3. H2 콘솔 사용법 ( http://localhost:8080/h2-console )
4. 테스트 환경에서 임베디드 DB 활용하기
5. H2 데이터베이스의 트렌드와 장점

 

---

 

1. H2 데이터베이스란 무엇인가?

H2 데이터베이스 는 가볍고 빠르게 실행되는 오픈소스 관계형 데이터베이스 입니다. 인메모리 모드 를 지원해 애플리케이션과 함께 실행되며, 데이터를 메모리에 저장하므로 테스트 환경 에 매우 적합합니다.

H2 데이터베이스의 주요 특징

• 빠른 실행 속도 : 메모리에서 실행되므로 빠르게 데이터 처리 가능
• 임베디드 모드 지원 : 애플리케이션 내에 통합 가능
• SQL 표준 준수 : 일반적인 SQL 문법을 모두 지원
• H2 콘솔 제공 : 브라우저에서 데이터베이스 상태를 확인하고 쿼리 실행 가능

H2는 개발 초기 나 테스트 환경 에서 유용하게 사용되며, 이를 통해 데이터베이스가 필요한 기능을 손쉽게 구현하고 검증할 수 있습니다.

 

---

 

2. Spring Boot에서 H2 데이터베이스 설정하기

 

의존성 추가 (pom.xml)

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

• spring-boot-starter-data-jpa : JPA 기능 제공
• h2 : H2 데이터베이스 의존성 추가

설정 파일 작성 (application.properties)

# H2 데이터베이스 설정
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.h2.console.enabled=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

1. spring.datasource.url : 인메모리 모드로 데이터베이스 사용
2. spring.h2.console.enabled=true : H2 콘솔 활성화
3. spring.jpa.hibernate.ddl-auto=update : 엔터티 변경 시 테이블 자동 갱신

 

---

 

3. H2 콘솔 사용법 ( http://localhost:8080/h2-console )

Spring Boot에서 H2 콘솔을 활성화하면 브라우저 에서 데이터베이스를 직접 확인할 수 있습니다.

H2 콘솔 접속 방법

1. 애플리케이션을 실행한 후 http://localhost:8080/h2-console 에 접속합니다.
2. JDBC URL 에 jdbc:h2:mem:testdb 를 입력합니다.
3. Username 은 sa , Password 는 비워둡니다.
4. Connect 버튼을 클릭하면 데이터베이스에 접속할 수 있습니다.

H2 콘솔 화면과 사용법

• 쿼리 실행 창 에서 SQL 쿼리를 입력하고 실행할 수 있습니다.
• 데이터베이스 테이블을 조회하거나 데이터를 삽입할 수 있습니다.
• 테이블 스키마 를 확인하고, 데이터 무결성을 검증할 수 있습니다.

 

---

 

4. 테스트 환경에서 임베디드 DB 활용하기

H2는 테스트 환경에서 빠른 데이터 검증 에 매우 유용합니다. 아래는 JUnit 테스트 에서 H2 데이터베이스를 활용하는 예제입니다.

테스트 코드 예제: User 엔터티 CRUD 테스트

 

User.java (엔터티)

package com.example.demo.entity;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

@Entity
@Getter
@Setter
@NoArgsConstructor
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    public User(String name, String email) {
        this.name = name;
        this.email = email;
    }
}

 

UserRepository.java (레포지토리)

package com.example.demo.repository;

import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

 

UserRepositoryTest.java (테스트 코드)

package com.example.demo;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.Optional;

import static org.assertj.core.api.Assertions.assertThat;

@SpringBootTest
public class UserRepositoryTest {

    @Autowired
    private UserRepository userRepository;

    @Test
    public void 사용자_저장_및_조회() {
        // 사용자 저장
        User user = new User("홍길동", "hong@example.com");
        userRepository.save(user);

        // 사용자 조회
        Optional<User> foundUser = userRepository.findById(user.getId());

        // 검증
        assertThat(foundUser).isPresent();
        assertThat(foundUser.get().getName()).isEqualTo("홍길동");
    }
}

테스트 코드 설명

1. SpringBootTest 애너테이션으로 테스트 환경에서 애플리케이션을 실행합니다.
2. User 엔터티 를 저장하고, Repository를 통해 조회 합니다.
3. AssertJ 라이브러리를 사용해 테스트 결과를 검증합니다.

이와 같이 H2 데이터베이스 를 사용하면 테스트 코드에서 실제 데이터베이스와 동일한 환경을 시뮬레이션할 수 있습니다.

 

---

 

5. H2 데이터베이스의 트렌드와 장점

• H2 데이터베이스 는 빠른 개발과 테스트 를 위한 임베디드 DB로 많은 개발자들에게 사랑받고 있습니다.
• Statista 의 조사에 따르면, 전 세계 개발자의 45% 가 테스트 환경에서 인메모리 데이터베이스를 사용합니다.
• H2 는 클라우드 환경에서 경량 데이터베이스 로도 활용되며, 애플리케이션 초기 단계에서 매우 유용합니다.

 

---

 

관련 링크

Spring 공식 문서👆

H2 데이터베이스 공식 사이트👆

Spring Boot와 JPA 가이드👆

H2 콘솔 사용법👆

JUnit 5 공식 문서👆

AssertJ 공식 사이트👆

---

FAQ

 

1. H2 데이터베이스는 언제 사용하는 것이 좋나요?

• 주로 테스트 환경 과 개발 초기 에 사용합니다. 빠른 실행과 간편한 설정이 장점입니다.

2. H2 데이터베이스의 데이터는 영구 저장되나요?

• 인메모리 모드에서는 애플리케이션 종료 시 데이터가 사라집니다. 파일 모드로 사용하면 데이터를 영구 저장할 수 있습니다.

3. H2 콘솔에 접속할 수 없을 때 어떻게 해야 하나요?

• application.properties 파일에서 spring.h2.console.enabled=true 로 설정했는지 확인하세요.

4. 실제 운영 환경에서도 H2를 사용할 수 있나요?

• 운영 환경에서는 보통 MySQL, PostgreSQL 같은 RDBMS 를 사용합니다. H2는 개발과 테스트에 더 적합합니다.

5. JPA와 H2의 조합이 유용한 이유는 무엇인가요?

• JPA를 사용하면 테이블 생성과 매핑을 자동화 할 수 있고, H2는 빠르게 이를 검증할 수 있는 환경을 제공합니다.

 

---

 

마무리

이번 포스팅에서는 Spring Boot와 H2 데이터베이스 를 사용하여 애플리케이션 개발과 테스트 환경을 쉽게 설정하는 방법을 알아보았습니다. H2 데이터베이스 는 인메모리 모드로 빠른 데이터베이스 처리 속도를 제공하며, JPA와의 조합 을 통해 개발자의 생산성을 극대화합니다. 또한, H2 콘솔 을 활용해 브라우저에서 SQL 쿼리를 직접 실행하며 테이블을 확인하는 방법도 설명했습니다.

H2는 운영 환경 보다는 테스트 환경과 개발 초기 에 적합한 데이터베이스로, JUnit과 함께 유용하게 활용 할 수 있습니다. 프로젝트 초기 단계에서 H2를 사용해 데이터 모델을 빠르게 구축하고 검증하면, 개발 시간을 단축할 수 있습니다.

이제 여러분의 프로젝트에서 H2와 JPA를 활용해 CRUD 기능을 구현하고 테스트를 진행해보세요!