객체지향 쿼리 언어(JPQL)

이동건 (불꽃냥펀치)·2025년 3월 11일
JPA부트캠프 이후

JPQL이란?

JPA 쿼리방법

  • JPQL
  • QueryDSL

JPQL

  • JPA를 사용하면 엔터티 객체를 중심으로 개발
  • 검색을 할 때 테이블이 아닌 엔터티 객체를 대상으로 검색
  • 모든 DB 데이터를 객체로 변환해서 검색하는 것은 불가능
  • 필요한 데이터만 불러오려면 결국 검색 조건이 포함된 SQL이 필요
  • JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공
  • 예시
String jpql = "select m from Member m where m.age > 18";
List<Member> result= em.createQuery(jpql,Member.class).getResultList();
  • 실행된 쿼리
select
m.id as id,
m.age as age,
m.USERNAME as USERNAME,
m.TEAM_ID as TEAM_ID
from
Member m
where
m.age>18

Criteria

  • 문자가 아닌 자바 코드로 JPQL을 작성할 수 있음
  • JPQL 빌더 역할
  • 단점은 너무 복잡하고 실용성이 없음

QureyDSL

  • 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
  • JPQL 빌더 역할
  • 컴파일 시점에서 문법 오류를 찾을 수 있음
  • 동적쿼리 작성시 편리함
  • 단순하고 쉬움
  • 예시
JPAFactoryQuery query = new JPAQueryFactory(em);
QMember m= QMember.member;
List<Member> list= query.selectFrom(m).where(m.age.gt(18))
					.orderBy(m.name.desc()).fetch();



JPQL 문법

select_문 :: =
  select_절
  from_절
  [where_절]
  [groupby_절]
  [having_절]
  [orderby_절]
update_문 :: = update_절 [where_절]
delete_문 :: = delete_절 [where_절]
  • select m from Member as m where m.age>18
  • 엔터티와 속성은 대소문자를 구분함
  • JPQL 키워드는 대소문자 구분 x
  • 별칭은 필수 as는 생략 가능

집합과 정렬

select
  COUNT(m), //회원수
  SUM(m.age), //나이 합
  AVG(m.age), //평균 나이
  MAX(m.age), //최대 나이
  MIN(m.age) //최소 나이
 from Member m
  • group by,Having
  • order by

TypedQuery/Query

  • TypedQuery: 반환 타입이 명확할 때 사용
TypedQuery<Member> query =
em.createQuery("SELECT m FROM Member m", Member.class);
  • Query: 반환 타입이 명확하지 않을 떄 사용
Query query =
em.createQuery("SELECT m.username, m.age from Member m");

결과 조회 API

  • query.getResultList(): 결과가 하나 이상일때 리스트 반환
    • 결과가 없으면 빈 리스트 반환
  • query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환

파라미터 바인딩 - 이름/위치 기준

SELECT m FROM Member m where m.username=:username
query.setParameter("username", usernameParam);

SELECT m FROM Member m where m.username=?1
query.setParameter(1, usernameParam);

프로젝션

  • select절에 조회할 대상을 지정
  • 프로젝션 대상: 엔터티, 임베디드 타입, 스칼라 타입
  • select m.username,m.age From Member m
  • 단순값을 바로 DTO로 조회
    • select new jpaBook.jpql.UserDto(m.username,m.age) from Member m
    • 패키지 명을 포함한 전체 클래스 명 입력
    • 순서와 타입이 일치하는 생성자 필요

페이징 API

  • setFirstResult(int str): 조회시작 위치 (0부터 시작)
  • setMaxResults(int max): 조회할 데이터 수
  • 예시
String jpql = "select m from Member m order by m.name desc";
List<Member> resultList = em.createQuery(jpql, Member.class)
.setFirstResult(10)
.setMaxResults(20)
.getResultList();

조인

  • 내부조인: select m from Member m Join m.team t
  • 외부조인: select m from Member m outer Join m.team t
  • 세타조인: select count(m) from Member m ,Team t where m.username=t.username
  • on절을 활용한 조인

    • 조인대상 필터링

      • 예시(회원과 팀을 조인하면서 팀이름이 A인 팀만 조회)

        			SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'A'

    • 연관관계 없는 엔터티 외부 조인

      • 예시(회원 이름과 팀의 이름이 같은 대상 외부 조인)

        			SELECT m, t FROM
			Member m LEFT JOIN Team t on m.username = t.name

서브쿼리

  • 나이가 평균보다 많은 회원

    select m from Member m
where m.age > (select avg(m2.age) from Member m2)

  • 한건이라도 주문한 고객

    select m from Member m
