📚 3/11(월) 내일배움캠프 Java-Spring 52일차 TIL - SpringData JPA 다이내믹 사용하기 / @DynamicInsert와 @DynamicUpdate란?

📝  오늘의 학습 키워드 

• SpringData JPA - @DynamicInsert
• SpringData JPA - @DynamicUpdate

 

 

 

 

📍 @DynamicInsert, @DynamicUpdate란? 

  @DynamicInsert와 @DynamicUpdate는 Hibernate에서 제공하는 주석(Annotation)으로, 엔터티의 저장 및 수정 동작에 대한 성능 및 최적화를 위해 사용된다. JPA에서 엔티티의 저장(insert) 및 업데이트(update) 시 엔티티의 변화가 있는 컬럼에 대해서만 SQL을 실행하고, 변화가 없는 컬럼에 대해서는 실행하지 않는 기능을 제공한다. 필드가 많아질수록 성능의 차이가 더 많이 나타날 수 있다.

 

@DynamicInsert : 엔티티를 데이터베이스에 삽입(INSERT)할 때, 널이 아닌 속성만을 대상으로 하는 동적 INSERT 쿼리를 생성한다. INSERT는 데이터베이스에 불필요한 컬럼을 제외하고 쿼리를 실행하므로, 삽입 성능을 향상시킬 수 있다.

@DynamicUpdate: 엔티티를 데이터베이스에서 수정(UPDATE)할 때, 변경된 속성만을 대상으로 하는 동적 UPDATE 쿼리를 생성한다. 변경된 속성만을 대상으로 하는 동적 UPDATE는 불필요한 컬럼을 업데이트하지 않으므로, 수정 성능을 향상시킬 수 있다.

 

 

 

 

 

 

📍 @DynamicInsert 사용해보기 

  User 클래스를 만들어서 어떤 식으로 쿼리가 날아가는지 확인을 해보자.

@DynamicInsert
@Entity
@Table
@Getter
@AllArgsConstructor
@NoArgsConstructor
public class User {

  @Id @GenerateValue
  @Column
  private Long id;
  
  @Column
  private String username;
  
  @Column
  private String password;
  
}

 

 

 

 

    테스트 코드를 작성해 보자.

@Test
  void dynamicInsertTest() {
    // given
    var newUser = User.builder().username("user").build();

    // when
    userRepository.save(newUser);

    // then
    // 부분 생성 쿼리
  }

 

 

 

 

    데이터베이스에 쿼리가 어떤 식으로 날아가는지 확인해 보자.

<@DynamicInsert 적용 전>

 

 

<@DynamicInsert 적용 후>

 

 

@DynamicInsert 적용 전, 후를 비교해 보면 많은 차이가 나지 않지만 필드가 많아질수록 더 차이가 많이 나게 된다.

 

 

 

 

 

 

📍 @DynamicUpdate 사용해 보기 

  User 클래스를 만들어서 어떤 식으로 쿼리가 날아가는지 확인을 해보자.

@DynamicUpdate
@Entity
@Table
@Getter
@AllArgsConstructor
@NoArgsConstructor
public class User {

  @Id @GenerateValue
  @Column
  private Long id;
  
  @Column
  private String username;
  
  @Column
  private String password;
  
}

 

 

 

 

    테스트 코드를 작성해 보자.

@Test
  void dynamicUpdateTest() {
    // given
    var newUser = User.builder().username("user").password("password").build();
    userRepository.save(newUser);

    // when
    newUser.updatePassword("new password");
    userRepository.save(newUser);

    // then
    // 부분 수정 쿼리
  }

 

 

 

 

    데이터베이스에 쿼리가 어떤 식으로 날아가는지 확인해 보자.

<@DynamicUpdate 적용 전>

 

<@DynamicUpdate 적용 후>

 

 

@DynamicUpdate 적용 전, 후를 비교해 보면 많은 차이가 나지 않지만 필드가 많아질수록 더 차이가 많이 나게 된다.

 

 

 

 

 

 

- 사용 시 고려해야 할 것 -

  다이내믹 어노테이션을 사용하면 스냅샷(Snapshot)을 사용하지 않고, 엔티티의 변경 여부를 확인하지 않고도 쿼리가 생성된다. 변경된 필드를 따로 추적하지 않고도 엔터티의 모든 필드를 기준으로 동적으로 쿼리를 생성한다.

이런 어노테이션을 사용하면 필요한 필드만을 대상으로 하는 동적인 쿼리가 생성되어, 불필요한 데이터베이스 작업을 줄일 수 있다. 그러나 이런 최적화 기능을 사용하면서 주의할 점은 변경 감지가 충분히 이루어지지 않아 영속성 콘텍스트의 상태가 정확하게 유지되지 않을 수 있다는 것이다. 변경 감지를 통한 엔터티의 일관성 유지가 중요한 경우에는 신중하게 사용해야 한다.

영속성 컨텍스트(Persistence Context)는 엔티티의 상태를 추적하고, 스냅숏을 사용하여 엔터티의 변경 여부를 판단한다. 변경된 엔티티는 데이터베이스에 쿼리를 날려 동기화된다.

즉, 영속성 컨텍스트는 스냅샷을 사용하여 엔터티의 변경 여부를 감지하고, 변경된 내용을 데이터베이스에 동기화한다. 이를 통해 트랜잭션이나 Flush 작업 시에 변경된 필드만을 대상으로 하는 효율적인 쿼리를 생성하여 데이터베이스와 일관된 상태를 유지할 수 있다.

 

 

 

  하지만, 이 기능을 사용하지 않아도 JPA의 기본 동작에는 문제가 없으며, 실무에서는 개발자의 편의와 성능 최적화 측면에서 사용 여부를 결정하게 된다. 따라서 @DynamicInsert와 @DynamicUpdate의 사용 유무는 개인별로 상황에 맞게 결정하면 된다.