ActiveRecord에서 스코프 사용하기

Ruby on Rails는 데이터베이스와의 상호작용을 간편하게 해주는 ActiveRecord를 제공합니다. ActiveRecord의 스코프는 쿼리를 재사용할 수 있는 강력한 도구입니다. 이 글에서는 ActiveRecord에서 스코프를 사용하는 방법에 대해 알아보겠습니다.

스코프란 무엇인가?

스코프는 ActiveRecord 모델에서 정의된 메서드로, 특정 조건을 가진 쿼리를 캡슐화하여 재사용할 수 있게 해줍니다. 스코프를 사용하면 코드의 가독성을 높이고, 중복을 줄일 수 있습니다.

스코프의 기본 사용법

스코프는 모델 클래스 내에서 정의됩니다. 기본적인 스코프의 정의 방법은 다음과 같습니다:

class Post < ApplicationRecord
  scope :published, -> { where(published: true) }
end

위의 예제에서 `published`라는 스코프는 `published` 컬럼이 `true`인 모든 포스트를 반환합니다. 이제 이 스코프를 사용하여 쿼리를 작성할 수 있습니다.

Post.published

이렇게 하면 `published`가 `true`인 모든 포스트를 가져오는 쿼리가 실행됩니다.

스코프의 장점

스코프를 사용하면 여러 가지 장점이 있습니다:

코드 재사용성: 동일한 쿼리를 여러 번 작성할 필요가 없습니다.
가독성 향상: 쿼리의 의도를 명확하게 표현할 수 있습니다.
유지보수 용이: 쿼리 조건을 변경할 때 스코프만 수정하면 됩니다.

스코프의 다양한 활용

스코프는 단순한 조건뿐만 아니라 다양한 방식으로 활용할 수 있습니다. 다음은 몇 가지 예시입니다:

여러 조건을 가진 스코프

class Post < ApplicationRecord
  scope :recent, -> { order(created_at: :desc) }
  scope :published_recent, -> { published.recent }
end

위의 예제에서 `published_recent` 스코프는 `published` 스코프와 `recent` 스코프를 조합하여 사용합니다. 이렇게 하면 `published`가 `true`인 포스트 중에서 가장 최근에 생성된 포스트를 가져올 수 있습니다.

파라미터를 받는 스코프

스코프는 파라미터를 받을 수도 있습니다. 다음은 파라미터를 사용하는 예시입니다:

class Post < ApplicationRecord
  scope :by_author, ->(author_id) { where(author_id: author_id) }
end

위의 예제에서 `by_author` 스코프는 특정 저자 ID에 해당하는 포스트를 반환합니다. 사용 방법은 다음과 같습니다:

Post.by_author(1)

스코프와 메서드 체이닝

ActiveRecord의 스코프는 메서드 체이닝을 통해 더욱 강력하게 사용할 수 있습니다. 여러 스코프를 조합하여 복잡한 쿼리를 쉽게 작성할 수 있습니다.

Post.published.recent.by_author(1)

위의 예제는 `published`가 `true`인 포스트 중에서 저자 ID가 1인 포스트를 가장 최근에 생성된 순서로 가져옵니다.

스코프의 성능

스코프는 쿼리를 재사용할 수 있게 해주지만, 성능에 영향을 미칠 수 있습니다. 스코프를 사용할 때는 다음 사항을 고려해야 합니다:

스코프가 복잡해질수록 쿼리 성능이 저하될 수 있습니다.
인덱스를 적절히 설정하여 쿼리 성능을 최적화해야 합니다.
스코프를 사용할 때는 쿼리의 실행 계획을 확인하여 성능을 분석해야 합니다.

스코프의 테스트

스코프를 정의한 후에는 테스트를 통해 올바르게 작동하는지 확인해야 합니다. RSpec을 사용한 테스트 예시는 다음과 같습니다:

RSpec.describe Post, type: :model do
  describe '.published' do
    it 'returns only published posts' do
      published_post = Post.create!(published: true)
      unpublished_post = Post.create!(published: false)

      expect(Post.published).to include(published_post)
      expect(Post.published).not_to include(unpublished_post)
    end
  end
end

위의 테스트는 `published` 스코프가 올바르게 작동하는지 확인합니다. 이와 같은 방식으로 다른 스코프들도 테스트할 수 있습니다.

결론

ActiveRecord의 스코프는 쿼리를 간편하게 재사용할 수 있는 유용한 도구입니다. 스코프를 사용하면 코드의 가독성을 높이고, 유지보수를 용이하게 할 수 있습니다. 다양한 조건과 메서드 체이닝을 통해 복잡한 쿼리도 쉽게 작성할 수 있습니다. 스코프를 적절히 활용하여 Rails 애플리케이션의 데이터베이스 작업을 더욱 효율적으로 만들어 보세요!