[Spring] @Query 에 대해서 알아보자

Spring Framework은 개발자들이 데이터베이스와 상호작용하기 위해 사용되는 다양한 기능을 제공합니다. 그 중에 @Query 어노테이션은 JPA(Java Persistence API)를 사용할 때 유용하게 쓰이며, 데이터베이스 쿼리를 정의하고 실행할 때 사용됩니다. 이번 글에서는 @Query 어노테이션에 대해 자세히 알아보겠습니다.

 

@Query란?

@Query 어노테이션은 JPA에서 제공하는 어노테이션 중 하나로, 데이터베이스 쿼리를 직접 작성하고 실행할 때 사용됩니다. 이 어노테이션을 사용하면 Spring Framework에서 제공하는 Repository 인터페이스를 구현할 때 쿼리를 간편하게 작성하고 사용할 수 있습니다.

 

@Query 어노테이션 사용하기

@Query 어노테이션은 다음과 같이 사용할 수 있습니다.

@Query("SELECT e FROM Employee e WHERE e.salary > ?1")
List<Employee> findEmployeesWithSalaryGreaterThan(double salary);

위의 예제에서는 @Query 어노테이션으로 데이터베이스 쿼리를 작성하고 있습니다. 쿼리의 결과는 List<Employee>로 반환됩니다. 이 예제에서는 Employee 엔티티의 salary 필드가 매개변수로 전달된 값보다 큰 모든 레코드를 검색합니다.

또한, @Query 어노테이션에는 위치 기반 매개변수와 이름 기반 매개변수를 사용할 수 있습니다. 위치 기반 매개변수는 물음표(?)로 표시되며, 매개변수의 위치에 따라 매핑됩니다. 이름 기반 매개변수는 콜론(:)으로 시작하며, 매개변수 이름과 함께 지정됩니다.

@Query("SELECT e FROM Employee e WHERE e.salary > :salary AND e.department = :department")
List<Employee> findEmployeesWithSalaryGreaterThanAndDepartment(double salary, String department);

위의 예제에서는 @Query 어노테이션에서 이름 기반 매개변수를 사용하고 있습니다. 매개변수로 전달된 salary와 department 값에 따라 적합한 레코드를 검색합니다.

 

@Query 어노테이션을 사용할 때 주의할 점

@Query 어노테이션을 사용할 때는 다음과 같은 주의점이 있습니다.

• 쿼리가 유효한지 확인하세요. 쿼리에 오류가 있으면 애플리케이션이 제대로 작동하지 않을 수 있습니다.
• 쿼리를 매개변수화하세요.
• SQL Injection 공격을 방지하기 위해서, 매개변수화된 쿼리를 사용하는 것이 좋습니다. Spring Framework에서는 자동으로 매개변수화된 쿼리를 생성해줍니다.
• 쿼리를 최적화하세요. 쿼리가 느리다면 데이터베이스 성능에 악영향을 미칠 수 있습니다. 쿼리를 최적화하거나 인덱스를 추가하는 등의 방법으로 성능을 향상시킬 수 있습니다.

정리

이번 글에서는 Spring Framework에서 제공하는 @Query 어노테이션에 대해 알아보았습니다. @Query 어노테이션을 사용하면 JPA를 사용할 때 데이터베이스 쿼리를 간단하게 작성하고 사용할 수 있습니다. 그러나 쿼리의 유효성을 확인하고 매개변수화하며 최적화하는 것이 중요합니다. 이를 통해 데이터베이스 성능을 향상시킬 수 있습니다.