[SpringBoot]스프링부트와 데이터베이스 연동 📊💾

스프링부트에서 데이터베이스 사용하기 💾

반응형

데이터베이스와의 연동은 모든 백엔드 애플리케이션에서 중요한 요소입니다! 😄 스프링부트는 JPA와 Hibernate를 통해 간단하면서도 강력한 데이터베이스 연동 기능을 제공합니다. 이 글에서는 JPA 설정부터 트랜잭션 관리, 그리고 데이터베이스 마이그레이션 도구까지 실무에서 바로 활용할 수 있는 내용을 다룹니다! 🚀

---

1. JPA 및 Hibernate 활용하기 🛠️

스프링부트는 JPA(Java Persistence API)와 Hibernate를 통해 데이터베이스와 상호작용하는 간단하고 효율적인 방법을 제공합니다.

JPA 설정하기

application.properties 또는 application.yml 파일에 데이터베이스 설정을 추가하세요:

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=secret
spring.jpa.hibernate.ddl-auto=update

엔티티(Entity) 정의

JPA에서는 데이터베이스 테이블과 매핑되는 클래스를 엔티티라고 합니다. @Entity 애노테이션을 사용해 정의합니다:

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    // Getter, Setter
}

레포지토리 인터페이스 생성

JpaRepository를 상속받아 데이터 조작 로직을 쉽게 구현할 수 있습니다:

public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findByName(String name);
}

이제 간단한 메서드 호출만으로 CRUD 작업을 수행할 수 있습니다! 🤩

실무에서 발생할 수 있는 오류와 해결법

1. LazyInitializationException:
   • 이유: fetch 타입이 기본적으로 LAZY로 설정된 관계를 초기화하려 할 때, 영속성 컨텍스트가 닫혀 있으면 발생합니다.
   • 해결:
     • @Transactional을 사용해 트랜잭션 범위를 늘리거나,
     • fetch = FetchType.EAGER로 설정합니다.
     • 필요에 따라 DTO를 사용해 필요한 데이터만 미리 로드합니다.
2. Duplicate Entry 에러:
   • 이유: @GeneratedValue가 데이터베이스의 기존 값과 충돌하는 경우 발생합니다.
   • 해결: 데이터베이스의 시퀀스를 엔티티와 동기화하거나, 초기 데이터 삽입 시 중복되지 않도록 주의하세요.

---

2. Spring Data JPA로 CRUD 처리하기 🛠️

스프링부트의 Spring Data JPA는 기본적인 CRUD 작업을 간단히 처리할 수 있게 해줍니다. 게다가 페이징과 정렬도 기본적으로 지원하죠! 🚀

CRUD 예제

1. 데이터 저장:
2. @Service public class UserService { private final UserRepository userRepository; public UserService(UserRepository userRepository) { this.userRepository = userRepository; } public User createUser(String name, String email) { User user = new User(); user.setName(name); user.setEmail(email); return userRepository.save(user); } }
3. 데이터 조회:
4. public List<User> getUsersByName(String name) { return userRepository.findByName(name); }
5. 페이징 및 정렬:페이징 설정은 다음과 같이 지정할 수 있습니다:
6. PageRequest.of(0, 10, Sort.by("name").ascending());
7. public Page<User> getUsers(Pageable pageable) { return userRepository.findAll(pageable); }

자주 발생하는 문제와 해결법

• No property found for type 에러:
  • 해결: 쿼리 메서드 명이 엔티티 필드와 정확히 매칭되는지 확인하세요.
• N+1 문제:
  • 해결: @EntityGraph 또는 join fetch를 사용해 관련 데이터를 한 번에 가져오도록 최적화하세요.

  @EntityGraph(attributePaths = {"relatedEntity"})
  List<User> findAllWithRelatedEntity();

---

3. 트랜잭션 관리하기 🔄

트랜잭션은 데이터의 일관성을 유지하기 위해 매우 중요합니다. 스프링부트에서는 @Transactional 애노테이션을 통해 간단히 트랜잭션을 관리할 수 있습니다. 🛠️

@Transactional 사용법

1. 서비스 레이어에서 선언적 트랜잭션 적용:
2. @Service public class UserService { private final UserRepository userRepository; public UserService(UserRepository userRepository) { this.userRepository = userRepository; } @Transactional public void updateUserEmail(Long userId, String newEmail) { User user = userRepository.findById(userId).orElseThrow(); user.setEmail(newEmail); userRepository.save(user); } }
3. 프로그래밍 방식 트랜잭션 관리:
   • PlatformTransactionManager를 직접 사용하여 세밀하게 트랜잭션을 제어할 수도 있습니다.

실무 팁

• 읽기 전용 트랜잭션: 읽기 전용 작업은 @Transactional(readOnly = true)로 설정해 성능을 최적화하세요.
• 예외 처리: 트랜잭션 롤백은 기본적으로 RuntimeException에서만 발생하므로, 커스텀 예외를 사용할 경우 명시적으로 롤백 설정을 추가하세요:
• @Transactional(rollbackFor = CustomException.class)

---

4. 데이터베이스 마이그레이션 도구 사용하기 🔧

스프링부트는 Flyway와 Liquibase와 같은 도구를 통해 데이터베이스 스키마 버전 관리를 간단히 할 수 있습니다. 이를 활용하면 협업 중에도 데이터베이스 변경 사항을 체계적으로 관리할 수 있어요! 🤩

Flyway 설정하기

1. 의존성 추가:
2. <dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> </dependency>
3. 마이그레이션 파일 생성:
   • src/main/resources/db/migration 디렉토리에 V1__initial.sql 파일을 생성하고 SQL을 작성하세요:
   • CREATE TABLE user ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255) NOT NULL, email VARCHAR(255) NOT NULL );
4. 애플리케이션 실행:
   • 애플리케이션 실행 시 Flyway가 자동으로 스키마를 적용합니다! 😎

Liquibase 사용하기

Liquibase는 XML, YAML, JSON 등 다양한 포맷으로 변경 사항을 관리할 수 있습니다. 의존성을 추가한 후 changelog 파일을 작성하세요:

<databaseChangeLog>
    <changeSet id="1" author="developer">
        <createTable tableName="user">
            <column name="id" type="BIGINT" autoIncrement="true">
                <constraints primaryKey="true"/>
            </column>
            <column name="name" type="VARCHAR(255)"/>
            <column name="email" type="VARCHAR(255)"/>
        </createTable>
    </changeSet>
</databaseChangeLog>

---

마무리 🎉

스프링부트와 데이터베이스 연동은 간단하면서도 강력한 기능을 제공합니다. 💪 JPA와 Hibernate를 활용해 데이터 조작 로직을 효율적으로 구현하고, Flyway와 Liquibase를 통해 데이터베이스 변경 사항을 체계적으로 관리해 보세요. 이제 여러분의 애플리케이션은 데이터베이스와의 상호작용에서도 최상의 성능을 발휘할 준비가 되었답니다! 🚀