Notas de versión

Novedades en la versión 5.6

La versión del controlador 5.6 incluye los siguientes cambios, correcciones y características:

• Añade compatibilidad experimental con consultas de prefijo, sufijo y subcadena de cifrado consultable. Para obtener más información sobre QE, consulte encriptación en uso.

  Nota

  Funcionalidad Experimental

  Las consultas de prefijos, sufijos y subcadenas con cifrado consultable (Queryable Encryption) son inestables y su seguridad no está garantizada hasta que estén generalmente disponibles (GA). Utilícelos solo en cargas de trabajo experimentales.

• Agrega un nsType Campo para objetos ChangeStreamDocument. Este campo contiene el tipo de espacio de nombres (COLLECTION, TIMESERIES o VIEW) del evento de cambio.

• Agrega soporte experimental para la expiración de la operación en el lado del cliente (CSOT) para la autenticación OIDC.

  Nota

  Funcionalidad Experimental

  La funcionalidad CSOT es experimental y podría cambiar en futuras versiones de driver.

• Cuando se configura timeoutMS para CSOT, el controlador ignora el valor de la configuración de conexión maxWaitTime.

• Agrega un método appendMetadata() a la clase MongoClient. Puedes utilizar este método para adjuntar metadatos a los metadatos de un cliente existente. El tamaño máximo de metadatos es 512 MB.

• Agrega un constructor público a la clase RewrapManyDataKeyOptions.

• Fusiona las interfaces AsyncReadOperation y AsyncWriteOperation en las interfaces ReadOperation y WriteOperation. Se pueden crear operaciones de lectura y escritura mediante métodos de construcción en la clase Operations.

• Obsoleta la constante MongoNamespace.COMMAND_COLLECTION_NAME.

• Corrige un error que impedía la reautenticación OIDC dentro de una sesión.

• Al serializar un POJO anotado con @BsonDiscriminator, si la readName de la propiedad coincide con la clave de discriminador, el driver serializa el campo solo una vez.

• Después de llamar al método next() o tryNext() en una instancia de CommandCursorResult, el driver limpia la propiedad CommandCursorResult.results para liberar memoria.

• La clase PojoBuilderHelper crea modelos de propiedades que incluyen las propiedades de las clases abstractas e interfaces.

• El controlador publica y registra los siguientes eventos cuando cambia la topología del clúster:

  • ClusterOpeningEvent:Se publica cuando se abre la topología

  • ClusterDescriptionChangedEventSe publica cuando cambia la descripción de la topología

  • ClusterClosedEvent:Se publica cuando se cierra la topología

• El controlador lanza un MongoStalePrimaryException cuando el miembro del conjunto de réplicas principal queda obsoleto por una de las siguientes razones:

  • Se elige o se descubre un nuevo miembro principal.

  • El valor del campo electionId o setVersion en el primario no coincide con los valores de estos campos en los otros miembros del set de réplicas.

  Para obtener más información sobre los sets de réplicas, consulte Replicación en el manual del MongoDB Server.

Novedades en 5.5.1

La versión del parche del controlador 5.5.1 incluye los siguientes cambios:

• Corrige un problema donde la reautenticación OIDC fallaba cuando era activada por una operación ejecutada en una sesión, incluyendo operaciones ejecutadas en una transacción.

Novedades en la versión 5.5

La versión del controlador 5.5 incluye los siguientes cambios, correcciones y características:

• Introduce mejoras de rendimiento que se reflejan en los benchmarks de rendimiento del controlador. Para ver los resultados de las pruebas de referencia de rendimiento, vea la siguiente sección Mejoras de rendimiento.

Novedades en 5.4

La versión del controlador 5.4 incluye los siguientes cambios, correcciones y características:

• Admite operaciones $lookup para CSFLE y QE. Para aprender más, consulte las siguientes referencias en el manual del servidor:

  • Comportamiento de $lookup y $graphLookup para CSFLE

  • Comportamiento de $lookup y $graphLookup para QE

• Introduce un Bill of Materials (BOM) para gestionar las versiones de los artefactos JVM de MongoDB que podrías utilizar en tu aplicación. Para ver instrucciones sobre cómo agregar el BOM a tu aplicación, consulta el paso de agregar el Bill of Materials del driver de Java del tutorial Primeros pasos.

