Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Compatibilidad de características

En esta página, puede encontrar información sobre las funcionalidades compatibles y no compatibles en la extensión Hibernate ORM. La extensión Hibernate ORM sólo admite sets de réplicas de MongoDB. Cuando utilizas una funcionalidad no admitida, la extensión Hibernate ORM lanza un UnsupportedFeatureException.

Puede realizar una solicitud de soporte para una funcionalidad mediante la creación de una idea AHA. Priorizamos las funcionalidades futuras en función de la demanda de los usuarios.

Esta sección indica si la extensión Hibernate ORM es compatible con diversas funcionalidades de MongoDB.

Para ver una lista de todos los tipos BSON admitidos en la extensión Hibernate ORM, consulta la sección Campos BSON de MongoDB en la guía Crear entidades.

Funcionalidad de MongoDB
Soporte para GA (Disponibilidad General)

Guardados masivos

✓

Operaciones de borrar

✓

Query geoespacial

No compatible. Sin embargo, el método createNativeQuery() admite queries geoespaciales. Incluya la etapa de pipeline $geoWithin o $near en su instrucción de MongoDB languaje del query. Para aprender más sobre query nativo, consulte la guía Realizar query nativo de base de datos.

Operaciones de inserción

✓

MongoDB Search consultas

No compatible. Sin embargo, el método createNativeQuery() admite consultas de búsqueda. Incluya la etapa de pipeline $search en su instrucción de languaje del query de MongoDB. Para ver un ejemplo, consulte la sección Ejecutar una query de MongoDB Search en la guía de query nativos de base de datos.

Los query de MongoDB Vector Search

No compatible. Sin embargo, el método createNativeQuery() admite consultas de búsqueda vectorial. Incluya la etapa de pipeline $vectorSearch en su instrucción de languaje del query de MongoDB. Para aprender más sobre las query nativas, consulte la Ejecutar query nativas de base de datos guía.

Consultas nativas con MQL

✓

Proyecciones

Parcialmente compatible. Las expresiones de agregación dentro de las proyecciones de query no son compatibles, y debe incluir todos los campos de entidad en su proyección.
Cuando la etapa terminal $project no especifica _id, la extensión Hibernate ORM excluye _id de los resultados en lugar de devolverlo implícitamente. Una query nativa que vincula sus resultados a una entidad debe Proyecto _id explícitamente.

Operaciones de lectura

✓

Operaciones de actualizar

✓

Operaciones de actualización e inserción

Parcialmente compatible. Las operaciones de inserción se admiten en entidades sin versiones a través de la API StatelessSession. No admite entidades que tienen un campo anotado con @Version. Para obtener más información, consulte la sección inserción de documentos en la guía Realizar operaciones CRUD.

Funcionalidad de MongoDB
Soporte para GA (Disponibilidad General)

Flujos de cambio

No compatible. Sin embargo, puede utilizar un flujo de cambios a través del MongoDB Java driver. Para aprender más, consulta la sección Open Change Streams en la documentación del driver de Java.

Cifrado a nivel de campo del lado del cliente (CSFLE) y Queryable Encryption (QE)

No compatible. Estamos considerando esta funcionalidad para una futura versión. Sin embargo, puede configurar CSFLE/QE cuando configure el driver de MongoDB para Java. Para aprender más, consulta la documentación de CSFLE en el manual del MongoDB Server.

GridFS

No compatible. Sin embargo, puede usar GridFS a través del driver de Java de MongoDB. Para obtener más información, consulta la guía almacenamiento de archivos grandes con GridFS en la documentación del driver de Java.

Datos de Time Series

No compatible. Sin embargo, puede crear una colección de series de tiempo a través del driver de Java de MongoDB. Para obtener más información, consulta la guía Colecciones de Series Temporales en la documentación del driver de Java.

Instancias mongod autónomas

No compatible. Recomendamos que conviertas cualquier instancia autónoma en un set de réplicas. Para obtener más información, consulte Convertir un mongod autónomo autogestionado en un set de réplicas en el manual del servidor de MongoDB.

Vistas

No compatible. Sin embargo, se puede utilizar el controlador Java de MongoDB para definir una instancia MongoClient. Luego, llame al método createView() en su instancia MongoDatabase para crear una nueva vista.

Funcionalidad de MongoDB
Soporte para GA (Disponibilidad General)

