/ /

기능 호환성

개요

이 페이지에서는 Hibernate ORM 확장에서 지원되는 기능과 지원되지 않는 기능에 대한 정보를 찾을 수 있습니다. 최대 절전 모드 ORM 확장은 MongoDB 복제본 세트만 지원합니다. 지원되지 않는 기능 사용하면 최대 절전 모드 ORM 확장에서 UnsupportedFeatureException 오류가 발생합니다.

이 페이지에서 현재 향후 릴리스로 계획된 기능도 확인할 수 있습니다. 사용자 요구에 따라 향후 기능에 우선순위를 부여하며, AHA 아이디어를 만들어기능 에 대한 지원 요청 수 있습니다.

최대 절전 모드 ORM용 MongoDB 확장은 현재 공개 미리 보기로 제공됩니다. 공개 미리 보기는 호환성이 손상되는 변경이 발생할 수 있으므로 프로덕션 배포에는 권장되지 않습니다.

MongoDB 기능

이 섹션은 하이버네이트 ORM 확장이 다양한 MongoDB 기능을 지원하는지 여부를 나타냅니다.

데이터 유형 지원

최대 절전 모드 ORM 확장에서 지원되는 모든 BSON types 목록을 보려면 엔티티 생성 가이드 의 MongoDB BSON 필드 섹션을 참조하세요.

쿼리 지원

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
일괄 쓰기	✓	✓
삭제 작업	✓	✓
지리공간 쿼리	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 지리 공간적 쿼리를 지원합니다. MongoDB 쿼리 언어 성명서 에 `$geoWithin` 또는 `$near` 파이프라인 단계를 포함합니다. 네이티브 쿼리에 대해 자세히 학습하려면 네이티브 데이터베이스 쿼리 수행 가이드를 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
삽입 작업	✓	✓
MongoDB 검색 쿼리	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 검색 쿼리를 지원합니다. MongoDB 쿼리 언어 성명서 에 `$search` 파이프라인 단계를 포함합니다. 예시 보려면 네이티브 데이터베이스 쿼리 수행 가이드의 MongoDB 검색 쿼리 실행 섹션을 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MongoDB Vector Search 검색 쿼리	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 벡터 검색 쿼리를 지원합니다. MongoDB 쿼리 언어 성명서 에 `$vectorSearch` 파이프라인 단계를 포함합니다. 네이티브 쿼리에 대해 자세히 학습하려면 네이티브 데이터베이스 쿼리 수행 가이드를 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MQL 사용한 네이티브 쿼리	Partially Supported. Parameter binding is not supported.	✓
프로젝션	Partially Supported. Aggregation expressions within query projections are not supported, and you must include all entity fields in your projection.	Partially Supported. The same aggregation expression and entity field limitations apply.
읽기 작업	✓	✓
업데이트 작업	✓	✓
업서트 작업	지원되지 않습니다. 그러나 먼저 컬렉션 쿼리 지정된 값이 존재하는지 확인한 다음 값이 존재하는 경우 삽입하거나 업데이트 .	GA 출시하다 에서 이 기능 고려하고 있습니다.

