[JPA] 오프셋 기반 Pagenation 구현하기

Spring Data JPA에서는 Pagination을 쉽게 구현할 수 있도록 Pageable 객체를 제공한다.

오프셋 기반 Pagenation

DB의 offset쿼리를 사용하여 ‘페이지’ 단위로 구분하여 요청/응답 한다.

 

 

controller

/**
 * 게시물 page 조회
 *
 * @param pageable
 * @return Page<PostDto>
 */
@GetMapping(produces = APPLICATION_JSON_VALUE)
public ApiResponse<Page<PostDTO.Response>> getPosts(@PageableDefault(sort = "id", direction = Sort.Direction.DESC) Pageable pageable) {
    Page<PostDTO.Response> pages = postService.findAll(pageable);
    return ApiResponse.ok(pages);
}

service

public Page<PostDTO.Response> findAll(Pageable pageable) {
    return postRepository.findAll(pageable)
            .map(postConverter::convertResponseOnlyPostDto);
}

repository Page<T> findAll(Pageable pageable) 메소는 SpringDataJPA에서 기본적으로 제공해 주는 CRUD이다.

 

 

 

퀴리가 어떻게 나가는 지 확인해보자

@Test
@DisplayName("pageNation 쿼리 확인")
public void findAll(){
    Page<Post> pages = postRepository.findAll(PageRequest.of(0,10)); // page : 0 , size : 10
}

 

MySQL 에서라면 간단하게 OFFSET 쿼리와 LIMIT 쿼리에 콤마를 붙여 '건너 뛸' row 숫자를 지정하여 페이지네이션을 구현한다.

SELECT id FROM products ORDER BY id LIMIT (one_size *(page-1)), one_size;

-

SELECT * FROM products LIMIT 숫자 OFFSET 페이지 넘버;

OFFSET 키워드를 활용하는 방식. 결과와 성능은 동일하다.

 

 

Pageable을 사용하지 않고 쿼리를 직접 작성해 보려고도 하였으나 JPQL는  limit 키워드를 지원하지 않는다고 한다. JPA에서 limit을 사용하고 싶다면 무조건 pagenation를 하거나 아니면 쿼리로 작성하고 싶다면 NativeQuery를 사용하거나 QueryDSL을 사용해야할 것 같다.

 

 

PageRequest

PageRequest에 의해 Pageable에 페이징 정보가 담겨 객체화 된다.

• of(int page, int size) : 0부터 시작하는 페이지 번호와 개수. 정렬이 지정되지 않음
• of(int page, int size, Sort sort) : 페이지 번호와 개수, 정렬 관련 정보
• of(int page int size, Sort sort, Direction direction, String ... props) : 0부터 시작하는 페이지 번호와 개수, 정렬의 방향과 정렬 기준 필드들

 

@PageableDefault

spring mvc에 의해 컨트롤러에서 Pageable을 파라미터로 받을 수 있다. 스프링 데이터는 pageable에 PageRequest 객체를 주입해준다.

→ 이때 요청 파라미터를 통해 page(0부터 시작),size,sort를 받을 수 있다.

스프링 부트에선 기본으로 defualt size 20, max page size 2000으로 등록되어 있다.

@PageableDefault 어노테이션을 사용하여 개별 설정이 가능하다. 기본 defult 값이 있더라도 명시적으로 선언해 주는 것이 좋다.

 

 

 

offset 쿼리의 퍼포먼스 이슈

극단적으로 10억번째 페이지에 있는 값을 찾고싶다면 offset에 매우 큰 숫자가 들어간다. 정렬 기준 해당 row가 몇번째 순서인지 알지 못하므로 지정된 offset까지 모두 만들어 놓은 후 지정된 갯수를 순회하여 자라는 방식이다. 때문에 퍼포먼수가 이에 비례하여 떨어지게 된다.

Faster Pagination in Mysql – Why Order By With Limit and Offset is Slow?

Why Order By With Limit and Offset is Slow - Faster Pagination in Mysql

 

 

 

 

 

잘못된 정보가 있다면 댓글을 통해 알려주세요. 감사합니다.