Skip to content

flush

1. 플러시(flush())

플러시는 영속성 컨텍스트의 변경 내용을 데이터베이스에 반영한다.
플러시를 실행하면 구체적으로 다름과 같은 일이 일어난다.

  1. 변경 감지가 동작해서 영속성 컨텍스트에 있는 모든 엔티티를 스냅샷과 비교해서 수정된 엔티티를 찾는다. 수정된 엔티티는 수정 쿼리를 만들어 쓰기 지연 SQL 저장소에 등록한다.
  2. 쓰기 지연 SQL 저장소의 쿼리를 데이터베이스에 전송한다. (등록, 수정, 삭제 쿼리)

2. 영속성 컨텍스트를 플러시하는 방법 3가지

2-1. em.flush() 직접 호출

엔티티 매니저의 flush() 메소드를 직접 호출해서 영속성 컨텍스트를 강제로 플러시한다. 테스트나 다른 프레임워크와 JPA를 함께 사용할 때를 제외하고 거의 사용하지 않는다.

2-2. 트랜잭션 커밋 시 플러시가 자동 호출

데이터베이스에 변경 내용을 SQL로 전달하지 않고 트랜잭션만 커밋하면 어떤 데이터도 데이터베이스에 반영되지 않는다.
=> 트랜잭션을 커밋하기 전에 꼭 플러시를 호출해서 영속성 컨텍스트의 변경 내용을 데이터베이스에 반영해야 한다. JPA에서는 이런 문제를 예방하기 위해 트랜잭션을 커밋할 때 플러시를 자동으로 호출한다.

2-3. JPQL 쿼리 실행 시 플러시 자동 호출

JPQL이나 Criteria 같은 객체지향 쿼리를 호출할 때도 플러시가 실행된다.

# em.persist를 호출해 memberA, memberB, memberC를 영속 상태로 만듦
# 영속성 컨텍스트에는 있지만 데이터베이스에는 반영되어 있지 않음 
em.persist(memberA);
em.persist(memberB);
em.persist(memberC);

# 여기까지 작성 후 실행 시 SQL로 데이터베이스에서 엔티티 조회
# memberA, memberB, memberC => 데이터베이스에 없으므로 조회되지 않음
# 따라서 쿼리를 실행하기 직전에 영속성 컨텍스트를 플러시해서 변경 내용을 데이터베이스에 반영해야 한다.

# 중간에 JPQL 실행 => 플러시(flush()) 자동 호출 => memberA, memberB, memberC 쿼리 결과에 포함됨
# JPQL로 인한 검색이 아닌 식별자 기준으로 조회하는 find() 메소드를 호출할 때는 플러시가 실행되지 않음
query = em.createQuery("select m from Member m", Member.class);
List<Member> members = query.getResultList();

3. 결론

플러시라는 이름으로 인해 영속성 컨텍스트에 보관된 엔티티를 지운다고 생각하면 안 된다. 영속성 컨텍스트의 변경 내용을 데이터베이스에 동기화하는 것이 플러시이다.
트랜잭션 커밋 직전에만 변경 내용을 데이터베이스에 보내 동기화하여 데이터베이스와 동기화를 최대한 늦추는 것이 가능하다.

4. 참고