데이터베이스 및 컬렉션 지원

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
변경 스트림	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoClient.watch()` 메서드를 사용하여 변경 스트림 엽니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
클라이언트 사이드 필드 레벨 암호화 (CSFLE) 및 Queryable Encryption (QE)	지원되지 않습니다. 그러나 MongoDB Java 드라이버 구성할 때 CSFLE/QE를 설정 수 있습니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
GridFS.	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoDatabase` 인스턴스를 매개 인스턴스 로 사용하여 `GridFSBuckets.create()` 메서드를 호출하여 GridFSBucket을 인스턴스화합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
시계열 데이터	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `timeSeriesOptions()` 을(를) 지정하여 새 컬렉션 만들어 time series 컬렉션 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
독립형 `mongod` 인스턴스	지원되지 않습니다. 모든 독립형 인스턴스를 복제본 세트 로 변환하는 것이 좋습니다. 자세한 학습 은 MongoDB Server 매뉴얼의 독립형 자체 관리형 mongod 복제본 세트로 변환 을 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
조회수	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoDatabase` 인스턴스 에서 `createView()` 메서드를 호출하여 새 뷰를 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.

트랜잭션 및 동시성

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
잠금	부분적으로 지원됩니다. 낙관적 잠금이 지원됩니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
트랜잭션	✓	✓

매핑 및 모델 지원

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
연관 관계	지원되지 않습니다.	✓
ID 자동 생성	부분적으로 지원됩니다. ObjectId 자동 생성이 지원됩니다. 그러나 UUID는 수동으로 설정하다 수 있습니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
상속 전략	지원되지 않습니다.	✓
지연/열심히 가져오기	지원되지 않습니다.	지원되지 않습니다.
주문 중	✓	✓
유효성 검사	✓	✓

인덱스 지원

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
고정 사이즈 컬렉션	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `createCollection()` 호출에서 `CreateCollectionOptions.capped(true)` 을(를) 매개 변수로 지정하여 고정 사이즈 컬렉션 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
클러스터형 컬렉션	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `clusteredIndex` (이)라는 문서 만들고 클러스터형 인덱스 정의합니다. 이 클러스터형 인덱스 클러스터형 컬렉션 정의하는 `MongoDatabase.runCommand()` 메서드에 전달하는 문서 의 일부로 사용합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
복합 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 중첩된 메서드 `MongoCollection.createIndex(Indexes.compoundIndex())` 를 호출하여 복합 인덱스 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
내장된 문서 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 중첩된 메서드 `MongoCollection.createIndex(Indexes.ascending("field.subfield"))`를 호출합니다. 이 메서드는 필드 된 키 경로를 사용합니다. 내장된 문서 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
지리 공간적 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 중첩된 메서드 `MongoCollection.createIndex(geo2dsphere("location"))` 를 호출하여 `location` 필드 에 지리 공간적 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MongoDB Search 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoCollection.createSearchIndex()` 메서드를 호출하여 MongoDB 검색 인덱스를 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MongoDB Vector Search 검색 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `vector` 유형이 `SearchIndexModel` 인 `MongoCollection.createSearchIndexes()` 메서드를 호출하여 MongoDB 벡터 검색 인덱스를 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
Multikey 인덱스	지원되지 않습니다. 배열 필드에 대한 기본값 MongoDB 동작을 사용합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
부분 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 중첩된 메서드 `MongoCollection.createIndex(Indexes.partialFilterExpression())` 를 호출하여 부분 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
스키마 유효성 검사	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoDatabase.runCommand()` 메서드를 통해 `collMod` 명령을 실행하여 유효성 검사기를 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
단일 필드 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 중첩된 메서드 `MongoCollection.createIndex(Indexes.ascending("field"))` 를 호출하여 `field` 필드 에 오름차순으로 단일 필드 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
스파스 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoCollection.createIndex()` 메서드 호출에서 `IndexOptions().sparse(true)` 을(를) 매개 변수로 지정하여 희소 인덱스 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
Unique indexes	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 `MongoClient` 인스턴스 정의할 수 있습니다. 그런 다음 `MongoCollection.createIndex()` 메서드 호출에서 `IndexOptions().unique(true)` 을(를) 매개 변수로 지정하여 희소 인덱스 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
모델 생성 후 임베디드 모델 인덱스 업데이트	지원되지 않습니다. 그러나 내장된 모델 인덱스를 수동으로 제거하고 다시 만들 수 있습니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.

최대 절전 모드 ORM 기능

이 섹션은 최대 절전 모드 ORM 확장이 다양한 최대 절전 모드 ORM 기능을 지원하는지 여부를 나타냅니다.

데이터 유형 지원

