스칼라쿼리

🧮 스칼라 쿼리(Scalar Query)

정의

스칼라 쿼리는 하나의 값 또는 단일 행의 일부 컬럼만 반환하는 쿼리다.

특징

• 반환 값이 테이블 전체가 아니라 단일 값 또는 일부 컬럼이다.
• COUNT(*), MAX(age), SELECT name FROM users WHERE id = 1 같은 형태가 대표적이다.
• JPA에서 Native Query를 사용할 때 반환 타입에 주의해야 한다.

예시

-- 단일 값 반환
SELECT COUNT(*) FROM users;

-- 단일 행의 일부 컬럼 반환
SELECT id, name FROM users WHERE id = 100;

example

JPA Native Query 예시

String sql = "SELECT name FROM users WHERE id = :id";
Query query = entityManager.createNativeQuery(sql);
query.setParameter("id", 1);
String name = (String) query.getSingleResult();

🧩 정리

• 스칼라 쿼리는 한 개의 값을 가져올 때 유용하다.
• 집계 함수와 단일 컬럼 조회에 자주 쓰인다.
• JPA에서는 결과 타입을 명확히 처리해야 한다.

연결문서