Spring Data JPA, 벌크성 수정 쿼리

벌크성 쿼리란?

벌크성 쿼리란 DB에서 여러개의 레코드를 한번에 추가/수정/삭제하는 쿼리를 말한다.
예를 들어 나이가 10인 레코드들의 나이를 1살씩 추가하는 벌크성 쿼리는 다음과 같다.

UPDATE tbl_member SET age = 1 WHERE age = 10;

JPA에서도 이런 벌크성 쿼리를 지원한다. 오늘은 그 중에서 벌크성 수정 쿼리를 볼 것이다.

사용법

먼저 순수한 JPA를 사용한 벌크성 수정 쿼리는 다음과 같다.

 public int bulkAgePlus(int age) {
    int resultCount = em.createQuery(
            "update Member m set m.age = m.age + 1" +
                    "where m.age >= :age")
            .setParameter("age", age)
            .executeUpdate();
    return resultCount;
}

createQuery하여 update쿼리를 작성해주고 setParameter를 통해 age값을 매핑한다.

Spring Data JPA도 @Query, @Modifying 애너테이션을 통해 벌크성 쿼리를 지원한다.

@Modifying
@Query("update Member m set m.age = m.age + 1 where m.age >= :age")
int bulkAgePlus(@Param("age") int age);

실제 사용

@Test
public void bulkUpdate() throws Exception {
  //given
  memberRepository.save(new Member("member1", 10));
  memberRepository.save(new Member("member2", 19));
  memberRepository.save(new Member("member3", 20));
  memberRepository.save(new Member("member4", 21));
  memberRepository.save(new Member("member5", 40));
  
  //when
  int resultCount = memberRepository.bulkAgePlus(20);

  //then
  assertThat(resultCount).isEqualTo(3);
}

주의점

• 벌크성 수정, 삭제 쿼리는 @Modifying 애너테이션을 반드시 사용해야 한다.
  : 사용하지 않으면 Exception이 발생한다.
• 벌크성 쿼리를 사용하고 나면 반드시 영속성 컨텍스트를 초기화 해야한다.
  : 초기화 하지 않으면 수정 전 값들이 영속성 컨텍스트에 남아서 문제가 될 수 있다.
  자동으로 초기화 하는 방법은 @Modifying의 'clearAutomatically'의 값을 true로 주면 된다.
  (기본 값은 false)

  @Modifying(clearAutomatically = true)

참고로 벌크 연산은 영속성 컨텍스트를 무시하고 실행하기 때문에,
영속성 컨텍스트에 있는 엔티티의 상태와 DB의 엔티티 상태가 달라 질 수 있다.
권장 방안...
1. 영속성 컨텍스트에 엔티티가 없는 상태에서 벌크 연산을 먼저 실행한다.
2. 부득이하게 영속성 컨텍스트에 엔티티가 있으면 벌크 연산 직후 영속성 컨텍스트를 초기화 한다.