• Actualiza las dependencias del SDK de AWS a 2.30.31 y 1.12.782 para probar el mecanismo de autenticación MONGODB-AWS.

• Agrega una opción de ordenación a las clases ClientUpdateOneOptions y ClientReplaceOneOptions. Este cambio te permite establecer un orden de clasificación para las operaciones de actualización y reemplazo en escrituras masivas del cliente. Para obtener más información, consulta las secciones Ejemplo de actualización y Ejemplo de reemplazo de la guía de operaciones masivas.

• Añade compatibilidad con Kubernetes para la autenticación OIDC. Para obtener más información, consulte la sección sobre Kubernetes de la guía OIDC (Federación de Identidad de Carga de Trabajo).

• Agrega soporte de primera clase para los siguientes operadores del query de MongoDB Search:

  • phrase

  • regex

  • queryString

  • equals

  • moreLikeThis

  • in

  • wildcard

  Para obtener más información, consulte la sección Crear etapas de búsqueda de pipeline de la guía de MongoDB Search.

• Actualiza los cursores para refrescar la configuración timeoutMS cuando llamas a close() sin afectar el tiempo de espera de la operación.

• Le permite utilizar un índice al llamar al método distinct() especificando una opción hint.

Para ver una lista completa de cambios en esta versión, consulte las 5.4 notas de la versión v en GitHub.

Novedades en la versión 5.3

La versión del controlador 5.3 incluye los siguientes cambios, correcciones y características:

• Importante: La próxima versión menor dejará de ser compatible con la versión del servidor MongoDB 4.0 y aumentará la versión mínima compatible a la 4.2. Recomendamos realizar cambios en tu aplicación para adaptarla a los cambios disruptivos. Consulta la sección Notas de la versión en el manual del servidor para obtener más información sobre la actualización.

• Agrega la clase BinaryVector para implementar el Subtipo Binario BSON 9 para el almacenamiento y recuperación de vectores. Esta clase proporciona un almacenamiento más eficaz de los valores en comparación con una lista de instancias de Double. Puedes crear los siguientes tipos de vectores en función del tipo de elementos que contiene tu vector:

  • Int8BinaryVectorVectores de números enteros con signo de 8bits

  • Float32BinaryVector: Vector de n\u00fameros de punto flotante

  • PackedBitBinaryVector: Vector binario cuantizado (En beta y sujeto a cambios antes de estar disponible para el público en general)

  Para obtener más información sobre esta función, consulte Cuantización vectorial en la documentación de Atlas. Para saber cómo usar este tipo con la función de búsqueda vectorial de MongoDB, consulte la guía de búsqueda vectorial de MongoDB.

• Elimina la equidad explícita de la implementación del pool de conexiones. Este cambio podría contribuir a un mejor rendimiento cuando utilices una instancia MongoClient en muchos hilos de aplicación. Sin embargo, este cambio podría causar un aumento de la latencia de cola.

• Agrega una opción de ordenamiento a los métodos updateOne() y replaceOne(). Este cambio también le permite establecer un tipo de ordenación como opción al crear instancias de ReplaceOneModel y UpdateOneModel. Para obtener más información, consulta las guías Actualizar documentos y Operaciones de escritura masiva.

• Añade una API de escritura masiva del cliente que permite realizar operaciones de escritura en varias bases de datos y colecciones a la vez. Para obtener más información sobre esta funcionalidad, consulta la sección Escritura Masiva de Clientes de la guía de Operaciones Masivas.

Novedades en 5.2.1

La versión del parche del controlador 5.2.1 incluye los siguientes cambios:

• Corrige un problema que causaba que las aplicaciones compiladas con Quarkus lanzaran un java.lang.UnsatisfiedLinkError al inicializar libmongocrypt bindings.

• Se solucionó un problema que causaba un error en el paquete mongodb-driver-core al implementarse en un entorno de ejecución OSGi. El atributo de manifiesto Import-Package org.mongodb:mongodb-driver-core ya no requiere los paquetes com.oracle.svm.core.annotate.*.

Novedades en 5.2

La versión del controlador 5.2 incluye los siguientes cambios, correcciones y características:

• Un carácter de barra inclinada (/) entre los nombres de host y las opciones del cliente en un URI de conexión es opcional. El controlador analiza los siguientes ejemplos de URI de conexión de la misma manera:

  // Connection URI with delimiting forward-slash
  String uri = "mongodb://example.com/?w=majority";
  // Connection URI without delimiting forward-slash
  String uri = "mongodb://example.com?w=majority";

• Permite configurar un tiempo de espera para operaciones del lado del cliente (CSOT). Esta funcionalidad permite establecer un solo tiempo de espera en tu instancia de MongoClient que se aplica a todas las operaciones realizadas con ese cliente. Para obtener más información, consulta la guía Limitar el tiempo de ejecución del servidor.

  Si, y sólo si, la funcionalidad CSOT está habilitada, las siguientes opciones de tiempo de espera serán ignoradas por el driver:

  • waitQueueTimeoutMS

  • socketTimeoutMS

  • wTimeoutMS

  • maxTimeMS

  • maxCommitTimeMS

  Importante

  Funcionalidad Experimental

  CSOT es una funcionalidad experimental y aún no está lista para producción. Esta funcionalidad es opcional en la versión actual y las opciones de tiempo de espera existentes siguen siendo funcionales.

• Agrega la clase SearchIndexType, que puedes pasar al construir una instancia de SearchIndexModel. Este cambio te permite especificar el tipo de índice al crear un índice de Atlas búsqueda o búsqueda vectorial. Para obtener más información, consulta la guía de índices en MongoDB Search y Vector Search Indexes.

• Delegar la implementación de los algoritmos que implementan los mecanismos de autenticación SCRAM-SHA-1 y SCRAM-SHA-256 en el proveedor JCA configurado. Este cambio significa que tu aplicación puede usar un proveedor JCA configurado conforme a FIPS para ofrecer un mayor nivel de seguridad.

• Se revisa el control de versiones de la dependencia mongodb-crypt para que coincida con el de los controladores de JVM. Las futuras versiones de mongodb-crypt se publicarán junto con el controlador y compartirán el mismo número de versión. Debe actualizar su mongodb-crypt dependencia a5 20 la versión.. al actualizar su controlador para esta versión. Para obtener más información, consulte la guía de cifrado en uso.

• Mejoras de rendimiento debido a la implementación de criptografía nativa en todas las plataformas compatibles. La siguiente lista describe las acciones necesarias para implementar esta mejora según tu sistema operativo:

  • Windows: actualiza tu versión de mongodb-crypt a la v5.2.0.

  • Mac: actualice su versión de mongodb-crypt a v5.2.0.

  • Linux: Instale libmongocrypt.so directamente en el sistema de archivos, en lugar de usar el archivo incluido en el archivo mongodb-crypt JAR. Puede encontrar instrucciones para instalar libmongocrypt en Linux en el manual del servidor. Si usa un gestor de paquetes para libmongocrypt instalar, Java Native Access (JNA) lo encontrará allí sin necesidad de configuración adicional. Como alternativa, puede especificar la ruta de búsqueda configurando la LD_LIBRARY_PATH variable de entorno con la ruta del archivo del libmongocrypt paquete.

    Recomendamos la instalación directa porque la biblioteca compartida incluida no se vincula con OpenSSL debido a la posibilidad de incompatibilidades binarias de OpenSSL.

    La carga de la librería compartida es manejada por JNA. Se puede consultar las reglas para el orden de búsqueda de carga de librerías en la documentación de la clase NativeLibrary.

• Soluciona un problema que provocaba que los métodos InsertOneResult.getInsertedId() y InsertManyResult.getInsertedIds() devolvieran identificadores de documento incorrectos en algunas situaciones. Este cambio se ha incorporado en las versiones v5.1.4 y v4.11.4 del controlador Java.

• Cuando una operación de clúster fragmentado no es exitosa, el controlador evita seleccionar el mismo servidor mongos para los intentos de reintento de la operación si hay otros servidores mongos disponibles.