Bloqueo

Parcialmente compatible. El bloqueo optimista es compatible con las entidades que tienen un campo anotado con @Version. La extensión Hibernate ORM añade el valor de la versión actual al filtro MQL para cada actualizar y borrar, y lanza un OptimisticLockException cuando la versión ya no coincide. Para aprender más, consulte la guía Evitar actualizaciones conflictivas con bloqueo optimista.

No admite bloqueo pesimista.

Transacciones

✓

Funcionalidad de MongoDB
Soporte para GA (Disponibilidad General)

Asociaciones

Parcialmente compatible. Se admiten las anotaciones @OneToOne, @OneToMany, @ManyToOne, @ManyToMany y @ElementCollection. Las anotaciones @SecondaryTable y @JoinFormula no son compatibles y provocan un error cuando se inicia el SessionFactory.

Autogeneración de IDs

Parcialmente compatible. Se admite la autogeneración de ObjectIds. Sin embargo, puede establecer manualmente los identificadores String y int.

La anotación @GeneratedValue admite la generación de estilo de secuencia, que la extensión Hibernate ORM respalda con una colección de contador denominada hibernate_sequences.

La generación automática de identificadores java.util.UUID se admite a través de la anotación @UuidGenerator o la anotación @GeneratedValue(strategy = UUID).

No es compatible con las estrategias IDENTITY y TABLE, los identificadores BigInteger y BigDecimal, y un elemento @SequenceGenerator options no en blanco.

Llaves primarias compuestas

Parcialmente compatible. Declare una clave compuesta con @EmbeddedId en una clase o registro @Embeddable estándar. La extensión Hibernate ORM almacena la clave como un subdocumento _id y nunca genera su valor.

No es compatible con la anotación @IdClass, varios atributos @Id, un identificador incrustable agregado @Struct, un componente de clave no escalar y la identidad derivada a través de @MapsId.

Para obtener más información, consulte la sección llaves primarias compuestas en la guía Crear entidades.

Estrategia de herencia

Parcialmente compatible. Se admiten la herencia de tabla única y las superclases asignadas. No es compatible con las estrategias JOINED y TABLE_PER_CLASS. Para aprender más, consulte la guía Asignar una jerarquía de herencia de entidades.

@JdbcTypeCode Anotación

No admitido.

Recuperación perezosa/anticipada

No admitido.

Ordenando

✓

@Table.catalog Elemento

No compatible. La extensión Hibernate ORM rechaza el elemento @Table.catalog y la propiedad hibernate.default_catalog en el arranque porque MongoDB no admite operaciones $lookup entre bases de datos. Cree una instancia SessionFactory para cada base de datos en su lugar.

@Table.schema Elemento

✓
Se asigna a un prefijo de nombre de colección dentro de una única base de datos de MongoDB.

Validación

✓

Funcionalidad de MongoDB
Soporte para GA (Disponibilidad General)

Colecciones con tamaño fijo

No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de MongoClient. Luego, cree una colección con tamaño fijo especificando CreateCollectionOptions.capped(true) como parámetro en su llamar a createCollection().

Colecciones con índice clusterizado

No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de MongoClient. A continuación, cree un documento llamado clusteredIndex y defina su índice agrupado. Utilice este índice clusterizado como parte del documento que pasa al método MongoDatabase.runCommand(), que define la colección con índice clusterizado.

Índices compuestos

✓

Índices de documentos incrustados

No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de MongoClient. Luego, llame al método anidado MongoCollection.createIndex(Indexes.ascending("field.subfield")). Este método utiliza rutas de clave anidadas "campo.subcampo" para crear un índice de documento incrustado.

Índices geoespaciales

No compatible. Sin embargo, puede utilizar índices geoespaciales a través del MongoDB Java Driver. Para obtener más información, consulte la sección Índices geoespaciales de la guía de Índices en la documentación del driver de Java.

Índices de búsqueda de MongoDB

No compatible. Sin embargo, puede utilizar el índice de MongoDB Search a través del MongoDB Java driver. Para aprender más información, consulta la sección Índices de MongoDB Search y de búsqueda vectorial de la guía de índices en la documentación del driver de Java.

Índices de MongoDB Vector Search