데이터 유형	공개 미리 보기 지원	GA(일반 가용성) 지원
컬렉션 유형(목록, 세트, 맵, 배열)	✓. `@ElementCollection` and `CollectionTable` are not supported. However, collections of embedded structs are supported through embeddable classes annotated with `@Embeddable` and `@Struct`.	✓. The same `@ElementCollection` and `CollectionTable` limitations apply.
포함 가능한 엔터티, 스칼라 유형	Partially Supported. The `java.time.Instant` type is supported for top-level and nested entities.	Partially Supported. The `java.time.Instant` type is supported for top-level and nested entities.
임베디드 엔터티, 바이너리	✓	✓
내장된 엔터티, 식별자 유형	Partially Supported. Manually set the ID of an entity before persisting an entity.	We are considering this feature for GA release.
내장된 엔터티, JSON	✓	✓
내장된 엔터티, Null 시맨틱	✓	✓
최상위 엔티티, 바이너리	✓	✓
최상위 엔티티, 식별자 유형	✓ Manually assign UUIDs before persisting an entity.	✓ Manually assign UUIDs before persisting an entity.
최상위 엔티티, JSON	✓	✓
최상위 엔티티, Null 시맨틱	✓	✓
최상위 엔터티, 스칼라 유형	✓	✓
최상위 엔티티, 임시 유형	Partially Supported. The `java.time.Instant` type is supported for top-level and nested entities.	Partially Supported. The `java.time.Instant` type is supported for top-level and nested entities.
삼항 로직(True, False 또는 UNKNOWN)	지원되지 않습니다.	계획됨.

쿼리 지원

최대 절전 모드 ORM 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
HQL 및 JPQL 쿼리, 애그리게이션 연산자	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 애그리게이션 연산자를 지원합니다. MongoDB 쿼리 언어 성명서 에 연산자 포함합니다. 네이티브 쿼리에 대해 자세히 학습하려면 네이티브 데이터베이스 쿼리 수행 가이드를 참조하세요.	계획됨.
HQL 및 JPQL 쿼리, 산술 연산자	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 산술 연산자를 지원합니다. 예시 보려면 네이티브 데이터베이스 쿼리 수행 가이드 의 산술 연산자 사용 섹션을 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
HQL 및 JPQL 쿼리, 배열 연산자	✓	✓
HQL 및 JPQL 쿼리, 비교 연산자	Partially Supported. The operators `LIKE`, `BETWEEN`, `IN`, `EXISTS`, `ANY`, `ALL`, and `IS NULL` are not currently supported. However, you can use the `createNativeQuery()` method and pass comparison operators in your MongoDB Query Language statement. To learn more about native queries, see the Perform Native Database Queries guide.	Planned.
HQL 및 JPQL 쿼리, 요소 연산자	✓	✓
HQL 및 JPQL 쿼리, 평가 연산자	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 평가 연산자를 지원합니다. MongoDB 쿼리 언어 성명서 에 연산자 포함합니다. 네이티브 쿼리에 대해 자세히 학습하려면 네이티브 데이터베이스 쿼리 수행 가이드를 참조하세요.	계획됨.
HQL 및 JPQL 쿼리, JOINS	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드를 사용하여 여러 컬렉션을 쿼리하는 집계 작업을 실행 수 있습니다. 네이티브 쿼리에 대해 자세히 학습하려면 네이티브 데이터베이스 쿼리 수행 가이드를 참조하세요.	계획됨.
HQL 및 JPQL 쿼리, 논리 연산자	✓	✓

데이터베이스 및 컬렉션 지원

최대 절전 모드 ORM 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
첫 번째 수준 캐시	✓	✓
두 번째 수준 캐시	✓	✓

프레임워크 및 라이브러리 지원

이 섹션은 하이버네이트 ORM 확장이 다양한 외부 프레임워크 또는 라이브러리를 지원하는지 여부를 나타냅니다.

프레임워크 또는 라이브러리	공개 미리 보기 지원	GA(일반 가용성) 지원
Spring Boot 및 Spring 데이터	부분적으로 지원됩니다. 모든 Spring Boot 또는 Spring Data 기능에 대한 지원 보장하지는 않습니다. 하이버네이트 ORM 확장과 스프링 데이터로 만든 앱 의 예시 는 MongoDB 하이버네이트 앱 을 사용한 Spring 데이터를 참조하세요.	부분적으로 지원됩니다. 모든 Spring Boot 또는 Spring Data 기능에 대한 지원 보장하지는 않습니다. 하이버네이트 ORM 확장과 스프링 데이터로 만든 앱 의 예시는 MongoDB 하이버네이트 앱을 사용한 스프링 데이터 를 참조하세요.

돌아가기

트랜잭션

이슈 & 도움말