/ /

최대 절전 모드 ORM 기능 호환성

개요

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

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

MongoDB Extension for Hibernate ORM is currently in Public Preview. Public Preview is not recommended for production deployments, because breaking changes might be introduced.

MongoDB 기능

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

데이터 유형 지원

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

쿼리 지원

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
일괄 쓰기	✓	✓
삭제 작업	✓	✓
지리공간 쿼리	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 지리 공간적 쿼리를 `$geoWithin` `$near` 지원합니다. MongoDB 쿼리 언어 성명서 에 또는 파이프라인 단계를 포함합니다. 네이티브 쿼리에 대해 자세히 학습 네이티브 데이터베이스 쿼리 수행 가이드 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
삽입 작업	✓	✓
MongoDB Search 쿼리	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 검색 쿼리를 지원합니다.`$search` MongoDB 쿼리 언어 성명서 에 파이프라인 단계를 포함합니다. 예시 보려면 네이티브 데이터베이스 쿼리 수행 가이드 의 MongoDB Search 쿼리 실행 섹션을 참조하세요.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MongoDB Vector Search 쿼리	지원되지 않습니다. 그러나 `createNativeQuery()` 메서드는 벡터 검색 쿼리를 지원합니다.`$vectorSearch` MongoDB 쿼리 언어 성명서 에 파이프라인 단계를 포함합니다. 네이티브 쿼리에 대해 자세히 학습 네이티브 데이터베이스 쿼리 수행 가이드 참조하세요.	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` 그런 다음 인스턴스 `GridFSBuckets.create()` 매개 변수로 사용하여 `MongoDatabase` 메서드를 호출하여 GridFSBucket을 인스턴스화합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
시계열 데이터	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 을(를) 지정하여 새 컬렉션 `timeSeriesOptions()` 만들어 time series 컬렉션 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
조회수	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 `createView()` 인스턴스 에서 메서드를 `MongoDatabase` 호출하여 새 뷰를 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.

트랜잭션 및 동시성

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

매핑 및 모델 지원

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

인덱스 지원

MongoDB 기능	공개 미리 보기 지원	GA(일반 가용성) 지원
고정 사이즈 컬렉션	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 호출에서 을(를) 매개 `CreateCollectionOptions.capped(true)` 변수로 지정하여 고정 사이즈 `createCollection()` 컬렉션 만듭니다.	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"))` 호출합니다. 이 메서드는 중첩된 키 경로 ' 필드.subfield'를 사용하여 내장된 문서 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
지리 공간적 인덱스	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 `MongoCollection.createIndex(geo2dsphere("location"))` 중첩된 메서드 를 호출하여 `location` 필드 에 지리 공간적 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MongoDB Search 인덱스	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 메서드를 호출하여 `MongoCollection.createSearchIndex()` MongoDB Search 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
MongoDB Vector Search 인덱스	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 있습니다. 그런 `MongoClient` `MongoCollection.createSearchIndexes()` 다음 유형이 `vector` 인 메서드를 `SearchIndexModel` 호출하여 MongoDB Vector Search 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
Multikey 인덱스	지원되지 않습니다. 배열 필드에 기본값 MongoDB 동작을 사용합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
부분 인덱스	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 `MongoCollection.createIndex(Indexes.partialFilterExpression())` 중첩된 메서드 를 호출하여 부분 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
스키마 유효성 검사	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 있습니다.`MongoClient` 그런 다음 `collMod` 메서드를 통해 명령을 실행하여 유효성 검사기를 `MongoDatabase.runCommand()` 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
단일 필드 인덱스	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 `MongoCollection.createIndex(Indexes.ascending("field"))` 중첩된 메서드 를 호출하여 `field` 필드 에 오름차순으로 단일 필드 인덱스 생성합니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
스파스 인덱스	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 메서드 `IndexOptions().sparse(true)` 호출에서 을(를) 매개 변수로 지정하여 `MongoCollection.createIndex()` 희소 인덱스 만듭니다.	GA 출시하다 에서 이 기능 고려하고 있습니다.
Unique indexes	지원되지않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 수 `MongoClient` 있습니다. 그런 다음 메서드 `IndexOptions().unique(true)` 호출에서 을(를) 매개 변수로 지정하여 `MongoCollection.createIndex()` 희소 인덱스 만듭니다.	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	지원되지 않습니다. 그러나 MongoDB Java 드라이버 사용하여 인스턴스 정의할 `MongoClient` 수 있습니다. 그런 다음 집계 파이프라인 사용하여 여러 컬렉션을 쿼리 할 수 있습니다.	계획됨.
HQL 및 JPQL 쿼리, 논리 연산자	✓	✓

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

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

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

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

프레임워크 또는 라이브러리	공개 미리 보기 지원	GA(일반 가용성) 지원
Spring Boot 및 Spring 데이터	Partially Supported. We do not guarantee support for all Spring Boot or Spring Data features. See the Spring Data with MongoDB Hibernate App for an example of an app made with the Hibernate ORM extension and Spring Data.	부분적으로 지원됩니다. 모든 Spring Boot 또는 Spring Data 기능에 대한 지원보장하지는 않습니다. 하이버네이트 ORM 확장과 스프링 데이터로 만든 앱 의 예시 는 MongoDB 하이버네이트 앱을 사용한 스프링 데이터를 참조하세요.

돌아가기

트랜잭션

이슈 & 도움말