No compatible. Sin embargo, puede utilizar los índices de búsqueda vectorial de MongoDB a través del driver Java de MongoDB. Para aprender más información, consulta la sección Índices de MongoDB Search y de búsqueda vectorial de la guía de índices en la documentación del driver de Java.

Multikey Indexes

No compatible. Sin embargo, puede utilizar índices multiclave a través del MongoDB Java Driver. Para obtener más información, consulte la sección Índices multiclave (índices en campos de arreglo) de la guía de Índices en la documentación del driver de Java.

Índices parciales

No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de MongoClient. A continuación, llame al método anidado MongoCollection.createIndex(Indexes.partialFilterExpression()) para crear un índice parcial.

Validación de esquema

No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de MongoClient. A continuación, cree un validador ejecutando el comando collMod a través del método MongoDatabase.runCommand().

Índices de un solo campo

✓

Sparse Indexes

No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de MongoClient. Luego, especifique IndexOptions().sparse(true) como parámetro en su llamar al método MongoCollection.createIndex() para crear un índice disperso.

Unique Indexes

✓

Actualizar índices de modelos incrustados después de la creación del modelo

No compatible. Sin embargo, puede descartar y volver a crear el índice de modelo incrustado manualmente.

Para aprender más sobre los índices, consulte la guía Índices para la optimización de query.

Esta sección indica si la extensión de Hibernate ORM admite diversas funcionalidades de Hibernate ORM.

Tipo de dato
Soporte para GA (Disponibilidad General)

Tipos de colecciones (listas, conjuntos, mapas, arreglos)

✓
@ElementCollection y CollectionTable no son compatibles. Sin embargo, las colecciones de estructuras embebidas se admiten a través de clases embebibles anotadas con @Embeddable y @Struct.

Entidades integrables, Tipos escalares

Parcialmente compatible. Los tipos java.time.Instant, java.time.Duration, java.time.Year, java.time.ZoneId, java.time.ZoneOffset y java.util.TimeZone se admiten para entidades de nivel superior y anidadas.

Entidades integradas, binario

✓

Entidades integradas, tipos de identificadores

Parcialmente compatible. Establezca manualmente el ID de una entidad antes de persistir una entidad.

Entidades embebidas, JSON

✓

Entidades embebidas, semántica nula

✓

Entidades de nivel superior, Binario

✓

Entidades de nivel superior, Tipos de identificadores

✓
Asigne UUIDs manualmente antes de persistir una entidad, o autogenérelos utilizando la anotación @UuidGenerator.

Entidades de primer nivel, JSON

✓

Entidades de nivel superior, Semántica Nula

✓

Entidades de nivel superior, Tipos escalares

✓

Entidades de nivel superior, tipologías temporales

Parcialmente compatible. Los tipos java.time.Instant, java.time.Duration, java.time.Year, java.time.ZoneId, java.time.ZoneOffset y java.util.TimeZone se admiten para entidades de nivel superior y anidadas.

Lógica ternaria (Verdadero, Falso o DESCONOCIDO)

No admitido.

La extensión Hibernate ORM requiere que establezca la propiedad com.mongodb.hibernate.semantics.nulls, y MQL es el único valor admitido. Las comparaciones nulas siguen la semántica del MongoDB languaje del query en lugar de la lógica ternaria de Hibernate ORM. La extensión Hibernate ORM lanza una excepción al inicio cuando la propiedad no está configurada.

Funcionalidad de Hibernate ORM
Soporte para GA (Disponibilidad General)

HQL y JPQL Queries, Operadores agregados

✓

Consultas HQL y JPQL, operadores aritméticos

Parcialmente compatible. Admite los +, -, *, /, div operadores, y los unarios - y + en las cláusulas SELECT y WHERE.

No admite llamar a funciones como operandos, incluido el operador HQL %, que Hibernate ORM reescribe a llamar a la función mod().

Para obtener más información, consulte la sección Usar expresiones calculadas en la guía Especificar una query.

HQL y JPQL queries, operadores de arreglos

✓

Consultas HQL y JPQL, Funciones de fecha y hora

Parcialmente compatible. Admite las funciones extract() y format() en un campo de fecha y hora en una cláusula SELECT, traduciéndolas a operadores de fecha de MongoDB y al operador $dateToString. Cada función admite un conjunto específico de campos de fecha y hora y códigos de patrón. Para aprender más información, consulte la guía Usar funciones de fecha y hora en query.

