Overview
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.
Funcionalidades de MongoDB
Esta sección indica si la extensión Hibernate ORM es compatible con diversas funcionalidades de MongoDB.
Soporte de tipo de datos
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.
Soporte de query
Funcionalidad de MongoDB | Soporte para GA (Disponibilidad General) |
|---|---|
Guardados masivos | ✓ |
Operaciones de borrar | ✓ |
Query geoespacial | No compatible. Sin embargo, el método |
Operaciones de inserción | ✓ |
MongoDB Search consultas | No compatible. Sin embargo, el método |
Los query de MongoDB Vector Search | No compatible. Sin embargo, el método |
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. |
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 |
Soporte de bases de datos y colecciones
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 | 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 |
Transacciones y concurrencia
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 |
Transacciones | ✓ |
Soporte de mapeo y modelos
Funcionalidad de MongoDB | Soporte para GA (Disponibilidad General) |
|---|---|
Asociaciones | Parcialmente compatible. Se admiten las anotaciones |
Autogeneración de IDs | Parcialmente compatible. Se admite la autogeneración de ObjectIds. Sin embargo, puede establecer manualmente los identificadores |
Llaves primarias compuestas | Parcialmente compatible. Declare una clave compuesta con |
Estrategia de herencia | Parcialmente compatible. Se admiten la herencia de tabla única y las superclases asignadas. No es compatible con las estrategias |
| No admitido. |
Recuperación perezosa/anticipada | No admitido. |
Ordenando | ✓ |
| No compatible. La extensión Hibernate ORM rechaza el elemento |
| ✓ |
Validación | ✓ |
Soporte de índice
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 |
Colecciones con índice clusterizado | No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de |
Índices compuestos | ✓ |
Índices de documentos incrustados | No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de |
Í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 |
Validación de esquema | No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de |
Índices de un solo campo | ✓ |
Sparse Indexes | No compatible. Sin embargo, puede utilizar el driver de MongoDB para Java para definir una instancia de |
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.
Funcionalidades de Hibernate ORM
Esta sección indica si la extensión de Hibernate ORM admite diversas funcionalidades de Hibernate ORM.
Soporte de tipo de datos
Tipo de dato | Soporte para GA (Disponibilidad General) |
|---|---|
Tipos de colecciones (listas, conjuntos, mapas, arreglos) | ✓ |
Entidades integrables, Tipos escalares | Parcialmente compatible. Los tipos |
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 | ✓ |
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 |
Lógica ternaria (Verdadero, Falso o DESCONOCIDO) | No admitido. |
Soporte de query
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 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 |
Consultas HQL y JPQL, funciones de string | Parcialmente compatible. Admite las funciones |
Consultas HQL y JPQL, Expresiones de caso | Parcialmente compatible.
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 |
|
Queries HQL y JPQL, operadores de elementos | ✓ |
Consultas HQL y JPQL, Operadores de evaluación | Parcialmente compatible. Admite el operador de evaluación MongoDB |
Consultas HQL y JPQL, Agrupación | Parcialmente compatible. Admite las cláusulas
|
HQL y JPQL consultas, uniones | Parcialmente compatible. Puede unir entidades navegando por una asociación asignada, como en
|
Consultas HQL y JPQL, Operadores lógicos | ✓ |
Consultas HQL y JPQL, funciones de string | Parcialmente compatible. Admite las funciones |
Soporte de bases de datos y colecciones
Funcionalidad de Hibernate ORM | Soporte para GA (Disponibilidad General) |
|---|---|
Caché de primer nivel | ✓ |
Caché de Segundo Nivel | ✓ |
Soporte para frameworks y librerías
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. |