where (select count(o) from Order o where m=o.member) > 0

  • 서브쿼리 지원 함수
    -[NOT] EXISTS(subquery): 서브쿼리에 결과가 존재하면 참

    • ALL/ANY/SOME
    • ALL 모두 만족하면 참
    • ANY,SOME : 같은 의미, 조건을 하나라도 만족하면 참

  • [NOT] IN(subquery): 서브쿼리의 결과중 하나라도 같은 것이 있으면 참

  • 예제

    • 팀 A 소속인 회원

      		 select m from Member m
		 where exists (select t from m.team t where t.name = ‘팀A')

    • 전체 상품 각각의 재고보다 주문량이 많은 주문들

      		select o from Order o
		where o.orderAmount > ALL (select p.stockAmount from Product p)

    • 어떤 팀이든 팀에 소속된 회원

      		select m from Member m
		where m.team = ANY (select t from Team t)
  • 서브 쿼리의 한계
    • JPA는 WHERE HAVING 절에서만 서브 쿼리 사용 가능
    • FROM 절의 서브쿼리는 현재 JPQL에서 불가능

JPQL 기본함수

  • CONCAT
  • SUBSTRING
  • TRIM
  • LOWER,UPPER
  • LENGTH
  • LOCATE
  • ABS, SQRT, MOD
  • SIZE, INDEX



경로 표현식

  • .을 찍어 객체 그래프를 탐색하는 것
  • 용어정리
    • 상태필드: 단순히 값을 저장하기 위한 필드
    • 연관필드: 연관관계를 위한 필드

경로표현식 특징

  • 상태필드 : 경로탐색의 끝, 탐색 x

  • 단일값 연관 경로: 묵시적 내부 조인 발생, 탐색 0

  • 컬렉션 값 연관 경로: 묵시적 내부 조인 발생 , 탐색 X

    • 단일 값 연관 경로 탐색 예시

      JPQL:select o.member from Order o
SQL: select m.* 
from Orders o
inner join Member m on o.member_id = m.id

    • 명시적/묵시적 조인

      select m from Member m join m.team t (명시적: join 키워드 직접 사용)
			select m.team from Member m (묵시적: 경로 표현식에 의해 묵시적으로 SQL 조인발생)

    • 경로 표현식 - 예제

      		select o.member.team from Order o (성공)
select t.members from Team (성공)
select t.members.username from Team t (실패)
select m.username from Team t join t.members m (성공)



JPQL: 패치조인

  • SQL 조인 종류 x

  • JPQL에서 성능 최적화를 위해 제공하는 기능

  • 연관된 엔터티나 컬렉션을 SQL 한번에 함께 조회하는 기능

  • join fetch 명령어 사용

    • 패치조인 예시

      		select m from Member m join fetch m.team (JPQL)
		select M.*,T.* from Member m inner join Team t on m.team_id=t.id (SQL)

    • 회원을 조회하면서 연관된 팀도 함께 조회

    • 패치조인과 일반 조인 실행시 차이점은 연관된 엔터티를 함께 조회하지 않는다는 것이다

      select t from Team t join t.members m where t.name='팀A'(JPQL)
      select T.* from Team t inner join Member m on t.id = m.team_id (SQL)

패치조인의 특징/한계

  • 패치 조인대상에는 별칭을 줄 수 없다
  • 둘 이상의 컬렉션은 패치 조인 x
  • 컬렉션을 페치조인하면 페이징 API를 사용 할 수 없다
  • 엔터티에 직접 적용하는 글로벌 로딩 전략보다 우선시 됨(FetchType.LAZY)



다형성 쿼리

  • 조회대상을 특정 자식으로 한정하는 TYPE
[JPQL]
select i from Item i
where type(i) IN (Book, Movie) 

[SQL]
select i from i
where i.DTYPE in (‘B’, ‘M’)



엔터티 직접 사용

  • JPQL에서 엔터티를 직접 사용하면 SQL에서 해당 엔터티의 기본값을 사용
[JPQL]
select  count(m.id) from Member m 
select count(m) from Member m

[SQL]
select count(m.id) as cnt from Member m
  • 엔터티를 파라미터로 전달
String jpql = “select m from Member m where m = :member”;
List resultList = em.createQuery(jpql)
.setParameter("mem
  • 식별자를 직접 전달
String jpql = “select m from Member m where m.id = :memberId”;
List resultList = em.createQuery(jpql)
.setParameter("memberId", memberId).getResultList();
  • 실행된 SQL
select m.* from Member m where m.id=?



Named 쿼리

  • 미리 정의해서 이름을 부여해두고 사용하는 JPQL
  • 정적 쿼리
  • 에노테이션 또는 xml에 정의
  • 에플리케이션 로딩 시점에 초기화 후 재사용
  • 애플리케이션 로딩 시점에 쿼리를 검증
@Entity
@NamedQuery(
name = "Member.findByUsername",
query="select m from Member m where m.username = :username")
public class Member {
...
}

List<Member> resultList =
em.createNamedQuery("Member.findByUsername", Member.class)
.setParameter("username",
"회원1").getResultList();

xml 정의(src/META-INF/...xml)

<?xml version="1.0" encoding="UTF-8"?>
	<entity-mappings xmlns="http://xmlns.jcp.org/xml/ns/persistence/orm" version="2.1">
		<named-query name="Member.findByUsername">
			<query><![CDATA[
          select m
          from Member m
          where m.username = :username
          ]]>
          	</query>
		</named-query>
	<named-query name="Member.count">
		<query>select count(m) from Member m</query>
	</named-query>
</entity-mappings>
  • xml이 항상 우선권을 가짐
  • 운영환경에 따라 다른 xml을 배포 가능



벌크 연산

  • JPA 변경 감지로 순식간에 많은 양의 쿼리가 나갈수 있다
    • 재고가 10개 미만인 상품을 리스트로 조회
    • 상품 엔터티 가격 10% 증가
    • 트랜잭션 커밋 시점에 변경감지 동작
  • 변경된 데이터가 100건이면 100번의 UPDATE 쿼리 실행
String qlString = "update Product p " +
"set p.price = p.price * 1.1 " +
"where p.stockAmount < :stockAmount";
int resultCount = em.createQuery(qlString)
.setParameter("stoc
  • executeUpdate(): 쿼리 한번으로 여러 테이블 로우 변경
  • 벌크 연산은 영속성 컨텍스트를 무시하고 데이터베이스에 직접 쿼리
    • 벌크 연산을 먼저 수행
    • 벌크 연산 수행 후 영속성 컨텍스트 초기화

출처:https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-db-2

profile
이동건 (불꽃냥펀치)
자바를 사랑합니다
이전 포스트

프로젝트로 정리하는 리액트(3)

다음 포스트

QueryDSL 시작

0개의 댓글