Consultas HQL y JPQL, funciones de string

Parcialmente compatible. Admite las funciones length(), upper(), lower(), concat(), substring(), locate(), replace(), trim(), pad() y repeat(), y el operador || en un campo de string en una cláusula SELECT, y los traduce a operadores de string de MongoDB. No es compatible con las funciones position(), overlay(), left(), right() o collate(). Para obtener más información y ver ejemplos, consulte la guía Usar funciones de string en query.

Consultas HQL y JPQL, Expresiones de caso

Parcialmente compatible.

  • Admite expresiones CASE simples y buscadas en una cláusula SELECT, como operando de una comparación en una cláusula WHERE, y en la cláusula SET de una instrucción de actualizar masiva. Los traduce al operador MongoDB $switch.

  • No admite expresiones CASE en una cláusula ORDER BY, a menos que la misma expresión CASE sea una clave GROUP BY. Adicionalmente, no admite expresiones CASE como la expresión de coincidencia de un predicado LIKE, como la expresión de prueba de un predicado IN o IS NULL, o como un predicado de cláusula WHERE.

Para obtener más información y ver un ejemplo, consulte la sección Expresiones de caso de uso para lógica condicional en la guía Especificar una query.

Consultas HQL y JPQL, Operadores de comparación

  • >, >=, <, <=, =, <>: Compatible, incluso con operandos calculados. Para aprender más, consulte la sección Uso de expresiones calculadas en la guía Especificar una query.

  • EXISTS: Parcialmente compatible. Admite una subconsulta EXISTS que aplica un filtro a elementos de un arreglo incrustado de un solo campo, traduciéndola al operador $elemMatch de MongoDB. No admite determinadas subconsultas EXISTS. Para aprender más, consulta la sección EXISTS en la guía de Especificación de una query.

  • BETWEEN: Compatible. Se traduce a los operadores MongoDB $gte y $lte. Para aprender más, consulte la sección BETWEEN en la guía Especificar una query.

  • IS NULL y IS NOT NULL: Compatible. Coincide con valores explícitamente nulos y campos que faltan o la negación de esos valores, lo que se traduce en el operador $match de MongoDB. Para aprender más, consulte las secciones IS NULL y IS NOT NULL de la guía Especificar una query.

  • IN y NOT IN: Parcialmente compatible. Admite una lista de literales o parámetros probados con una ruta de campo, que se traducen en los operadores $in y $nin de MongoDB. No admite una subconsulta o una expresión de arreglo como la lista. Para aprender más información, consulte las secciones IN y NOT IN en la guía Especificar una query.

  • Comparaciones con null: Admitido. Aplica la semántica nula de MongoDB languaje del query en lugar de la lógica ternaria de Hibernate ORM, por lo que una comparación con null coincide con valores explícitamente nulos y campos faltantes. Para obtener más información, consulte la sección Comparar valores de campo con nulo en la guía Especificar una query.

  • Predicados de valor de fila: Parcialmente compatible. Admite los operadores =, <>, IN y NOT IN sobre una lista de campos entre paréntesis, como where (title, year) = (:t, :y), traduciendo cada predicado a comparaciones de MongoDB $eq por componente. No admite predicados de valor de fila que utilizan el operador >, >=, < o <=. Para aprender más información, consulte la sección Comparar varios campos a la vez en la guía Especificar una query.

  • LIKE: Compatible. Se traduce en el operador $regex de MongoDB.

  • ANY, ALL: No compatible. Puede usar el método createNativeQuery() y pasar operadores de comparación en su instrucción de languaje del query de MongoDB. Para aprender más sobre las query nativas, consulte la Ejecutar query nativas de base de datos guía.

Queries HQL y JPQL, operadores de elementos

✓

Consultas HQL y JPQL, Operadores de evaluación

Parcialmente compatible. Admite el operador de evaluación MongoDB $regex mediante la traducción de los predicados LIKE, NOT LIKE, ILIKE y NOT ILIKE a filtros de expresión regular. Para obtener más información y ver ejemplos, consulte la sección LIKE en la guía Especificar una query.

Consultas HQL y JPQL, Agrupación

