[뉴스] 몽고DB, 하이버네이트 ORM 확장 정식 출시

몽고DB(MongoDB)가 하이버네이트 ORM용 확장 라이브러리를 2026년 10월 13일 정식 출시(GA)했습니다. 공개 프리뷰를 거쳐 정식판으로 올라온 것으로, 자바 개발자가 기존 하이버네이트 방식 그대로 몽고DB의 도큐먼트 모델에 접근할 수 있게 해주는 1차 당사 오픈소스 라이브러리입니다. 즉 @Entity 어노테이션, HQL, Criteria 쿼리, Session API를 그대로 쓰면서 저장소만 관계형 DB 대신 몽고DB를 쓰는 구조입니다.

정식판에서 추가된 항목은 다음과 같습니다.

• JOIN 지원 - INNER와 LEFT OUTER 조인을 표준 HQL 문법으로 처리
• 낙관적 잠금 - @Version 기반 동시성 제어
• 스프링 부트 자동 구성 - 몽고DB 접속 URL에서 다이얼렉트와 커넥션 공급자를 자동 인식
• 예외 메시지와 로깅 개선

동작 방식은 HQL을 몽고DB 집계 파이프라인으로 변환하는 것입니다. 공식 블로그 예시를 보면 where c.country = 'CANADA' and c.age > 18 같은 조건이 $match와 $project 단계로 바뀝니다. 다만 주의할 점이 있습니다. 실행하려면 하이버네이트 ORM을 7.4 LTS로 올려야 하고, 모든 SQL 구문이 도큐먼트 모델로 1:1 매핑되지는 않습니다. 몽고DB도 HQL 전체 커버리지를 목표로 하지 않는다고 밝혔습니다.

스프링 JPA 기반으로 운영하던 서비스에서 일부 도메인을 몽고DB로 옮길 때 선택지가 하나 늘었다는 점이 의미가 있어 보입니다. 기존에는 스프링 데이터 몽고DB를 따로 쓰면서 JPA 코드와 접근 방식이 갈라졌는데, 이번 확장은 JPA/하이버네이트 코드 자산을 유지한 채 저장소만 바꾸는 마이그레이션 경로를 제시합니다. 다만 쿼리 변환의 한계와 하이버네이트 7.4 요구 사항이 있으니 실제 적용 전에는 자주 쓰는 쿼리가 집계 파이프라인으로 제대로 변환되는지 먼저 확인하는 편이 안전해 보입니다.

🔗 https://www.mongodb.com/company/blog/product-release-announcements/extension-for-hibernate-orm-now-ga