Notas de versión

Novedades en 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 Cifrado en uso.

  Nota

  Característica experimental

  Las consultas de prefijo, sufijo y subcadena de cifrado consultable son inestables y su seguridad no está garantizada hasta que estén disponibles para el público general (GA). Úselas solo en cargas de trabajo experimentales.

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

• Agrega compatibilidad experimental con el tiempo de espera de operación del lado del cliente (CSOT) para la autenticación OIDC.

  Nota

  Característica experimental

  La función CSOT es experimental y podría cambiar en futuras versiones de controladores.

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

• Añade un método appendMetadata() a la clase MongoClient. Puedes usar este método para añadir metadatos a los de un cliente existente. El tamaño máximo de metadatos es de 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.

• Deja 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 propiedad readName coincide con la clave discriminadora, el controlador serializa el campo solo una vez.

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

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

• 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

  • ClusterDescriptionChangedEvent:Se 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 miembro principal no coincide con los valores de estos campos en los otros miembros del conjunto de réplicas.

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

Novedades en 5.5.1

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

• Corrige un problema en el que la reautenticación de OIDC fallaba cuando se activaba mediante una operación ejecutada en una sesión, incluidas las operaciones ejecutadas en una transacción.

Novedades en 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:

• Añade BsonConfiguration compatibilidad con a bson-kotlinx para la conversión de mayúsculas y minúsculas durante la serialización. Para obtener más información, consulte la sección "Implementar la estrategia de nomenclatura de mayúsculas y minúsculas" de la guía de serialización.

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

  • Comportamiento de $lookup y $graphLookup para CSFLE

  • Comportamiento de $lookup y $graphLookup para QE

• Presenta una Lista de Materiales (BOM) para administrar las versiones de los artefactos de la JVM de MongoDB que podría usar en su aplicación. Para ver las instrucciones sobre cómo agregar la BOM a su aplicación, consulte el paso "Agregar la Lista de Materiales del Controlador" del tutorial de Descarga e Instalación.

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

• Añade una opción de ClientUpdateOneOptions ordenación a las ClientReplaceOneOptions clases y. Este cambio permite establecer un orden de ordenación para las operaciones de actualización y reemplazo en las escrituras masivas del cliente. Para obtener más información, consulte las secciones "Operación de actualización" y "Operaciones de reemplazo" de la guía "Operaciones de escritura masiva".

• Añade compatibilidad con Kubernetes para la autenticación OIDC. Para obtener más información, consulte la sección MONGODB-OIDC: Kubernetes de la guía "Mecanismos de autenticación empresarial".

• Agrega soporte de primera clase para los siguientes operadores de consulta de búsqueda de MongoDB:

  • phrase

  • regex

  • queryString

  • equals

  • moreLikeThis

  • in

  • wildcard

  Para obtener más información, consulte la sección Búsqueda de MongoDB de la guía de agregación.

• Actualiza los cursores para actualizar la configuración timeoutMS cuando llama 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 5.3

La versión del controlador 5.3 incluye las siguientes nuevas características, mejoras y correcciones:

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

• Añade la clase BinaryVector para implementar el subtipo binario BSON 9 para el almacenamiento y la recuperación de vectores. Esta clase proporciona un almacenamiento de valores más eficaz en comparación con una lista de instancias Double. Puede crear los siguientes tipos de vectores según el tipo de elementos que contenga:

  • Int8BinaryVector: Vector de enteros con signo de 8bits

  • Float32BinaryVector: Vector de números 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 obtener más información sobre este tipo, consulte la documentación de la API BinaryVector.

• Elimina la equidad explícita de la implementación del grupo de conexiones. Este cambio podría contribuir a un mejor rendimiento al usar una instancia MongoClient en varios subprocesos de la aplicación. Sin embargo, este cambio podría causar una mayor latencia de cola.

• Añade una opción de ordenación a los updateOne() replaceOne() métodos y. Este cambio también permite configurar una opción de ordenación al crear ReplaceOneModel UpdateOneModel instancias y. Para obtener más información,consulte las guíasActualizar documentos, Reemplazar documentos y Operaciones de escritura masiva.

• Compatibilidad con el uso de métodos de clase de constructores directamente con propiedades de clase de datos. Para obtener más información, consulte la guía "Usar constructores con clases de datos". Esta funcionalidad es compatible con el paquete de extensiones del controlador Kotlin Sync publicado con esta versión.