Parcialmente compatible. Admite las cláusulas GROUP BY y HAVING, que se traducen en las etapas $group y $match de MongoDB. Una clave de agrupamiento puede ser una referencia de campo o una expresión calculada. Para obtener más información y ver ejemplos, consulte la sección Agrupar resultados en la guía Modificar resultados de query.

  • Claves de referencia de campo: Admitido, incluidos los campos de @Struct incrustables agregados y entidades unidas.

  • Funciones de agregación sobre un incrustable agregado @Struct: No compatible. Se puede aplicar una función de agregación a un campo de un incrustable, como en count(a.intField), pero no al propio incrustable, como en count(a).

  • Claves de expresión calculadas: Admitidas. Una expresión en la cláusula SELECT o HAVING se resuelve en una clave de agrupación solo cuando se escriben las dos de forma idéntica.

  • Columnas sueltas: No compatible. Cada columna de la cláusula SELECT, HAVING o ORDER BY debe ser una clave de agrupación o estar contenida en una de ellas.

  • ORDER BY sobre una clave de agrupación: Admitido, tanto para claves de referencia de campo como para claves de expresión calculada.

  • SELECT DISTINCT: No compatible, con o sin GROUP BY.

  • DISTINCT dentro de una función de agregado: Compatible. Para aprender más y ver ejemplo, consulte la sección Resumir valores distintos en la guía Especificar una query.

HQL y JPQL consultas, uniones

Parcialmente compatible. Puede unir entidades navegando por una asociación asignada, como en from Movie m join m.comments c, o nombrando una entidad y proporcionando una cláusula ON, como en from Movie m join Comment c on c.date > m.released. Cada unión se traduce en una etapa de MongoDB $lookup y $unwind. Para ver ejemplos, consulte la guía Unir entidades entre colecciones.

  • Uniones internas y externas izquierdas: Compatible.

  • JOIN FETCH cláusulas: Admitido.

  • Uniones encadenadas: Admitido. Se puede unir más de dos entidades.

  • Uniones de clave compuesta: Parcialmente compatible. Puede unirse a una asociación @ManyToOne o @OneToOne cuya entidad de destino tiene una clave compuesta @EmbeddedId. También puede comparar identificadores compuestos completos con = en una condición ON.

    No admite la anotación @JoinColumn en una asociación de este tipo, las comparaciones de ordenación entre identificadores completos y las asociaciones @ManyToMany que implican una clave compuesta.

    Para aprender más, consulte la sección Composite Key Joins en la guía Join Entities Across Collections.

  • ON condiciones: Parcialmente compatible. Una condición ON admite los mismos operadores de comparación, lógicos y de predicado que una cláusula WHERE. Esto incluye condiciones compuestas que combinan múltiples comparaciones de campos con AND o OR, y condiciones de rango y desigualdad. Una condición ON debe comparar columnas. No se pueden comparar referencias de entidad, como en on m = c.movie, o navegar por una asociación dentro de la condición, como en on c.movie.title = 'Blue Jasmine'.

  • Uniones externas derechas, uniones externas completas, uniones cruzadas, uniones laterales y uniones de subconsulta: No compatibles. Puede utilizar el método createNativeQuery() para ejecutar una operación de agregación que query varias colecciones. Para obtener más información sobre las querys nativas, consulte la guía Realizar querys nativas de base de datos.

Consultas HQL y JPQL, Operadores lógicos

✓

Consultas HQL y JPQL, funciones de string

Parcialmente compatible. Admite las funciones character_length(), length(), substring(), trim(), upper(), lower(), pad(), lpad(), rpad(), concat(), locate() y repeat(), y el operador de concatenación ||. Otras funciones de string de Hibernate ORM no son compatibles.

Funcionalidad de Hibernate ORM
Soporte para GA (Disponibilidad General)

Caché de primer nivel

✓

Caché de Segundo Nivel

✓

Esta sección indica si la extensión de Hibernate ORM admite diversos frameworks o librerías externas.

Marco o librería
Soporte para GA (Disponibilidad General)

Spring Boot y Spring Data JPA

Parcialmente compatible. La extensión Hibernate ORM proporciona un iniciador de Spring Boot que configura JPA respaldado por MongoDB y repositorios de Spring Data JPA. No ofrecemos garantías de soporte para toda la funcionalidad de Spring Boot o Spring Data. Para aprender más información, consulte la sección Integración de Spring Boot y Spring Data JPA.

Documentación