• Agrega los metadatos de alcanzabilidad necesarios cuando tu aplicación utiliza GraalVM Native Image. Estos metadatos sustituyen la necesidad de recopilar metadatos de alcance cuando se utilizan las librerías del driver. Para aprender más, consulte Metadatos de alcanzabilidad en la documentación de GraalVM.

  Este cambio no agrega las entradas de recursos libjnidispatch y libmongocrypt, porque agregar entradas para todas las plataformas soportadas (destinos) afecta significativamente el tamaño de los ejecutables nativos construidos usando GraalVM Native Image. Consulta este archivo de muestra resource-config.json en el repositorio de GitHub del controlador para ver cómo especificar estas entradas explícitamente si tu aplicación depende de la librería org.mongodb:mongodb-crypt.

• Permite la búsqueda de vectores exactos al extender la API VectorSearchOptions para introducir los siguientes subtipos de opciones específicas:

  • ExactVectorSearchOptions: Utiliza este tipo de opciones para habilitar la coincidencia precisa, asegurando que los resultados sean los vectores más cercanos a un vector de query determinado.

  • ApproximateVectorSearchOptionsUtiliza este tipo de opción para habilitar búsquedas que podrían no devolver los vectores más cercanos exactos. Puedes enviar un parámetro numCandidates al instanciar este tipo para especificar la cantidad de vecinos más cercanos a considerar.

  Para obtener más información sobre el uso de la función de búsqueda vectorial de MongoDB, consulte Búsqueda vectorial de MongoDB en la guía Generadores de agregados.

Novedades en 5.1.3

La versión del parche del controlador 5.1.3 incluye los siguientes cambios:

• Corrige un problema que podría provocar errores de afirmación al utilizar tipos Cursor.

Novedades en 5.1.2

La versión del parche del controlador 5.1.2 incluye los siguientes cambios:

• Corrige un problema que impide que el driver codifique y decodifique clases concretas que extienden clases base genéricas, en casos en los que se especifica la clase base como el tipo genérico de la instancia MongoCollection.

• Corrige un problema relacionado con la forma en que se validan los nombres de dominio cuando se utiliza la funcionalidad de proxy SOCKS5, lo que permite utilizar nombres de dominio con más de seis caracteres en el dominio de nivel superior.

Novedades en 5.1.1

La versión del parche del controlador 5.1.1 incluye los siguientes cambios:

• Al utilizar el MONGODB-OIDC mecanismo de autenticación, no debe incluir comas en el valor de la authMechanismProperties cadena de conexión. Para obtener más información sobre este comportamiento, consulte la guía de MONGODB-OIDC.

• Optimiza el rendimiento de GridFS al remover la clonación redundante de arreglos de bytes. Los tipos GridFSDownloadStream y GridFSUploadStream utilizan el tipo BsonDocument en lugar de Document.

Novedades en 5.1

Esta sección incluye la siguiente información:

• Desusos en 5.1

• Mejoras en 5.1

• Nuevas funcionalidades en 5.1

Qué hay de nuevo en 5.0

Esta sección incluye la siguiente información:

• Obsolescencias en la 5.0

• Cambios de comportamiento en 5.0

• Nuevas funcionalidades en 5.0

Novedades de la versión 4.11

Esta sección incluye la siguiente información:

• Obsolescencias en 4.11

• Nuevas funcionalidades en 4.11

Novedades en 4.10

Las nuevas características de la versión 4.10 del controlador incluyen:

• Implementación de los métodos Accumulators.percentile() y Accumulators.median() para agregaciones estadísticas.

• Las interfaces en el paquete com.mongodb.client.model.search ahora están marcadas como @Sealed en vez de @Evolving. Las interfaces selladas no deben ser extendidas ni implementadas por los usuarios de la librería.

• Se solucionó un problema por el cual el controlador emitía mensajes de registro duplicados al reintentar operaciones. Ahora, el controlador emite correctamente un mensaje de registro por cada reintento.

• La interfaz org.bson.codecs.Parameterizable está obsoleta. En lugar de implementarla en un tipo Codec personalizado, anule el método CodecProvider.get() en el CodecProvider del códec si este está diseñado para un tipo parametrizado.

• Compatibilidad con resolutores DNS personalizados.

• Compatibilidad con cifrado consultable (QE). Para obtener más información sobre los requisitos para usar la función QE, consulte la tabla de compatibilidad de controladores de cifrado consultable.