2. JPA - JPQL(@Query), FetchType

JPQL

• JPA에서 사용하는 객체 중심 쿼리 문법
• JPA Query Method로 표현하기 어려운
  복잡한 조회 조건을 작성 가능
• 다만, JPQL을 사용하면 컴파일시 오류를 잡아낼 수 없고 유지보수의 어려움이 발생하기 때문에 권장하지 않음
  ex)

기존 SQL
SELECT * FROM employee WHERE name = 'KIM';

JPQL
SELECT e FROM Employee e WHERE e.name = :name

• @Query 어노테이션

  1. 레포지토리 메소드 위에 붙여서 직접 쿼리문을 작성할 때 사용
  2. SQL처럼 보이지만, 테이블명과 컬럼명이 아니라 엔티티명과 필드명을 사용
  3. 대소문자 주의 (엔티티명, 필드명은 자바 코드 기준으로 정확히 써야 한다.

• 매개변수 사용

  1. 메소드 이름이 너무 길어지는 걸 막을 수 있다.
  2. JOIN, GROUP BY, HAVING 같은 복잡한 조회도 작성할 수 있다.

예시

@Repository
public interface MemberRepository extends JpaRepository<Member, Long> {
      @Query("SELECT m FROM Member m WHERE m.name = :name")
      List<Member> findMember(@Param("name") String name);


      @Query("SELECT m FROM Member m WHERE m.name = :name AND m.email = :email")
      List<Member> findMember(@Param("name") String name, @Param("email") String email);

      @Query("""
          SELECT m.name, m.email, COUNT(a.articleId) as count
          FROM Member m LEFT JOIN Article a ON a.member = m
          GROUP BY m
          ORDER BY count DESC
          """)
          List<Object[]> getMemberStatsObject();
}

• 데이터 삭제, 변경
  @Query, @Modifying 어노테이션 사용
  이때, 영속성 컨텍스트 @Transactional 사용 권장

• 네이티브 SQL 쿼리
  특정 DB에만 지원하는 SQL명령이 필요한 경우 @Query 어노테이션의 nativeQuery 속성값을 true로 설정하여 JPQL 대신 데이터베이스에서 사용 가능한 SQL 명령 매핑

FetchType

• 연관된 데이터를 언제 조회할 것인지 정하는 옵션

1. FetchType.EAGER
   메인 데이터를 조회할 때 연관된 데이터도 바로 같이 조회
2. FetchType.LAZY
   처음에는 메인 데이터만 조회하고, 연관된 데이터는 실제로 필요할 때 가져옴

• FetchType.LAZY는 LazyInitializationException, N+1 문제 발생 가능

LazyInitializationException: 연관된 데이터를 나중에 가져와야 하는데 그 시점에 DB와 연결된 작업 구간이 끝나 있으면 가지고 올 수 없음

• 해결방안: 메소드에 @Transactional 어노테이션 사용, 혹은 DTO 객체로 변환하여 사용

N+1: 데이터 여러 개를 조회한 뒤 연관 데이터까지 하나씩 꺼내다가 쿼리가 너무많이 나가는 문제

• 해결방안:
  Fetch Join (일반적)
  @EntityGraph 어노테이션
  부트설정 파일에서 Batch Size 설정하여 설정한 크기만큼 묶어서 데이터를 조회하는 방식

ex)

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "member_id")
private Member member;

• @ManyToOne(fetch = FetchType.LAZY)
  @ManyToOne 는 Lazy 함께 사용 권장