Rails 7.1의 커스텀 정렬을 위한 `in_order_of` 메서드

Sorting elegantly in Rails with in_order_of

stadia 2025년 04월 28일 https://thoughtbot.com/blog/sorting-elegantly-in-rails-with-in_order_of

3줄 요약

  • Rails 7.1 이전의 커스텀 정렬은 SQL 또는 비효율적인 Ruby 코드를 사용했습니다.
  • 새로운 `in_order_of` 메서드는 데이터베이스 독립적인 방식으로 간편하게 커스텀 정렬을 지원합니다.
  • 이 메서드는 가독성과 유지보수성을 높이지만, 특정 경우에는 성능 및 인덱스 활용에 제한이 있을 수 있습니다.

Rails 애플리케이션에서 특정 컬럼의 값을 원하는 순서대로 정렬해야 하는 요구사항은 흔하게 발생합니다. 예를 들어, 작업(Task) 모델의 상태(status)를 '진행 중', '대기 중', '완료됨', '보관됨' 순으로 정렬하고 싶을 수 있습니다. Rails 7.1 이전에는 이러한 커스텀 정렬을 구현하기 위해 다소 복잡하고 비효율적인 방법을 사용해야 했습니다. 하지만 Rails 7.1부터 도입된 `in_order_of` 메서드는 이러한 커스텀 정렬 작업을 훨씬 간결하고 효율적으로 수행할 수 있도록 지원합니다.

과거 Rails 버전에서 커스텀 정렬을 구현하는 방법은 크게 두 가지로 나눌 수 있었습니다. 첫째는 Arel.sql을 사용하여 데이터베이스의 특정 함수(예: MySQL의 FIELD)나 CASE WHEN 구문을 직접 사용하는 방식입니다. 예를 들어, Task.order(Arel.sql("FIELD(status, 1, 0, 2, 3)")) 또는 Task.order(Arel.sql("CASE status WHEN 1 THEN 1 WHEN 0 THEN 2 ... END"))와 같이 작성했습니다. 이러한 SQL 기반의 방식은 데이터베이스 엔진에 종속적이며, 특히 enum 값을 사용하는 경우 데이터베이스의 숫자 값과 애플리케이션의 심볼/문자열 값 간의 매핑을 직접 관리해야 하여 가독성이 떨어지는 단점이 있었습니다.

둘째는 모든 레코드를 메모리로 로드한 후 Ruby 코드(sort_by)로 정렬하는 방식입니다. Task.all.sort_by { |task| custom_order.index(task.status) }와 같은 형태입니다. 이 방식은 데이터베이스에 독립적이고 Ruby 코드 내에서 순서를 명확하게 정의할 수 있지만, 대량의 데이터를 처리할 때 모든 레코드를 메모리에 올려야 하므로 심각한 성능 문제를 야기할 수 있습니다.

Rails 7.1에서 등장한 in_order_of 메서드는 이러한 기존 방식의 단점을 극복하며 커스텀 정렬을 위한 우아하고 효율적인 해결책을 제시합니다. 사용법은 매우 간단합니다: Task.in_order_of(:status, [:in_progress, :pending, :completed, :archived]). 이 메서드는 내부적으로 데이터베이스 독립적인 CASE WHEN 구문을 생성하여 지정된 순서대로 데이터를 정렬하도록 합니다. 예를 들어, 위 Task 예시의 경우, SELECT "tasks".* FROM "tasks" ORDER BY CASE "tasks"."status" WHEN 1 THEN 0 WHEN 0 THEN 1 WHEN 2 THEN 2 WHEN 3 THEN 3 ELSE 4 END와 유사한 SQL이 생성됩니다.

in_order_of 메서드의 주요 장점은 다음과 같습니다:

  • 데이터베이스 독립성: 특정 데이터베이스 문법에 의존하지 않고 다양한 데이터베이스 엔진에서 동일하게 작동합니다.
  • Rails 네이티브: Active Record 쿼리 인터페이스와 자연스럽게 통합되며 where, limit 등 다른 쿼리 메서드와 쉽게 연결하여 사용할 수 있습니다.
  • 타입 핸들링: 다양한 데이터 타입을 자동으로 적절하게 처리합니다.
  • 지연 로딩 유지: Ruby 측 정렬과 달리 쿼리 결과를 필요로 할 때까지 지연 로딩 상태를 유지하여 메모리 사용을 효율적으로 관리합니다.
  • 가독성 및 유지보수성: SQL 구문을 직접 작성하는 것보다 훨씬 직관적이고 읽기 쉬운 코드를 작성할 수 있습니다.

하지만 in_order_of 메서드에도 몇 가지 고려해야 할 단점이 있습니다:

  • 성능 오버헤드: 내부적으로 CASE WHEN SQL 문을 생성하므로, 정렬해야 할 값의 목록이 매우 길거나 복잡한 경우 성능에 영향을 줄 수 있습니다.
  • 인덱스 활용 제한: CASE WHEN 구문은 일반적으로 데이터베이스 인덱스를 효과적으로 활용하기 어렵게 만듭니다.
  • SQL 복잡성: 생성되는 SQL이 복잡해져서 데이터베이스 레벨에서의 최적화가 어려울 수 있습니다.
  • 누락된 값 처리: 지정된 정렬 목록에 포함되지 않은 값을 가진 레코드는 일반적으로 쿼리 결과의 마지막에 추가되는데, 이 순서가 예측 불가능할 수 있습니다.

결론적으로, Rails 7.1의 `in_order_of` 메서드는 Active Record 쿼리에서 특정 컬럼 값을 기준으로 커스텀 정렬을 구현하는 강력하고 간편한 도구입니다. 복잡한 SQL 구문이나 비효율적인 Ruby 측 정렬 대신 명확하고 데이터베이스 독립적인 코드를 작성할 수 있게 해주어 코드의 가독성과 유지보수성을 크게 향상시킵니다. 물론 대규모 데이터셋이나 복잡한 정렬 기준에서는 성능 제한이나 인덱스 활용의 어려움과 같은 단점이 있을 수 있으므로, 사용 사례에 맞춰 장단점을 충분히 고려하여 적용하는 것이 중요합니다. 커스텀 정렬 요구사항이 발생했을 때 `in_order_of`는 가장 먼저 고려해볼 만한 효과적인 대안임이 분명합니다.