• Implementa una API de escritura masiva de cliente que permite realizar operaciones de escritura en múltiples bases de datos y colecciones en la misma llamada. Para obtener más información sobre esta función, consulte la sección "Escritura masiva de cliente" de la guía "Operaciones de escritura masiva".

Novedades en 5.2

La versión del controlador 5.2 incluye las siguientes nuevas características, mejoras y correcciones:

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

  Si, y solo si, la función CSOT está habilitada, el controlador ignora las siguientes opciones de tiempo de espera:

  • waitQueueTimeoutMS

  • socketTimeoutMS

  • wTimeoutMS

  • maxTimeMS

  • maxCommitTimeMS

  Importante

  Característica experimental

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

• Añade la SearchIndexType clase, que se puede pasar al construir una SearchIndexModel instancia. Este cambio permite especificar el tipo de índice al crear un índice de búsqueda Atlas o vectorial. Para obtener más información, consulte la guía de índices de búsqueda y vectorial de MongoDB.

• Delega la implementación de los algoritmos que implementan los mecanismos de autenticación SCRAM-SHA-1 y SCRAM-SHA-256 al proveedor JCA configurado. Este cambio significa que su aplicación puede usar un proveedor JCA configurado compatible con FIPS para proporcionar 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 gracias 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 el sistema operativo:

  • Windows: Actualice su mongodb-crypt versión a5.2.0 v.

  • Mac: Actualice su mongodb-crypt versión a5.2.0 v.

  • 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 bibliotecas compartidas la gestiona JNA. Puede consultar las reglas para el orden de búsqueda de la carga de bibliotecas en la documentación de la clase NativeLibrary.

• Se solucionó un problema que provocaba que los métodos InsertOneResult.getInsertedId() y InsertManyResult.getInsertedIds() devolvieran ID de documento incorrectos en algunas situaciones. Este cambio se ha implementado en los controladores de sincronización de Kotlin v5.1.4 y v4.11.4.

• 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.

• Añade los metadatos de accesibilidad necesarios cuando la aplicación utiliza la imagen nativa de GraalVM. Estos metadatos eliminan la necesidad de recopilarlos al usar las bibliotecas de controladores. Para obtener más información, consulte Metadatos de Accesibilidad en la documentación de GraalVM.

  Este cambio no agrega las libjnidispatch libmongocrypt entradas de recursos y, ya que agregar entradas para todas las plataformas compatibles (destinos) afecta significativamente el tamaño de los ejecutables nativos generados con la imagen nativa de GraalVM. Consulte este archivo resource-config.json de ejemplo en el repositorio de GitHub del controlador para ver cómo especificar estas entradas explícitamente si su aplicación depende de la org.mongodb:mongodb-crypt biblioteca.

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

  • ExactVectorSearchOptions:Utilice este tipo de opciones para habilitar una coincidencia precisa, garantizando que los resultados sean los vectores más cercanos a un vector de consulta 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 el Inicio rápido de búsqueda vectorial de MongoDB y seleccione Kotlin (Sync) desde el menú desplegable de idioma.

• Añade compatibilidad con serializadores de la kotlinx-datetime biblioteca, que permiten asignar tipos de fecha y hora de Kotlin a BSON como los tipos esperados, en lugar de cadenas. Para obtener más información, consulta la sección "Serializar fechas y horas" de la guía de serialización de Kotlin.

• Admite la serialización de valores JsonElement. Para trabajar con el JsonElement tipo, debe agregar la kotlinx-serialization-json biblioteca como dependencia en su aplicación.

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:

• Compatibilidad con la codificación de clases de datos Kotlin con tipos de parámetros genéricos que aceptan valores NULL. Por ejemplo, puede codificar la clase Container en el siguiente código:

  @Serializable
  data class Box<T>(
      val boxed: T
  )
  @Serializable
  data class Container(
      val box: Box<String?>
  )

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.

Novedades en 5.1

Esta sección incluye la siguiente información:

• Desusos en 5.1

• Mejoras en 5.1

• Nuevas funciones en 5.1

Novedades en 5.0

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

• El constructor KotlinSerializerCodecProvider ahora acepta objetos serializersModule y bsonConfiguration:

  KotlinSerializerCodec.create(clazz.kotlin, serializersModule=serializersModule, bsonConfiguration=bsonConfiguration)

  Esto hace que sea más fácil personalizar su configuración.

• Corrige un error de reflexión de Kotlin que provocaba el borrado del tipo de contenedor.