Feature Compatibility

✓

✓

Unsupported. However, the createNativeQuery() method supports geospatial queries. Include the $geoWithin or $near pipeline stage in your MongoDB Query Language statement. To learn more about native queries, see the Perform Native Database Queries guide.

✓

Unsupported. However, the createNativeQuery() method supports Search queries. Include the $search pipeline stage in your MongoDB Query Language statement. To view an example, see the Run a MongoDB Search Query section in the Perform Native Database Queries guide.

Unsupported. However, the createNativeQuery() method supports Vector Search queries. Include the $vectorSearch pipeline stage in your MongoDB Query Language statement. To learn more about native queries, see the Perform Native Database Queries guide.

✓

Partially Supported. Aggregation expressions within query projections are not supported, and you must include all entity fields in your projection.
When the terminal $project stage does not specify _id, the Hibernate ORM extension excludes _id from the results instead of returning it implicitly. A native query that binds its results to an entity must project _id explicitly.

✓

✓

Partially Supported. Upsert operations are supported on unversioned entities through the StatelessSession API. Does not support entities that have a field annotated with @Version. To learn more, see the Upsert Documents section in the Perform CRUD Operations guide.

Unsupported. However, you can use a change stream through the MongoDB Java Driver. To learn more, see the Open Change Streams section in the Java Driver documentation.

Unsupported. We are considering this feature for future release. However, you can setup CSFLE/QE when you configure the MongoDB Java Driver. To learn more, see the CSFLE documentation in the MongoDB Server manual.

Unsupported. However, you can use GridFS through the MongoDB Java Driver. To learn more, see the Large File Storage with GridFS guide in the Java Driver documentation.

Unsupported. However, you can create a time series collection through the MongoDB Java Driver. To learn more, see the Time Series Collections guide in the Java Driver documentation.

Unsupported. We recommended that you convert any standalone instances to a replica set. To learn more, see Convert a Standalone Self-Managed mongod to a Replica Set in the MongoDB Server manual.

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, call the createView() method on your MongoDatabase instance to create a new view.

Partially Supported. The @OneToOne, @OneToMany, @ManyToOne, @ManyToMany, and @ElementCollection annotations are supported. The @SecondaryTable and @JoinFormula annotations are not supported, and cause an error when the SessionFactory starts.

Partially Supported. Autogenerating ObjectIds is supported. However, you can manually set String and int identifiers. You cannot use java.util.UUID identifiers.

The @GeneratedValue annotation supports sequence-style generation, which the Hibernate ORM extension backs with a counter collection named hibernate_sequences.

Does not support the IDENTITY and TABLE strategies, java.util.UUID generation, BigInteger and BigDecimal identifiers, and a non-blank @SequenceGenerator options element.

Partially Supported. Declare a composite key with @EmbeddedId on a standard @Embeddable class or record. The Hibernate ORM extension stores the key as an _id sub-document and never generates its value.

Does not support the @IdClass annotation, multiple @Id attributes, a @Struct aggregate embeddable identifier, a non-scalar key component, and derived identity through @MapsId.

To learn more, see the Composite Primary Keys section in the Create Entities guide.

Partially Supported. Single-table inheritance and mapped superclasses are supported. Does not support the JOINED and TABLE_PER_CLASS strategies. To learn more, see the Map an Entity Inheritance Hierarchy guide.

Unsupported.

Unsupported.

✓

Unsupported. The Hibernate ORM extension rejects the @Table.catalog element and the hibernate.default_catalog property at bootstrap because MongoDB does not support cross-database $lookup operations. Create one SessionFactory instance for each database instead.

✓
Maps to a collection-name prefix within a single MongoDB database.

✓

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, create a capped collection by specifying CreateCollectionOptions.capped(true) as a parameter in your createCollection() call.

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, create a document called clusteredIndex and define your clustered index. Use this clustered index as a part of the document you pass to the MongoDatabase.runCommand() method, which defines the clustered collection.

✓

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, call the nested method MongoCollection.createIndex(Indexes.ascending("field.subfield")). This method uses nested key paths "field.subfield" to create an embedded document index.

Unsupported. However, you can use geospatial indexes through the MongoDB Java Driver. To learn more, see the Geospatial Indexes section of the Indexes guide in the Java Driver documentation.

Unsupported. However, you can use MongoDB Search indexes through the MongoDB Java Driver. To learn more, see the MongoDB Search and Vector Search Indexes section of the Indexes guide in the Java Driver documentation.

Unsupported. However, you can use MongoDB Vector Search indexes through the MongoDB Java Driver. To learn more, see the MongoDB Search and Vector Search Indexes section of the Indexes guide in the Java Driver documentation.

Unsupported. However, you can use multikey indexes through the MongoDB Java Driver. To learn more, see the Multikey Indexes (Indexes on Array Fields) section of the Indexes guide in the Java Driver documentation.

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, call the nested method MongoCollection.createIndex(Indexes.partialFilterExpression()) to create a partial index.

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, create a validator by executing the collMod command through the MongoDatabase.runCommand() method.

✓

Unsupported. However, you can use the MongoDB Java Driver to define a MongoClient instance. Then, specify IndexOptions().sparse(true) as a parameter in your call to the MongoCollection.createIndex() method to create a sparse index.

✓

Unsupported. However, you can drop and recreate the embedded model index manually.

✓
@ElementCollection and CollectionTable are not supported. However, collections of embedded structs are supported through embeddable classes annotated with @Embeddable and @Struct.

