하나의 SQL 질의를 사용하기 위해, 당신은 SQL 결과셋을 설명할 필요가 있고, 이 설명은 EntityManager으로하여금 당신의 컬럼들을 엔티티 프로퍼티들 상으로 매핑시키기는 것을 도와줄 것이다. 이것은 @SqlResultSetMapping 주해를 사용하여 행해진다. 각각의 @SqlResultSetMapping은 EntityManager 상에 한 개의 SQL 질의를 생성시킬 때 사용되는 한 개의 이름을 갖는다.

@SqlResultSetMapping(name="GetNightAndArea", entities={
    @EntityResult(name="org.hibernate.test.annotations.query.Night", fields = {
        @FieldResult(name="id", column="nid"),
        @FieldResult(name="duration", column="night_duration"),
        @FieldResult(name="date", column="night_date"),
        @FieldResult(name="area", column="area_id")
    }),
    @EntityResult(name="org.hibernate.test.annotations.query.Area", fields = {
        @FieldResult(name="id", column="aid"),
        @FieldResult(name="name", column="name")
    })
    }
)

//or
@SqlResultSetMapping(name="defaultSpaceShip", entities=@EntityResult(name="org.hibernate.test.annotations.query.SpaceShip"))

@SqlResultSetMapping.에 대한 추가 정보는 Hibernate Annotations 참조 안내서를 참조하길 바란다.

TODO: 이것은 사기처럼 들린다...

결과 셋이 설명되고, 우리가 native SQL 질의를 실행하는 가용성이 있다는 점을 노트하라. EntityManager는 모든 필요한 API들을 제공한다. 첫 번째 메소드는 바인딩을 행하는데 한 개의 SQL 결과셋 이름을 사용하는 것이고, 두 번째 메소드는 엔티티 디폴트 매핑을 사용한다(반환된 컬럼은 매핑에서 사용된 컬럼 이름과 동일한 이름을 가져야 한다). (아직 Hibernate 엔티티 관리자에 의해 지원되지 않는) 세 번째 메소드는 순수 스칼라 결과들을 반환한다.

String sqlQuery = "select night.id nid, night.night_duration, night.night_date, area.id aid, "
    + "night.area_id, area.name from Night night, Area area where night.area_id = area.id "
    + "and night.night_duration >= ?";
Query q = entityManager.createNativeQuery(sqlQuery, "GetNightAndArea");
q.setParameter( 1, expectedDuration );
q.getResultList();

이 native 질의는 GetNightAndArea 결과 셋에 기반하여 night들과 area를 반환한다.

String sqlQuery = "select * from tbl_spaceship where owner = ?";
Query q = entityManager.createNativeQuery(sqlQuery, SpaceShip.class);
q.setParameter( 1, "Han" );
q.getResultList();

두 번째 버전은 당신의 SQL 질의가 메타데이터 내에 매핑된 컬럼들과 동일한 컬럼들을 재사용하여 한 개의 엔티티를 반환할 때 유용하다.

native 명명된 질의들은 EJB-QL 명명된 질의들과 동일한 호출 API를 공유한다. 당신의 코드는 둘 사이의 차이점을 알 필요가 없다. 이것은 SQL로부터 EJB-QL로의 이관에 매우 유용하다:

Query q = entityManager.createNamedQuery("getSeasonByNativeQuery");
q.setParameter( 1, name );
Season season = (Season) q.getSingleResult();