Partially Supported. The java.time.Instant, java.time.Duration, java.time.Year, java.time.ZoneId, java.time.ZoneOffset, and java.util.TimeZone types are supported for top-level and nested entities.

✓

Partially Supported. Manually set the ID of an entity before persisting an entity.

✓

✓

✓

✓
Manually assign UUIDs before persisting an entity.

✓

✓

✓

Partially Supported. The java.time.Instant, java.time.Duration, java.time.Year, java.time.ZoneId, java.time.ZoneOffset, and java.util.TimeZone types are supported for top-level and nested entities.

Unsupported.

The Hibernate ORM extension requires you to set the com.mongodb.hibernate.semantics.nulls property, and MQL is the only supported value. Null comparisons follow MongoDB Query Language semantics rather than Hibernate ORM ternary logic. The Hibernate ORM extension throws an exception at startup when the property is not set.

✓

Partially Supported. Supports the +, -, *, /, div operators, and unary - and + in the SELECT and WHERE clauses.

Does not support function calls as operands, including the HQL % operator, which Hibernate ORM rewrites to a mod() function call.

To learn more, see the Use Computed Expressions section in the Specify a Query guide.

✓

✓
Supports a CASE expression that tests one operand for equality and a CASE expression that evaluates a predicate in each WHEN clause. The Hibernate ORM extension translates a single WHEN ... THEN clause to the MongoDB $cond operator and multiple clauses to the $switch operator.

Partially Supported. Supports the extract() and format() functions on a datetime field in a SELECT clause, translating them to MongoDB date operators and the $dateToString operator. Each function supports a specific set of datetime fields and pattern codes. To learn more, see the Use Datetime Functions in Queries guide.

• >, >=, <, <=, =, <>: Supported, including with computed operands. To learn more, see the Use Computed Expressions section in the Specify a Query guide.

• EXISTS: Partially Supported. Supports an EXISTS subquery that filters on elements of a single field's embedded array, translating it to the MongoDB $elemMatch operator. Does not support certain EXISTS subqueries. To learn more, see the EXISTS section in the Specify a Query guide.

• BETWEEN: Supported. Translates to the MongoDB $gte and $lte operators. To learn more, see the BETWEEN section in the Specify a Query guide.

• IS NULL and IS NOT NULL: Supported. Matches explicitly null values and missing fields or the negation of those values, translating to the MongoDB $match operator. To learn more, see the IS NULL and IS NOT NULL sections in the Specify a Query guide.

• IN and NOT IN: Partially Supported. Supports a list of literals or parameters tested against a field path, translating to the MongoDB $in and $nin operators. Does not support a subquery or an array-valued expression as the list. To learn more, see the IN and NOT IN sections in the Specify a Query guide.

• Comparisons to null: Supported. Applies MongoDB Query Language null semantics rather than Hibernate ORM ternary logic, so a comparison to null matches explicitly null values and missing fields. To learn more, see the Compare Field Values to Null section in the Specify a Query guide.

• Row-value predicates: Partially Supported. Supports the =, <>, IN, and NOT IN operators over a parenthesized list of fields, such as where (title, year) = (:t, :y), translating each predicate to per-component MongoDB $eq comparisons. Does not support row-value predicates that use the >, >=, <, or <= operator. To learn more, see the Compare Multiple Fields at Once section in the Specify a Query guide.

• LIKE: Supported. Translates to the MongoDB $regex operator.

• ANY, ALL: Unsupported. 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.

✓

Unsupported. However, the createNativeQuery() method supports evaluation operators. Include the operator in your MongoDB Query Language statement. To learn more about native queries, see the Perform Native Database Queries guide.

Partially Supported. You can group by a column reference or by an expression, and filter the grouped results in a HAVING clause. You can also order by a GROUP BY key that is an expression, as in select b.total + 1 from Item as b group by b.total + 1 order by b.total + 1.

Does not support the distinct keyword within an accumulator, as in count(distinct b.total)

Partially Supported. You can join entities by navigating a mapped association, as in from Movie m join m.comments c, or by naming an entity and supplying an ON clause, as in from Movie m join Comment c on c.date > m.released. Each join translates to a MongoDB $lookup and $unwind stage. To view examples, see the Join Entities Across Collections guide.

• Inner and left outer joins: Supported.

• JOIN FETCH clauses: Supported.

• Chained joins: Supported. You can join across more than two entities.

• Composite key joins: Partially Supported. You can join a @ManyToOne or @OneToOne association whose target entity has an @EmbeddedId composite key. You can also compare whole composite identifiers with = in an ON condition.
  
  Does not support the @JoinColumn annotation on such an association, ordering comparisons between whole identifiers, and @ManyToMany associations that involve a composite key.
  
  To learn more, see the Composite Key Joins section in the Join Entities Across Collections guide.

• ON conditions: Partially Supported. An ON condition supports the same comparison, logical, and predicate operators as a WHERE clause. This includes compound conditions that combine multiple field comparisons with AND or OR, and range and inequality conditions. An ON condition must compare columns. You cannot compare entity references, as in on m = c.movie, or navigate an association within the condition, as in on c.movie.title = 'Blue Jasmine'.

• Right outer, full outer, cross, lateral, and subquery joins: Unsupported. You can use the createNativeQuery() method to run an aggregation operation that queries multiple collections. To learn more about native queries, see the Perform Native Database Queries guide.

✓

Partially Supported. Supports the character_length(), length(), substring(), trim(), upper(), lower(), pad(), lpad(), rpad(), concat(), locate(), and repeat() functions, and the || concatenation operator. Other Hibernate ORM string functions are unsupported.